Hands-on

# 클러스터에 어떤 StorageClass가 있는지, 기본값이 뭔지 확인
kubectl get storageclass
kubectl get sc -o jsonpath='{range .items[*]}{.metadata.name}{" default="}{.metadata.annotations."storageclass.kubernetes.io/is-default-class"}{"\n"}{end}'

# pvc-data.yaml — PVC만 만들면 StorageClass가 알아서 PV를 만들어준다
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: data-pvc
spec:
  accessModes:
    - ReadWriteOnce
  storageClassName: standard   # 클러스터 환경에 맞게 변경
  resources:
    requests:
      storage: 10Gi

kubectl apply -f pvc-data.yaml
kubectl get pvc data-pvc -w   # Pending -> Bound 전환을 지켜본다

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: web
spec:
  serviceName: web
  replicas: 3
  selector:
    matchLabels: { app: web }
  template:
    metadata:
      labels: { app: web }
    spec:
      containers:
        - name: web
          image: nginx:1.27
          volumeMounts:
            - name: data
              mountPath: /usr/share/nginx/html
  volumeClaimTemplates:
    - metadata:
        name: data
      spec:
        accessModes: ["ReadWriteOnce"]
        storageClassName: standard
        resources:
          requests:
            storage: 5Gi

kubectl apply -f statefulset-web.yaml
kubectl get pvc -l app=web
# data-web-0, data-web-1, data-web-2 가 각각 생성되는 것을 확인

kubectl describe pvc data-pvc
# Events 섹션에 "no persistent volumes available for this claim" 또는
# "waiting for a volume to be created, either by external provisioner..." 확인

kubectl get storageclass
# storageClassName으로 지정한 이름이 실제로 존재하는지, provisioner가 정상인지 확인

kubectl get pods -n kube-system -l app=csi-provisioner   # 환경에 따라 네임스페이스/레이블 다름
kubectl logs -n kube-system <csi-controller-pod> -c csi-provisioner --tail=100

kubectl describe pvc data-pvc
# "failed to provision volume ... rpc error: code = ResourceExhausted" 등의 메시지가
# 클라우드 쪽 쿼터/IAM 권한 문제임을 시사

kubectl describe pod <pod-name>
# Events에 "FailedMount", "MountVolume.SetUp failed", "timeout expired waiting for volumes to attach" 등 확인

# 해당 Pod가 스케줄된 노드에서 CSI 노드 플러그인이 살아있는지 확인
kubectl get pods -n kube-system -o wide | grep csi-node
kubectl logs -n kube-system <csi-node-pod-on-that-node> --tail=100

kubectl get events --field-selector reason=FailedAttachVolume

# 네임스페이스 단위 백업
velero backup create app-backup-$(date +%Y%m%d) --include-namespaces=production

# 백업 상태 확인
velero backup describe app-backup-20260617 --details

# 복구 (다른 클러스터나 새 네임스페이스로도 가능)
velero restore create --from-backup app-backup-20260617

# 정기 백업 스케줄 (매일 새벽 2시, 30일 보관)
velero schedule create daily-backup \
  --schedule="0 2 * * *" \
  --include-namespaces=production \
  --ttl=720h0m0s