# 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    ← 파드 재생성 후에도 데이터 유지!

kubectl apply -f pvc.yaml   (storage: 5Gi, accessModes: RWO)
   │
   ① PVC 선언                        (용량 · accessMode · storageClassName)
   │
   ② 매칭 PV 탐색 or 동적 프로비저닝    (조건 맞는 기존 PV / StorageClass가 새 PV 생성)
   │
   ③ 바인딩 (PVC ↔ PV 1:1)           (STATUS: Pending → Bound)
   │
   ④ 파드 스케줄된 노드에 attach       (attach-detach 컨트롤러가 클라우드 API 호출)
   │
   ⑤ 그 노드에서 mount               (kubelet이 파일시스템 마운트 → 컨테이너에 bind)
   ▼
컨테이너가 mountPath에서 읽기·쓰기   (파드가 죽어도 ②의 볼륨은 남아 데이터 유지)