Local Path 프로비저너

파드가 스케줄된 노드의 로컬 디스크를 그대로 사용하는 경량 스토리지 프로비저너입니다. 별도의 스토리지 클러스터나 raw 디스크 준비 없이 바로 사용할 수 있습니다.

사전 준비 — 설정 변수 확인

플레이북 실행 전에 inventory/qks/group_vars/all/all-k8s.yaml의 값을 확인합니다. 기본값 그대로도 동작하지만, 바꿔야 하는 상황이면 미리 여기서 조정합니다.

StorageClass 이름을 바꾸는 경우 kube_default_storage_class_name도 같이 맞춰야 기본 StorageClass로 지정됩니다(Ceph를 함께 쓰는 이 환경에서는 기본값이 qks-ceph-block으로 유지되고, qks-local은 선택 가능한 추가 옵션으로만 생성됩니다).

플레이북 실행

./install.sh ubuntu plays/qks-local-provisioner.yaml

설치 흐름

1. 차트 위치 결정   공식 OCI 차트(oci://ghcr.io/rancher/local-path-provisioner/charts/...) 참조
2. Helm 차트 배포   local-path-provisioner 차트 설치
3. K8s 리소스 생성  StorageClass(qks-local) 생성
4. 기본 StorageClass 지정 여부 결정

설치 내용

• StorageClass qks-local (VOLUMEBINDINGMODE: WaitForFirstConsumer)
• qks-system 네임스페이스에 qks-local-provisioner Deployment(2개 복제)

설치 확인

드라이버 Pod 상태와 StorageClass 등록 여부를 먼저 확인합니다.

kubectl get pods -n qks-system | grep local-provisioner
kubectl get storageclass qks-local

실제 PVC 생성 + 파드 마운트 테스트

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: test-local-pvc
spec:
  accessModes: ["ReadWriteOnce"]
  storageClassName: qks-local
  resources:
    requests:
      storage: 1Gi
---
apiVersion: v1
kind: Pod
metadata:
  name: test-local-pod
spec:
  containers:
  - name: busybox
    image: busybox
    command: ["sh", "-c", "echo hello-local > /mnt/test.txt && sleep 3600"]
    volumeMounts:
    - {name: data, mountPath: /mnt}
  volumes:
  - name: data
    persistentVolumeClaim: {claimName: test-local-pvc}

kubectl get pvc test-local-pvc      # STATUS: Bound 이어야 함
kubectl get pod test-local-pod      # READY: 1/1, STATUS: Running 이어야 함
kubectl exec test-local-pod -- cat /mnt/test.txt   # hello-local 출력되어야 함

확인 후 정리:

kubectl delete pod test-local-pod
kubectl delete pvc test-local-pvc

PVC가 Bound되고 Pod가 파일을 정상 읽고 쓰면, 프로비저너가 해당 노드의 로컬 디스크에 실제 볼륨 디렉터리를 만들고 Pod에 마운트한 것입니다.

다음 단계