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