Kubernetes Storage Overview

Thu, 21 Aug 2025 09:00:00 +0900

Pod에서 볼륨 선언 → 마운트가 기본 패턴
- spec.volumes에서 볼륨 선언 후 spec.containers.volumeMounts 에서 마운트

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


apiVersion: v1
kind: Pod
metadata:
 name: demo-pod
spec:
 containers:
 - name: app
 image: nginx:1.25
 volumeMounts:
 - name: html
 mountPath: /usr/share/nginx/html
 volumes:
 - name: html
 hostPath:
 path: /home/
 type: DirectoryOrCreate

볼륨 유형

타입	사용 용도	비고
emptyDir	Pod 수명=데이터 수명. 임시 공간	Pod 종료 시 데이터 없어짐
hostPath	노드 로컬 경로를 Pod에 마운트	데이터가 특정 워커노드에 종속됨
configMap / secret	변수를 파일로 주입	주로 읽기 전용으로 마운트
nfs	NAS 마운트	멀티 Pod 간 데이터 공유에 사용
CSI 기반 블록 / 파일	AWS EDB, GCE PD 등	대부분 CSI 드라이버로 제공
동적 프로비저닝 가능

예시: emptyDir / configMap / secret

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


# emptyDir
volumes:
 - name: work
 emptyDir: {}

# configMap
volumes:
 - name: app-config
 configMap:
 name: my-config

# secret
volumes:
 - name: app-secret
 secret:
 secretName: db-cred

PV & PVC

PV(PersistentVolume): 클러스터에 영구 스토리지 리소스를 생성
PVC(PersistentVolumeClaim): 생성한 PV에서 자원 할당 요청

접근 모드

ReadWriteOnce(RWO): 한 노드에서 읽기/쓰기
ReadOnlyMany(ROX): 여러 노드에서 읽기 전용
ReadWriteMany(RWX): 여러 노드에서 읽기/쓰기
- ex) NFS, EFS
pv/pvc 예시
- persistentVolumeReclaimPolicy 기본값은 동적 프로비저닝이면 Delete인 경우가 많고, 중요한 데이터면 Retain 고려

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25


# 1) PV: NFS 예시
apiVersion: v1
kind: PersistentVolume
metadata:
 name: pv-nfs
spec:
 capacity:
 storage: 20Gi
 accessModes: [ReadWriteMany]
 persistentVolumeReclaimPolicy: Retain
 nfs:
 path: /export/apps
 server: 10.0.0.10

---
# 2) PVC: 위 PV에 바인딩될 요청
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
 name: pvc-nfs
spec:
 accessModes: [ReadWriteMany]
 resources:
 requests:
 storage: 20Gi

StorageClass

디스크 타입, 복제/백업 정책, 토폴로지 등의 프로비저닝에 필요한 파라미터를 묶어서 제공
사용자는 PVC에서 StorageClassName에만 지정하면 볼륨이 동적 프로비저닝됨
사용을 위해선 NFS Provisioner, EBS Driver와 같은 툴 설치 필요

자체 관리형 Kubernetes에서 NFS를 통한 StorageClass 사용

Thu, 31 Jul 2025 09:00:00 +0900

AWS의 경우 EBS Driver를 통해 pvc를 위한 StorageClass를 사용 가능
- 로컬 Kubernetes에서도 StorageClass를 사용하기 위해 NFS 서버를 구축해서 사용
NFS 서버 구축

1
2
3
4
5
6
7
8
9


dnf install -y nfs-utils

systemctl enable --now nfs-server

mkdir -p /exports/k8s-pv
chown -R nobody:nobody /exports/k8s-pv
chmod 777 /exports/k8s-pv
echo "/exports/k8s-pv *(rw,sync,no_subtree_check,no_root_squash)" | sudo tee -a /etc/exports
exportfs -rav

Helm을 통한 NFS Provisioner 설치

1
2
3
4


helm repo add nfs-subdir-external-provisioner https://kubernetes-sigs.github.io/nfs-subdir-external-provisioner/
helm repo update

helm install nfs-provisioner nfs-subdir-external-provisioner/nfs-subdir-external-provisioner --set nfs.server=172.27.1.9 --set nfs.path=/exports/k8s-pv --set storageClass.name=nfs-sc --set storageClass.defaultClass=true

pvc 생성

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


apiVersion: v1
kind: PersistentVolumeClaim
metadata:
 name: test-pvc
spec:
 accessModes:
 - ReadWriteMany
 resources:
 requests:
 storage: 1Gi
 storageClassName: nfs-sc

pod 생성

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


apiVersion: v1
kind: PersistentVolumeClaim
metadata:
 name: test-pvc
spec:
 accessModes:
 - ReadWriteMany
 resources:
 requests:
 storage: 1Gi
 storageClassName: nfs-sc

Storageclass on Joonlog

Kubernetes Storage Overview

볼륨 유형

PV & PVC

StorageClass

자체 관리형 Kubernetes에서 NFS를 통한 StorageClass 사용