관리자 또는 StorageClass
    │ PV 생성 (물리/클라우드 스토리지 연결)
    ▼
┌──────────────────────────────────┐
│  PersistentVolume (PV)           │
│  - 실제 스토리지 연결 정보        │
│  - 용량, accessMode              │
│  - 클러스터 범위 오브젝트         │
└────────────────┬─────────────────┘
                 │ 바인딩
    ▼
┌──────────────────────────────────┐
│  PersistentVolumeClaim (PVC)     │
│  - 스토리지 요청서                │
│  - "5Gi, ReadWriteOnce 필요"     │
│  - 네임스페이스 범위 오브젝트     │
└────────────────┬─────────────────┘
                 │ 마운트
    ▼
┌──────────────────────────────────┐
│  Pod                             │
│  - PVC 이름만 참조                │
│  - 실제 스토리지 위치 모름        │
└──────────────────────────────────┘

# pv-example.yaml
apiVersion: v1
kind: PersistentVolume
metadata:
  name: my-pv-001
spec:
  capacity:
    storage: 5Gi             # 이 PV가 제공하는 용량
  accessModes:
    - ReadWriteOnce          # 단일 노드 읽기/쓰기
  persistentVolumeReclaimPolicy: Retain   # PVC 삭제 후에도 데이터 보존
  storageClassName: manual   # PVC와 매칭할 StorageClass 이름
  hostPath:                  # 테스트용 — 프로덕션에서는 사용하지 않음
    path: /data/pv-001
    type: DirectoryOrCreate

kubectl apply -f pv-example.yaml

kubectl get pv my-pv-001
# NAME         CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS      STORAGECLASS
# my-pv-001    5Gi        RWO            Retain           Available   manual
#                                                         ↑ PVC 연결 대기 중

# pvc-example.yaml
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: my-pvc
  namespace: storage-lab
spec:
  accessModes:
    - ReadWriteOnce
  storageClassName: manual   # PV의 storageClassName과 일치
  resources:
    requests:
      storage: 3Gi           # 요청 용량 (PV 용량 이하여야 바인딩됨)

kubectl apply -f pvc-example.yaml

kubectl get pvc my-pvc -n storage-lab
# NAME      STATUS   VOLUME       CAPACITY   ACCESS MODES   STORAGECLASS
# my-pvc    Bound    my-pv-001    5Gi        RWO            manual
#           ↑ Bound = PV와 연결됨

kubectl get pv my-pv-001
# STATUS: Bound   ← PVC가 연결되면 PV도 Bound로 변경

# pod-with-pvc.yaml
apiVersion: v1
kind: Pod
metadata:
  name: pvc-test-pod
  namespace: storage-lab
spec:
  volumes:
    - name: my-storage
      persistentVolumeClaim:
        claimName: my-pvc      # PVC 이름 참조
  containers:
    - name: app
      image: busybox
      command: ["sh", "-c", "echo 'hello pv' > /data/test.txt && sleep 3600"]
      volumeMounts:
        - name: my-storage
          mountPath: /data     # 컨테이너 내 마운트 경로

kubectl apply -f pod-with-pvc.yaml

# 파드에서 파일 쓰기
kubectl exec pvc-test-pod -n storage-lab -- cat /data/test.txt
# hello pv

# 파드 삭제 후 재생성해도 데이터 유지 확인
kubectl delete pod pvc-test-pod -n storage-lab
kubectl apply -f pod-with-pvc.yaml
kubectl exec pvc-test-pod -n storage-lab -- cat /data/test.txt
# hello pv   ← 파드 재생성 후에도 데이터 유지!

# 클러스터의 StorageClass 목록
kubectl get storageclass
# NAME                 PROVISIONER                    RECLAIMPOLICY   VOLUMEBINDINGMODE
# standard (default)   k8s.io/minikube-hostpath        Delete          Immediate
# ↑ (default) = storageClassName 생략 시 자동으로 이 클래스 사용

# StorageClass 상세 확인
kubectl describe storageclass standard

# storageclass-example.yaml (참고용 — minikube에서는 이미 있음)
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: fast-ssd
  annotations:
    storageclass.kubernetes.io/is-default-class: "true"   # 기본 StorageClass 지정
provisioner: kubernetes.io/aws-ebs     # AWS EBS 프로비저너
parameters:
  type: gp3                            # EBS 볼륨 타입
  fsType: ext4
reclaimPolicy: Delete                  # PVC 삭제 시 PV도 삭제
volumeBindingMode: WaitForFirstConsumer  # 파드가 스케줄될 노드에 맞춰 프로비저닝

# pvc-dynamic.yaml — StorageClass 지정 시 PV 자동 생성
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: dynamic-pvc
  namespace: storage-lab
spec:
  accessModes:
    - ReadWriteOnce
  storageClassName: standard    # 이 StorageClass가 자동으로 PV 생성
  resources:
    requests:
      storage: 2Gi

kubectl apply -f pvc-dynamic.yaml

# PVC 생성 직후 — 자동으로 PV가 만들어지고 바인딩됨
kubectl get pvc dynamic-pvc -n storage-lab
# NAME           STATUS   VOLUME                                     CAPACITY
# dynamic-pvc    Bound    pvc-a1b2c3d4-xxxx-xxxx-xxxx-xxxxxxxxxxxx   2Gi
#                         ↑ 자동 생성된 PV 이름

kubectl get pv
# NAME                                       CAPACITY   STATUS   CLAIM
# pvc-a1b2c3d4-xxxx-xxxx-xxxx-xxxxxxxxxxxx   2Gi        Bound    storage-lab/dynamic-pvc

# postgres-with-pvc.yaml
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: postgres-data-pvc
  namespace: storage-lab
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 10Gi
  # storageClassName 생략 시 default StorageClass 사용
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: postgres
  namespace: storage-lab
spec:
  replicas: 1          # DB는 보통 StatefulSet 사용하지만 학습용으로 Deployment
  selector:
    matchLabels:
      app: postgres
  template:
    metadata:
      labels:
        app: postgres
    spec:
      volumes:
        - name: postgres-data
          persistentVolumeClaim:
            claimName: postgres-data-pvc
      containers:
        - name: postgres
          image: postgres:15-alpine
          env:
            - name: POSTGRES_PASSWORD
              value: "changeme"
            - name: PGDATA
              value: "/var/lib/postgresql/data/pgdata"
          ports:
            - containerPort: 5432
          volumeMounts:
            - name: postgres-data
              mountPath: /var/lib/postgresql/data

kubectl apply -f postgres-with-pvc.yaml

# PVC 바인딩 확인
kubectl get pvc postgres-data-pvc -n storage-lab

# 파드 실행 확인
kubectl get pods -n storage-lab -l app=postgres

# DB에 접속하여 데이터 입력
kubectl exec -it $(kubectl get pod -n storage-lab -l app=postgres -o name) \
  -n storage-lab -- psql -U postgres -c "CREATE TABLE test (id INT, name TEXT);"
kubectl exec -it $(kubectl get pod -n storage-lab -l app=postgres -o name) \
  -n storage-lab -- psql -U postgres -c "INSERT INTO test VALUES (1, 'hello');"

# 파드 강제 삭제 후 재생성
kubectl delete pod -n storage-lab -l app=postgres
# Deployment가 자동으로 새 파드 생성

# 새 파드에서 데이터 확인
kubectl exec -it $(kubectl get pod -n storage-lab -l app=postgres -o name) \
  -n storage-lab -- psql -U postgres -c "SELECT * FROM test;"
# id | name
# ----+-------
#  1 | hello    ← 파드 재생성 후에도 데이터 유지!