Kubernetes에서 NFS를 활용한 ReadWriteMany 스토리지 구성하기

sungil 25.02.07

2,945 7 2

facebook twitter kakao link

7 2

facebook twitter kakao link

DEVOTEE 요약: Kubernetes 환경에서 여러 파드가 동시에 접근 가능한 공유 스토리지가 필요할 때, 가장 간단하게 NFS를 활용한 ReadWriteMany(RWX) 스토리지를 구성할 수 있다. Ganesha NFS 프로비저너를 사용하여 Helm으로 설치하고, 동적 프로비저닝을 지원하여 쉽게 스토리지를 설정할 수 있다. 이 방법은 여러 파드가 동시에 로그 수집, 공유 파일 시스템, 미디어 처리 등의 작업을 수행할 때 용이하며, 네트워크 성능과 보안 설정도 고려해야 한다.

DEVOTEE 추천 블로그

Kubernetes 환경에서 여러 파드가 동시에 접근할 수 있는 공유 스토리지가 필요한 경우가 있다.

이 글에서는 가장 간단하게 구성할 수 있는 NFS를 활용한 ReadWriteMany 스토리지 구성 방법을 알아본다.

Kubernetes 스토리지의 접근 모드

Kubernetes에서는 스토리지 접근 방식을 다음과 같이 구분한다:

ReadWriteOnce (RWO): 단일 노드에서만 읽기/쓰기 가능
ReadOnlyMany (ROX): 여러 노드에서 읽기만 가능
ReadWriteMany (RWX): 여러 노드에서 읽기/쓰기 모두 가능

Screenshot 2025-02-03 at 11.22.38 AM.png

(저장소별 지원 모드 https://kubernetes.io/docs/concepts/storage/persistent-volumes/)

NFS 서버 구성 방법

Ganesha NFS 프로비저너 사용
Kubernetes SIG에서 개발한 Ganesha NFS를 사용하는 것이 가장 추천되는 방법이다. Helm을 통해 쉽게 설치할 수 있으며, 동적 프로비저닝을 지원한다.

persistence:
  enabled: true
  storageClass: taco-storage
  accessMode: ReadWriteOnce
  size: 500Gi

설치 명령어:

helm install nfs-provisioner nfs-ganesha-server-and-external-provisioner/nfs-server-provisioner -f ganesha.vo.yaml

직접 NFS 서버 파드 구성
StatefulSet을 사용해 NFS 서버를 직접 구성할 수 있다:

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: nfs-server
spec:
  serviceName: "nfs-service"
  replicas: 1
  template:
    spec:
      containers:
        - name: nfs-server
          image: itsthenetwork/nfs-server-alpine:latest

PV와 PVC 구성

정적 프로비저닝

NFS 서버가 준비되면 다음과 같이 PV와 PVC를 구성한다:

apiVersion: v1
kind: PersistentVolume
metadata:
  name: nfs-pv
spec:
  capacity:
    storage: 500Gi
  accessModes:
    - ReadWriteMany
  nfs:
    path: /shared
    server: nfs-service

동적 프로비저닝

Ganesha NFS를 사용하는 경우 PVC만 생성하면 된다:

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: shared-storage
spec:
  storageClassName: "nfs"
  accessModes:
    - ReadWriteMany
  resources:
    requests:
      storage: 100Gi

실제 사용 예시

아래는 앞에서 만든 pvc를 사용하는 3개의 pod를 생성하여 동시에 파일시스템을 활용하는 예시이다.

apiVersion: v1
kind: Pod
metadata:
  name: nfs
spec:
  containers:
    - name: app
      image: busybox
      volumeMounts:
        - name: shared-storage
          mountPath: /mnt/shared
  volumes:
    - name: shared-storage
      persistentVolumeClaim:
        claimName: shared-storage
---
apiVersion: v1
kind: Pod
metadata:
  name: nfs2
... <spec은 동일> ...
---
apiVersion: v1
kind: Pod
metadata:
  name: nfs3
... <spec은 동일> ...

$ kubectl apply -f nfs_pod.yaml -n nfs
pod/nfs created
pod/nfs2 created
pod/nfs3 created

$ kubectl exec -it -n nfs nfs sh
kubectl exec [POD] [COMMAND] is DEPRECATED and will be removed in a future version. Use kubectl exec [POD] -- [COMMAND] instead.
/ # cd /mnt/nfs/
/mnt/nfs # mkdir hi
/mnt/nfs # ls
hi
/mnt/nfs # mkdir hi1
/mnt/nfs # ls
hi   hi1
/mnt/nfs # exit

$ kubectl exec -it -n nfs nfs2 sh
kubectl exec [POD] [COMMAND] is DEPRECATED and will be removed in a future version. Use kubectl exec [POD] -- [COMMAND] instead.
/ # cd /mnt/nfs/
/mnt/nfs # ls
hi   hi1
/mnt/nfs # mkdir hi2
/mnt/nfs # exit

$ kubectl exec -it -n nfs nfs3 sh
kubectl exec [POD] [COMMAND] is DEPRECATED and will be removed in a future version. Use kubectl exec [POD] -- [COMMAND] instead.
/ # ls /mnt/nfs/
hi   hi1  hi2