📗 개요 - Redis - K8s

🏳️‍🌈 [궁금한점]

• Redis 최소사양으로 설치하기 (Harbor에서 사용, 로컬에서 테스트)

---

🔗[목차]

• 1️⃣ 준비
  • Redis StorageClass 작성
  • Redis 데이터 디렉토리
  • Redis PV 구성
  • Redis 차트 다운로드
• 2️⃣ 설정
  • Redis 사용자 Values 파일 생성
• 3️⃣ 설치
  • Redis 설치 (Distributed)
  • Redis POD 확인
  • Redis 차트 버전
• 4️⃣ 검증
  • Redis 서비스 포트 확인
  • Redis PV, PVC 확인
  • PING 테스트
  • Redis CLI 접속
  • 오퍼레이션
• 참고
  • 자주 쓰는 명령어

---

1️⃣ 준비

Redis StorageClass 작성

• sc 정의

apiVersion: storage.k8s.io/v1
kind: StorageClass
reclaimPolicy: Delete  
metadata:
  name: dev-redis-local-storage
provisioner: kubernetes.io/no-provisioner
volumeBindingMode: WaitForFirstConsumer

• sc 생성

k apply -f dev-redis-sc.yml

Redis 데이터 디렉토리

• 디렉토리 생성 (slave1)

sudo mkdir /tmp/dev-redis-data1
sudo chown -R 1001:1001 /tmp/dev-redis-data1

ls -ld /tmp/dev-redis-data1

drwxr-xr-x 2 1001 1001 4096 Jun  7 03:27 /tmp/dev-redis-data1

Redis PV 구성

StorageClass 지정하는 것에 유의한다.

• PV 정의

apiVersion: v1
kind: PersistentVolume
metadata:
  name: redis1
  labels:
    type: local
spec:
  storageClassName: dev-redis-local-storage
  persistentVolumeReclaimPolicy: Delete
  capacity:
    storage: 2Gi
  accessModes:
    - ReadWriteOnce
  hostPath:
    path: "/tmp/dev-redis-data1"
  nodeAffinity:
    required:
      nodeSelectorTerms:
      - matchExpressions:
        - {key: kubernetes.io/hostname, operator: In, values: [slave1]}

• pv 생성

k apply -f dev-redis-pv.yaml

persistentvolume/dev-redis-pv1 created

k get pv

NAME             CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS      CLAIM                                 STORAGECLASS               REASON   AGE
dev-redis-pv1    1Gi        RWO            Delete           Available                                         dev-redis-local-storage             23s

Redis 차트 다운로드

helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update

helm pull oci://registry-1.docker.io/bitnamicharts/redis --untar

Pulled: registry-1.docker.io/bitnamicharts/redis:21.1.11
Digest: sha256:a6fa363f7698b02ebec9be1c101a44e4dc5ad68d3e94b78d52e65ceef598d18d

cd redis

2️⃣ 설정

Redis 사용자 Values 파일 생성

cp values.yaml dev-redis-values.yaml

• dev-redis-values.yaml 파일 편집
• 아래 내용 남기고 삭제

architecture: standalone

auth:
  enabled: false

master:
  persistence:
    enabled: true
    storageClass: "dev-redis-local-storage"
    size: 2Gi
  resources:
    requests:
      cpu: 50m
      memory: 64Mi
    limits:
      cpu: 100m
      memory: 128Mi

replica:
  replicaCount: 1
  persistence:
    enabled: true
    storageClass: "dev-redis-local-storage"
    size: 2Gi
  resources:
    requests:
      cpu: 50m
      memory: 64Mi
    limits:
      cpu: 100m
      memory: 128Mi
metrics:
  enabled: false

3️⃣ 설치

Redis 설치 (Distributed)

helm install my-redis . -n my-dev --create-namespace -f dev-redis-values.yaml --set volumePermissions.enabled=true

NAME: my-redis
LAST DEPLOYED: Sat Jun  7 12:38:55 2025
NAMESPACE: my-dev
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
CHART NAME: redis
CHART VERSION: 21.1.11
APP VERSION: 8.0.2

