Kubernetes : 動的プロビジョニング (NFS)2025/11/07

外部ストレージを使用している場合、ボリュームの動的プロビジョニング機能を利用することで、クラスター管理者が事前に PV (Persistent Volume) を作成することなく、ユーザーからの PVC (Persistent Volume Claim) 作成要求時に、動的に PV を作成することができます。

当例では以下のように 4 台のノードを使用して Kubernetes クラスターを構成しています。

+----------------------+   +----------------------+
|  [ ctrl.srv.world ]  |   |   [ dlp.srv.world ]  |
|     Manager Node     |   |     Control Plane    |
+-----------+----------+   +-----------+----------+
        eth0|10.0.0.25             eth0|10.0.0.30
            |                          |
------------+--------------------------+-----------
            |                          |
        eth0|10.0.0.51             eth0|10.0.0.52
+-----------+----------+   +-----------+----------+
| [ node01.srv.world ] |   | [ node02.srv.world ] |
|     Worker Node#1    |   |     Worker Node#2    |
+----------------------+   +----------------------+

	例として、NFS サーバー [nfs.srv.world (10.0.0.35)] のストレージ領域を利用するように、NFS プロビジョナーによる動的プロビジョニングの設定をします。
[1]	こちらを参考に NFS サーバーを設定しておきます。当例では [/home/nfsshare] ディレクトリを共有ディレクトリとして設定します。
[2]	Worker ノードは NFS の共有ディレクトリがマウント可能であることが必要です。
[3]	Helm で NFS Client Provisioner をインストールします。

suse@ctrl:~>

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

# nfs.server = (NFS サーバーのホスト名または IP アドレス)
# nfs.path = (NFS 共有のパス)

suse@ctrl:~>

helm install nfs-client -n kube-system --set nfs.server=10.0.0.35 --set nfs.path=/home/nfsshare nfs-subdir-external-provisioner/nfs-subdir-external-provisioner

NAME: nfs-client
LAST DEPLOYED: Fri Nov  7 11:09:13 2025
NAMESPACE: kube-system
STATUS: deployed
REVISION: 1
TEST SUITE: None

suse@ctrl:~>

kubectl get pods -n kube-system

NAME                                                          READY   STATUS    RESTARTS      AGE
coredns-66bc5c9577-lphm9                                      1/1     Running   1 (41m ago)   132m
coredns-66bc5c9577-lxrgm                                      1/1     Running   1 (41m ago)   132m
etcd-dlp.srv.world                                            1/1     Running   1 (41m ago)   132m
kube-apiserver-dlp.srv.world                                  1/1     Running   1 (41m ago)   132m
kube-controller-manager-dlp.srv.world                         1/1     Running   1 (41m ago)   132m
kube-proxy-4lwzf                                              1/1     Running   1 (41m ago)   123m
kube-proxy-r99tj                                              1/1     Running   1 (41m ago)   119m
kube-proxy-rs8vl                                              1/1     Running   1 (41m ago)   132m
kube-scheduler-dlp.srv.world                                  1/1     Running   1 (41m ago)   132m
metrics-server-689cf674df-n4dpp                               1/1     Running   0             12m
nfs-client-nfs-subdir-external-provisioner-59b75b97bd-j2zp9   1/1     Running   0             52s

[4]	Pod からの使用例です。

suse@ctrl:~>

kubectl get pv

No resources found in default namespace.
suse@ctrl:~>

kubectl get pvc

No resources found in default namespace.
suse@ctrl:~>

kubectl get storageclass

NAME         PROVISIONER                                                RECLAIMPOLICY   VOLUMEBINDINGMODE   ALLOWVOLUMEEXPANSION   AGE
nfs-client   cluster.local/nfs-client-nfs-subdir-external-provisioner   Delete          Immediate           true                   85s

# PVC 作成

suse@ctrl:~>

vi my-pvc.yml

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: my-provisioner
spec:
  accessModes:
    - ReadWriteOnce
  # StorageClass の名称を指定
  storageClassName: nfs-client
  resources:
    requests:
      # リクエストするボリュームサイズ
      storage: 5Gi

suse@ctrl:~>

kubectl apply -f my-pvc.yml

persistentvolumeclaim/my-provisioner created

suse@ctrl:~>

kubectl get pvc

NAME             STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS   VOLUMEATTRIBUTESCLASS   AGE
my-provisioner   Bound    pvc-f4f9a28f-2b92-4a59-833f-41de3b047a44   5Gi        RWO            nfs-client     <unset>                 6s

# PV は自動生成される

suse@ctrl:~>

kubectl get pv

