Container Service for Kubernetes:hostPath ボリュームの使用

プロセスの概要

Pod がノードにスケジュールされると、そのノード上の kubelet は、コンテナーを起動する前に hostPath マウント操作を実行します。kubelet は、定義された type に基づいて、hostPath フィールドで指定された path を検証して準備します。

• DirectoryOrCreate: ホストに path が存在するかどうかを確認します。存在しない場合は、パーミッション 0755 で空のディレクトリが自動的に作成されます。所有者とグループは kubelet と同一になります。

• Directory: ホストに path が存在し、それがディレクトリであるかどうかを確認します。そうでない場合、Pod の起動は失敗します。

• FileOrCreate: ホストの path が存在するかどうかを確認します。存在しない場合は、パーミッション 0644 で空のファイルが自動的に作成されます。所有者とグループは kubelet と同一になります。

• File: ホストに path が存在し、それがファイルであるかどうかを確認します。そうでない場合、Pod の起動は失敗します。

検証後、kubelet はホストの path をコンテナーにバインドマウントします。コンテナーからマウントポイントへの読み書き操作は、ホストのファイルシステムに直接影響します。

1. pod-hostpath-direct.yaml という名前のファイルを作成します。

   この例では、ノードの /data ディレクトリを Pod の /test ディレクトリにマウントします。

   apiVersion: v1
   kind: Pod
   metadata:
     name: test-pod
   spec:
     containers:
     - image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
       name: test-container
       volumeMounts:
       - mountPath: /test
         name: test-volume
     volumes:
     - name: test-volume
       hostPath:
         # ホストノード上のパスを指定します
         path: /data
         # マウントモードを指定します
         type: DirectoryOrCreate

2. Pod をデプロイします。

   kubectl apply -f pod-hostpath-direct.yaml

3. Pod 内にファイルを作成し、そのファイルがホストノードに存在するかどうかを確認して、マウントを検証します。

   1. Pod にファイルを作成します。

      Pod の /test ディレクトリ (マウントポイント) に test.txt という名前のファイルを作成します。

      kubectl exec test-pod -- sh -c 'echo "This file was created from within the Pod." > /test/test.txt'

   2. Pod が実行されているノードの名前を取得します。

      NODE_NAME=$(kubectl get pod test-pod -o jsonpath='{.spec.nodeName}')
      echo "Pod is running on node: $NODE_NAME"

   3. ノード上のファイルを確認します。

      ノードにログインし、ls /data コマンドを実行して、ホストの /data ディレクトリにファイルがあるかを確認します。

      test.txt ファイルが存在する場合、hostPath ボリュームは正常にマウントされています。

1. pv-pvc-hostpath.yaml という名前のファイルを作成します。

   この例では、ホストの /data ディレクトリを指す PV、このストレージを要求する PVC、およびこの PVC を使用する Pod を作成します。

   # --- PV の定義 ---
   apiVersion: v1
   kind: PersistentVolume
   metadata:
     name: hostpath-pv
     labels:
       type: local
   spec:
     capacity:
       storage: 10Gi
     accessModes:
       - ReadWriteOnce
     hostPath:
       path: "/data"
   ---
   # --- PVC の定義 ---
   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: hostpath-pvc
   spec:
     accessModes:
     - ReadWriteOnce
     resources:
       requests:
         storage: 10Gi
     # セレクターは、この PVC が上記で作成した PV にバインドされるようにします
     selector:
       matchLabels:
         type: local
   ---
   # --- Pod の定義 ---
   apiVersion: v1
   kind: Pod
   metadata:
     name: test-pod-pvc
   spec:
     containers:
       - name: test-container
         image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
         ports:
           - containerPort: 80
         volumeMounts:
           - mountPath: "/usr/share/nginx/html"
             name: storage
     volumes:
       - name: storage
         persistentVolumeClaim:
           # 上記で定義された PVC を参照します
           claimName: hostpath-pvc

2. PV、PVC、および Pod を作成します。

   kubectl apply -f pv-pvc-hostpath.yaml

3. Pod 内にファイルを作成し、そのファイルがノードに存在するかどうかを確認して、マウントを検証します。

   1. Pod にファイルを作成します。

      Pod の /usr/share/nginx/html ディレクトリ (マウントポイント) に test.txt という名前のファイルを作成します。

      kubectl exec test-pod-pvc -- sh -c 'echo "File from PV/PVC Pod." > /usr/share/nginx/html/test.txt'

   2. Pod が実行されているノード名を取得します。

      NODE_NAME=$(kubectl get pod test-pod-pvc -o jsonpath='{.spec.nodeName}')
      echo "Pod is running on node: $NODE_NAME"

   3. ノード上のファイルを確認します。

      ノードにログインし、ls /data コマンドを実行して、ホストの /data ディレクトリにファイルがあるかを確認します。

      test.txt ファイルが存在する場合、PV と PVC を使用してマウントされた hostPath ボリュームは正常に機能しています。

Pod が削除されて再作成された場合、hostPath ボリューム内のデータは残りますか?

それは、新しい Pod がどこにスケジュールされるかによって異なります。

• 同じノードにスケジュールされた場合: はい。新しい Pod はノード上のまったく同じディレクトリをマウントし、以前のすべてのデータにアクセスできます。

• 別のノードにスケジュールされた場合: いいえ。新しい Pod は新しいノードに空のディレクトリをマウントします。元のデータは元のノードに残りますが、新しい Pod からはアクセスできません。