전통적 운영:
  DBA가 PostgreSQL 장애 감지 → 수동으로 failover 명령 실행
  → Replica를 Primary로 승격 → DNS 업데이트 → 애플리케이션 재연결
  (수 분~수십 분 소요, 사람 개입 필요)

Operator 패턴:
  postgres-operator Controller가 Primary 파드 실패 감지 (수 초)
  → 자동으로 Replica 중 하나를 Primary로 승격
  → Service 엔드포인트 업데이트
  → CRD status 업데이트 (새 Primary 정보)
  (수십 초 이내, 자동)

[CR 변경]  kubectl apply  (spec의 numberOfInstances 2→3)
   │
   ① Watch 이벤트 수신        (Informer가 API Server Watch 스트림에서 Modified 수신)
   │    → 객체 키를 WorkQueue에 넣음 (같은 키 중복은 하나로 합쳐짐)
   │
   ② 현재 상태 관측(Observe)   (그 CR + 하위 StatefulSet·Service·Secret을 캐시에서 읽음)
   │
   ③ Desired와 Diff           (spec이 원하는 모습 vs 실제 상태를 비교해 차이 계산)
   │
   ④ 조치(Act)                (차이만큼만 하위 리소스 Create/Update/Delete — 멱등)
   │    → 이미 같으면 아무것도 안 함(no-op)
   │
   ⑤ 상태 보고(Status)        (status.observedGeneration·conditions를 기록)
   │
   ⑥ 반환 → Requeue           (성공: 다음 이벤트·주기 resync까지 / 에러: 지수 백오프 재시도)
   ▼
[수렴]  실제 상태 == desired   (generation == observedGeneration)

# Helm으로 postgres-operator 설치
helm install postgres-operator \
  postgres-operator-charts/postgres-operator \
  --namespace operator-lab \
  --create-namespace

# Operator Pod 실행 확인
kubectl get pods -n operator-lab
# NAME                                 READY   STATUS    RESTARTS
# postgres-operator-5d97b6f4d9-x8p2k   1/1     Running   0

# 설치된 CRD 확인
kubectl get crd | grep acid.zalan.do
# postgresqls.acid.zalan.do          2026-05-16T10:00:00Z
# operatorconfigurations.acid.zalan.do
# postgresteams.acid.zalan.do

# postgres-cluster.yaml
apiVersion: acid.zalan.do/v1
kind: postgresql
metadata:
  name: my-postgres-cluster
  namespace: operator-lab
spec:
  teamId: "platform"              # 팀 식별자 (파드 이름 접두사)
  volume:
    size: 5Gi                     # 데이터 볼륨 크기
  numberOfInstances: 2            # Primary 1개 + Replica 1개
  users:
    app_user:                     # 생성할 DB 유저
      - login
      - superuser
  databases:
    app_db: app_user              # 생성할 DB: 소유자
  postgresql:
    version: "16"
    parameters:
      shared_buffers: "256MB"
      max_connections: "100"
  resources:
    requests:
      cpu: 250m
      memory: 512Mi
    limits:
      cpu: 1000m
      memory: 2Gi

kubectl apply -f postgres-cluster.yaml

# 클러스터 생성 과정 관찰
kubectl get pods -n operator-lab -w
# NAME                           READY   STATUS    RESTARTS
# my-postgres-cluster-0          0/1     Pending   0
# my-postgres-cluster-0          1/1     Running   0   ← Primary
# my-postgres-cluster-1          1/1     Running   0   ← Replica

# 생성된 리소스 확인
kubectl get all -n operator-lab | grep -v "postgres-operator"
# pod/my-postgres-cluster-0    1/1     Running
# pod/my-postgres-cluster-1    1/1     Running
# service/my-postgres-cluster   ClusterIP  (Primary)
# service/my-postgres-cluster-repl  ClusterIP  (Replica)
# statefulset.apps/my-postgres-cluster

# 클러스터 상태 확인
kubectl get postgresql -n operator-lab
# NAME                    TEAM       VERSION   PODS   VOLUME   STATUS    AGE
# my-postgres-cluster     platform   16        2      5Gi      Running   5m

# postgres-operator가 생성한 패스워드 Secret
kubectl get secrets -n operator-lab | grep my-postgres
# app_user.my-postgres-cluster.credentials.postgresql.acid.zalan.do

# 패스워드 추출
APP_PASS=$(kubectl get secret \
  app_user.my-postgres-cluster.credentials.postgresql.acid.zalan.do \
  -n operator-lab \
  -o jsonpath='{.data.password}' | base64 -d)

# psql로 연결 테스트
kubectl run -it --rm psql-client \
  --image=postgres:16-alpine \
  --restart=Never \
  -n operator-lab \
  -- psql -h my-postgres-cluster -U app_user -d app_db \
     -c "SELECT version();"

# redis-operator Helm 저장소 추가
helm repo add redis-operator https://spotahome.github.io/redis-operator
helm repo update

# redis-operator 설치
helm install redis-operator redis-operator/redis-operator \
  --namespace operator-lab

# RedisFailover CRD 생성
kubectl apply -f - << 'EOF'
apiVersion: databases.spotahome.com/v1
kind: RedisFailover
metadata:
  name: my-redis
  namespace: operator-lab
spec:
  sentinel:
    replicas: 3                    # Sentinel 인스턴스 수 (홀수 권장)
    resources:
      requests:
        cpu: 50m
        memory: 32Mi
  redis:
    replicas: 3                    # Redis 인스턴스 (Primary 1 + Replica 2)
    resources:
      requests:
        cpu: 100m
        memory: 128Mi
    storage:
      persistentVolumeClaim:
        spec:
          accessModes:
            - ReadWriteOnce
          resources:
            requests:
              storage: 2Gi
EOF

# Operator가 생성한 파드 확인
kubectl get pods -n operator-lab | grep redis
# rfr-my-redis-0   1/1     Running   (Redis Replica/Primary)
# rfr-my-redis-1   1/1     Running
# rfr-my-redis-2   1/1     Running
# rfs-my-redis-0   1/1     Running   (Sentinel)
# rfs-my-redis-1   1/1     Running
# rfs-my-redis-2   1/1     Running

# RedisFailover 상태 확인
kubectl get redisfailover my-redis -n operator-lab
# NAME       AGE
# my-redis   3m

# redis-operator는 두 개의 Service를 생성
kubectl get svc -n operator-lab | grep redis
# rfs-my-redis   ClusterIP  10.96.x.x  26379/TCP  (Sentinel)
# rfr-my-redis   ClusterIP  10.96.x.x  6379/TCP   (Redis)

# 애플리케이션에서는 Sentinel 주소로 연결 (Primary 자동 감지)
# 예: redis-py에서
# from redis.sentinel import Sentinel
# sentinel = Sentinel([('rfs-my-redis.operator-lab.svc', 26379)])
# master = sentinel.master_for('mymaster')