NAME                                       CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS   CLAIM                    STORAGECLASS   VOLUMEATTRIBUTESCLASS   REASON   AGE
pvc-f4f9a28f-2b92-4a59-833f-41de3b047a44   5Gi        RWO            Delete           Bound    default/my-provisioner   nfs-client     <unset>                          37s

suse@ctrl:~>

vi my-pod.yml

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-nginx
spec:
  selector:
    matchLabels:
      run: my-nginx
  replicas: 1
  template:
    metadata:
      labels:
        run: my-nginx
    spec:
      containers:
      - name: my-nginx
        image: nginx
        ports:
        - containerPort: 80
        volumeMounts:
        - mountPath: /usr/share/nginx/html
          name: nginx-pvc
      volumes:
        - name: nginx-pvc
          persistentVolumeClaim:
            # 作成した PVC 名
            claimName: my-provisioner

suse@ctrl:~>

kubectl apply -f my-pod.yml

deployment.apps/my-nginx created
suse@ctrl:~>

kubectl get pods

NAME                        READY   STATUS    RESTARTS   AGE
my-nginx-65f4d8d869-w5c74   1/1     Running   0          10s

suse@ctrl:~>

kubectl exec my-nginx-65f4d8d869-w5c74 -- df /usr/share/nginx/html

Filesystem                                                                               1K-blocks  Used Available Use% Mounted on
10.0.0.35:/home/nfsshare/default-my-provisioner-pvc-f4f9a28f-2b92-4a59-833f-41de3b047a44 164028416     0 155623424   0% /usr/share/nginx/html

# index ファイルを作成して動作確認

suse@ctrl:~>

echo "Nginx Index" > index.html

suse@ctrl:~>

kubectl cp index.html my-nginx-65f4d8d869-w5c74:/usr/share/nginx/html/index.html

suse@ctrl:~>

kubectl expose deployment my-nginx --type="NodePort" --port 80

suse@ctrl:~>

kubectl port-forward service/my-nginx --address 127.0.0.1 8082:80 &

suse@ctrl:~>

curl localhost:8082

Handling connection for 8082
Nginx Index

# 削除する場合は PVC を削除すると PV も削除される

suse@ctrl:~>

kubectl delete deployment my-nginx

deployment.apps "my-nginx" deleted
suse@ctrl:~>

kubectl delete pvc my-provisioner

persistentvolumeclaim "my-provisioner" deleted
suse@ctrl:~>

kubectl get pv

No resources found

[5]	StatefulSet を使用すると [volumeClaimTemplates] が指定可能なため、PVC の作成までまとめて記述できます。

suse@ctrl:~>

kubectl get pv

No resources found in default namespace.
suse@ctrl:~>

kubectl get pvc

No resources found in default namespace.
suse@ctrl:~>

kubectl get storageclass

NAME         PROVISIONER                                                RECLAIMPOLICY   VOLUMEBINDINGMODE   ALLOWVOLUMEEXPANSION   AGE
nfs-client   cluster.local/nfs-client-nfs-subdir-external-provisioner   Delete          Immediate           true                   6m26s

suse@ctrl:~>

vi statefulset.yml

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: my-mginx
spec:
  serviceName: my-mginx
  replicas: 1
  selector:
    matchLabels:
      app: my-mginx
  template:
    metadata:
      labels:
        app: my-mginx
    spec:
      containers:
      - name: my-mginx
        image: nginx
        volumeMounts:
        - name: data
          mountPath: /usr/share/nginx/html
  volumeClaimTemplates:
  - metadata:
      name: data
    spec:
      # StorageClass の名称を指定
      storageClassName: nfs-client
      accessModes: [ "ReadWriteOnce" ]
      resources:
        requests:
          storage: 5Gi

suse@ctrl:~>

kubectl apply -f statefulset.yml

statefulset.apps/my-mginx created
suse@ctrl:~>

kubectl get statefulset

NAME       READY   AGE
my-mginx   1/1     8s

suse@ctrl:~>

kubectl get pods

NAME         READY   STATUS    RESTARTS   AGE
my-mginx-0   1/1     Running   0          27s

suse@ctrl:~>

kubectl get pvc

NAME              STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS   VOLUMEATTRIBUTESCLASS   AGE
data-my-mginx-0   Bound    pvc-e46d419c-a1c7-463f-a3f6-9d3fa5ff97f1   5Gi        RWO            nfs-client     <unset>                 42s

suse@ctrl:~>

kubectl get pv

NAME                                       CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS   CLAIM                     STORAGECLASS   VOLUMEATTRIBUTESCLASS   REASON   AGE
pvc-e46d419c-a1c7-463f-a3f6-9d3fa5ff97f1   5Gi        RWO            Delete           Bound    default/data-my-mginx-0   nfs-client     <unset>                          75s