📗 개요 - PV - K8s

🏳️‍🌈 [궁금한점]

• PV 용도

---

🔗[목차]

• 1️⃣ 개요 / 기능
• 2️⃣ 정의
  • PV 정의
  • accessModes
  • PV가 PVC에서 언바운드(Unbound) 되었을 때 처리 방식
• 3️⃣ 사용 방법
  • POD에서 PV 사용 예시
• 4️⃣ 활용
  • PV 활용법
• 참고
  • hostPath 사용 유의점
  • 참고 문서

1️⃣ 개요 / 기능

Kubernetes에서 PersistentVolume (PV) 는 클러스터 내에서 데이터를 영구적으로 저장할 수 있도록 지원하는 자원이다. 일반적인 Kubernetes Pod는 생성과 삭제가 반복되므로, Pod와는 수명이 다르고 독립적인 저장소가 필요할 때 PV를 사용한다.

개념	설명
PersistentVolume (PV)	클러스터 관리자가 생성하는 실제 스토리지 리소스 (예: NFS, iSCSI, Ceph, AWS EBS, MinIO 등). Pod와는 별도로 존재하며, 사용자 요청에 의해 바인딩됨.
PersistentVolumeClaim (PVC)	사용자가 요청하는 스토리지 리소스. 용량, 접근 모드 등을 정의함.
StorageClass[^1]	PV를 동적으로 생성할 때 사용할 스토리지 종류 및 정책을 정의함. 동적 프로비저닝 시 사용.

2️⃣ 정의

PV 정의

apiVersion: v1
kind: PersistentVolume
metadata:
  name: my-pv
spec:
  capacity:
    storage: 1Gi
  accessModes:
    - ReadWriteOnce
  hostPath:
    path: /mnt/data

accessModes

접근 모드	설명
ReadWriteOnce (RWO)	하나의 노드에서 읽기/쓰기를 허용
ReadOnlyMany (ROX)	여러 노드에서 읽기 전용 허용
ReadWriteMany (RWX)	여러 노드에서 읽기/쓰기 허용

PV가 PVC에서 언바운드(Unbound) 되었을 때 처리 방식

정책	설명
Retain	PV를 삭제하지 않고 수동으로 정리할 수 있도록 유지함
Delete	PVC 삭제 시 PV도 자동 삭제됨 (스토리지 백엔드에 따라 다름)
Recycle	기본적인 삭제/포맷 수행 후 재사용 가능 (더 이상 잘 안 씀)

3️⃣ 사용 방법

POD에서 PV 사용 예시

apiVersion: v1
kind: Pod
metadata:
  name: my-pod
spec:
  containers:
    - name: app
      image: nginx
      volumeMounts:
        - mountPath: "/usr/share/nginx/html"
          name: html-volume
  volumes:
    - name: html-volume
      persistentVolumeClaim:
        claimName: my-pvc

4️⃣ 활용

PV 활용법

• 관리자가 PV를 생성하거나 StorageClass를 통해 자동으로 프로비저닝할 수 있음.
• 사용자는 PVC를 통해 원하는 용량과 접근 방식으로 스토리지를 요청함.
• PVC는 적절한 PV에 바인딩되거나 StorageClass를 사용해 새로운 PV를 생성함.
• Pod는 PVC를 참조해서 볼륨을 마운트함.
• Pod가 삭제되어도 PVC와 PV는 유지되어 데이터가 남음.

참고

hostPath 사용 유의점

단일 노드에서 간단한 테스트를 위해 hostPath를 사용한다. 운영환경에서는 CSI를 사용해야 한다.

hostPath , CSI 비교

항목	hostPath	CSI 기반
목적	실습, 테스트, 단일 노드	운영 환경, HA, 유연한 확장
자동화	없음	있음
다중 노드	어려움	가능
보안	낮음	상대적으로 높음
동적 PV	수동	자동

hostPath 사용 시 유의사항

제한사항	설명
노드 종속성 있음	Pod가 다른 노드로 이동하면 데이터 접근 불가
HA 불가	MinIO distributed처럼 각 노드 간 볼륨 공유가 필요한 경우 제한적
보안 문제	hostPath는 노드 파일 시스템에 직접 접근 → 보안 취약
동적 프로비저닝 불가	미리 PV를 만들어야 함 → 자동화 어려움
복잡한 운영 어려움	백업, 스냅샷, 확장 등 기능 미지원

참고 문서

[^1]: StorageClass는 Kubernetes에서 동적 프로비저닝을 가능하게 해주는 리소스이다.사용자가 PVC(PersistentVolumeClaim)를 만들면, PVC가 참조하는 StorageClass에 따라 알맞은 PV가 자동으로 생성된다. 상세정보 => 스토리지 클래스 개요