Kubernetes에서 Redis 6.x 클러스터 구성하기

1. 네임스페이스 생성

apiVersion: v1
kind: Namespace
metadata:
  name: redis-cluster-env

위 설정을 namespace.yaml 파일로 저장하고 다음 명령어로 적용합니다:

kubectl apply -f namespace.yaml

2. 영구 볼륨 클레임 정의

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: redis-storage-claim
  namespace: redis-cluster-env
spec:
  accessModes:
    - ReadWriteMany
  resources:
    requests:
      storage: 2Gi
  storageClassName: "nfs-storage"

3. 설정맵 및 스테이트풀셋 구성

apiVersion: v1
kind: ConfigMap
metadata:
  name: redis-cluster-config
  namespace: redis-cluster-env
data:
  init-cluster.sh: |
    #!/bin/bash
    NODE_CONF="/data/nodes.conf"
    sed -i "s/myself.*$/myself $(hostname -i):6379/" $NODE_CONF
    exec "$@"
  redis-setting.conf: |
    cluster-enabled yes
    cluster-config-file /data/nodes.conf
    cluster-node-timeout 15000
    protected-mode no
    port 6379
    bind 0.0.0.0
    appendonly yes
    dir /data
apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: redis-node
  namespace: redis-cluster-env
spec:
  serviceName: redis-cluster-headless
  replicas: 6
  selector:
    matchLabels:
      app: redis-cluster-node
  template:
    metadata:
      labels:
        app: redis-cluster-node
    spec:
      containers:
      - name: redis-container
        image: redis:6.2.7
        ports:
        - containerPort: 6379
          name: redis-client
        - containerPort: 16379
          name: cluster-bus
        command: ["/config/init-cluster.sh", "redis-server", "/config/redis-setting.conf"]
        volumeMounts:
        - name: redis-config
          mountPath: /config
        - name: redis-data
          mountPath: /data
      volumes:
      - name: redis-config
        configMap:
          name: redis-cluster-config
          defaultMode: 0755
  volumeClaimTemplates:
  - metadata:
      name: redis-data
    spec:
      accessModes: ["ReadWriteMany"]
      resources:
        requests:
          storage: 2Gi
      storageClassName: "nfs-storage"

4. 서비스 정의

apiVersion: v1
kind: Service
metadata:
  name: redis-cluster-service
  namespace: redis-cluster-env
spec:
  clusterIP: None
  ports:
  - port: 6379
    targetPort: 6379
    name: redis-port
  - port: 16379
    targetPort: 16379
    name: cluster-port
  selector:
    app: redis-cluster-node

5. 클러스터 초기화

먼저 Pod IP 주소들을 확인합니다:

kubectl get pods -n redis-cluster-env -l app=redis-cluster-node -o jsonpath='{range.items[*]}{.status.podIP}:6379 {end}'

얻은 IP 주소들을 사용하여 클러스터를 생성합니다:

kubectl exec -it redis-node-0 -n redis-cluster-env -- redis-cli --cluster create \
  10.1.2.10:6379 10.1.3.15:6379 10.1.4.20:6379 \
  10.1.5.25:6379 10.1.6.30:6379 10.1.7.35:6379 \
  --cluster-replicas 1

6. 클러스터 상태 확인

kubectl exec -it redis-node-0 -n redis-cluster-env -- redis-cli cluster nodes
kubectl exec -it redis-node-0 -n redis-cluster-env -- redis-cli cluster info

7. 운영 고려사항

  • 스테이트풀셋의 사양 변경 시 replicas, template, updateStrategy 외의 필드는 수정할 수 없습니다.
  • Pod 삭제 시 동일한 이름으로 새로운 Pod가 생성되지만 IP 주소는 변경됩니다.
  • DNS 기반 연결을 위해 다음 형식의 호스트명을 사용할 수 있습니다: redis-node-{index}.redis-cluster-headless.redis-cluster-env.svc.cluster.local

8. 클라이언트 연결

애플리케이션에서는 다음 주소를 통해 클러스터에 접속합니다:

redis-cluster-service.redis-cluster-env.svc.cluster.local:6379

태그: kubernetes Redis cluster docker nfs

10월 12일 08:10에 게시됨