Did you know there are enterprise versions of the Bitnami catalog? For enhanced secure software supply chain features, unlimited pulls from Docker, LTS support, or application customization, see Bitnami Premium or Tanzu Application Catalog. See https://www.arrow.com/globalecs/na/vendors/bitnami for more information.

** Please be patient while the chart is being deployed **

Redis® can be accessed via port 6379 on the following DNS name from within your cluster:

    my-redis-master.my-dev.svc.cluster.local



To connect to your Redis® server:

1. Run a Redis® pod that you can use as a client:

   kubectl run --namespace my-dev redis-client --restart='Never'  --image docker.io/bitnami/redis:8.0.2-debian-12-r3 --command -- sleep infinity

   Use the following command to attach to the pod:

   kubectl exec --tty -i redis-client \
   --namespace my-dev -- bash

2. Connect using the Redis® CLI:
   redis-cli -h my-redis-master

To connect to your database from outside the cluster execute the following commands:

    kubectl port-forward --namespace my-dev svc/my-redis-master 6379:6379 &
    redis-cli -h 127.0.0.1 -p 6379

Redis POD 확인

k get po -n my-dev

NAME                READY   STATUS    RESTARTS       AGE
my-redis-master-0   1/1     Running   4 (110s ago)   2m46s

Redis 차트 버전

helm ls -n my-dev

NAME            NAMESPACE       REVISION        UPDATED                                 STATUS          CHART                   APP VERSION
my-redis        my-dev          1               2025-06-07 12:38:55.8338876 +0900 KST   deployed        redis-21.1.11           8.0.2

4️⃣ 검증

Redis 서비스 포트 확인

k get svc -n my-dev

NAME                TYPE        CLUSTER-IP     EXTERNAL-IP   PORT(S)    AGE
my-redis-headless   ClusterIP   None           <none>        6379/TCP   3m12s
my-redis-master     ClusterIP   10.100.8.241   <none>        6379/TCP   3m12s

Redis PV, PVC 확인

k get pvc,pv -n my-dev

NAME                                                 STATUS   VOLUME   CAPACITY   ACCESS MODES   STORAGECLASS    AGE
persistentvolumeclaim/redis-data-my-redis-master-0   Bound    redis1   2Gi        RWO            local-storage   3m42s

NAME                      CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS   CLAIM                                 STORAGECLASS    REASON   AGE
persistentvolume/redis1   2Gi        RWO            Delete           Bound    my-dev/redis-data-my-redis-master-0   local-storage            31m

PING 테스트

kubectl exec -it my-redis-master-0 -n my-dev -- redis-cli ping

PONG

Redis CLI 접속

kubectl exec -it my-redis-master-0 -n my-dev -- redis-cli

127.0.0.1:6379>

오퍼레이션

# Key 쓰기
SET mykey "hello redis"

# Key 읽기
GET mykey

# Key 삭제
DEL mykey

# 존재 여부 확인
EXISTS mykey

# 모든 키 보기 (주의: 운영 환경에서는 사용 주의)
KEYS *

• 결과

127.0.0.1:6379> SET mykey "hello redis"
OK
127.0.0.1:6379> GET mykey
"hello redis"
127.0.0.1:6379> DEL mykey
(integer) 1
127.0.0.1:6379> EXISTS mykey
(integer) 0
127.0.0.1:6379> KEYS *
(empty array)

참고

자주 쓰는 명령어

# helm 삭제 후 재 생성
helm delete my-redis -n my-dev
helm install my-redis . -n my-dev -f dev-redis-values.yaml --create-namespace --set volumePermissions.enabled=true

# persistentVolumeReclaimPolicy: Retain 일 경우  - Released 상태의 pv Available로 변경 
rm -rf /tmp/dev-redis-data1/*
kubectl patch pv dev-redis-data1 -p '{"spec":{"claimRef": null}}'

# persistentVolumeReclaimPolicy: Retain 일 경우 - PV 생성
k apply -f dev-redis-pv.yaml

# persistentVolumeReclaimPolicy: Retain 일 경우 - pv 전체 삭제
k delete -f dev-redis-pv.yaml

# PVC  삭제
k delete pvc redis-data-my-redis-master-0 -n my-dev