Kubernetes Storage コンポーネントのデプロイ¶

概要¶

nfs-subdir-external-provisioner は、Kubernetes に PV ボリュームを動的に提供します。これは Kubernetes 用のシンプルな NFS 外部プロビジョナーです。NFS 自体は提供せず、既存の NFS サーバーがストレージを提供する必要があります。永続ボリュームディレクトリの命名規則は ${namespace}-${pvcName}-${pvName} です。

Kubernetes nfs-subdir-external-provisioner コンポーネントのデプロイについては、https://github.com/kubernetes-sigs/nfs-subdir-external-provisioner を参照してください。

前提条件¶

NFS サービスがデプロイされていること。未デプロイの場合は、NFS のデプロイを参照してください。
Kubernetes クラスターがデプロイされていること。未デプロイの場合は、Kubernetes のデプロイを参照してください。
（オプション）Helm ツールがデプロイされていること。未デプロイの場合は、Helm のインストールを参照してください。

基本情報と互換性¶

NFS IP	NFS パス	StorageClass 名	説明
192.168.100.105	/nfsdata	df-nfs-storage	デプロイ時は実際の状況に応じて設定を変更してください

名前	バージョン	オフラインデプロイメントのサポート	サポートアーキテクチャ	サポート対象クラスター
nfs-subdir-external-provisioner	4.0.16	はい	amd64/arm64	1.18+

デプロイ手順¶

1. Kubernetes nfs-subdir-external-provisioner のデプロイ¶

注意

Kubernetes のすべてのノードに nfs-utils がインストールされている必要があります。インストールされていない場合は、以下のコマンドを実行してください：

yum install -y nfs-utils

HelmYaml

以下のコマンドを実行してインストールします：

helm install nfs-provisioner nfs-subdir-external-provisioner \
    --repo https://pubrepo.guance.com/chartrepo/dataflux-chart \
    --set nfs.server=192.168.100.105 \
    --set nfs.path=/nfsdata \
    --set storageClass.name=df-nfs-storage \
    -n kube-system

???+ warning "注意"

  `nfs.server` は NFS アドレス、`nfs.path` はパスです。間違えないようにしてください。

以下の YAML のハイライト部分を変更してデプロイします。

???- note "nfs-provisioner.yaml（クリックして展開）"

---
apiVersion: v1
kind: ServiceAccount
metadata:
  name: nfs-client-provisioner
  # replace with namespace where provisioner is deployed
  namespace: kube-system
---
kind: ClusterRole
apiVersion: rbac.authorization.k8s.io/v1
metadata:
  name: nfs-client-provisioner-runner
rules:
  - apiGroups: [""]
    resources: ["nodes"]
    verbs: ["get", "list", "watch"]
  - apiGroups: [""]
    resources: ["persistentvolumes"]
    verbs: ["get", "list", "watch", "create", "delete"]
  - apiGroups: [""]
    resources: ["persistentvolumeclaims"]
    verbs: ["get", "list", "watch", "update"]
  - apiGroups: ["storage.k8s.io"]
    resources: ["storageclasses"]
    verbs: ["get", "list", "watch"]
  - apiGroups: [""]
    resources: ["events"]
    verbs: ["create", "update", "patch"]
---
kind: ClusterRoleBinding
apiVersion: rbac.authorization.k8s.io/v1
metadata:
  name: run-nfs-client-provisioner
subjects:
  - kind: ServiceAccount
    name: nfs-client-provisioner
    # replace with namespace where provisioner is deployed
    namespace: kube-system
roleRef:
  kind: ClusterRole
  name: nfs-client-provisioner-runner
  apiGroup: rbac.authorization.k8s.io
---
kind: Role
apiVersion: rbac.authorization.k8s.io/v1
metadata:
  name: leader-locking-nfs-client-provisioner
  # replace with namespace where provisioner is deployed
  namespace: kube-system
rules:
  - apiGroups: [""]
    resources: ["endpoints"]
    verbs: ["get", "list", "watch", "create", "update", "patch"]
---
kind: RoleBinding
apiVersion: rbac.authorization.k8s.io/v1
metadata:
  name: leader-locking-nfs-client-provisioner
  # replace with namespace where provisioner is deployed
  namespace: kube-system
subjects:
  - kind: ServiceAccount
    name: nfs-client-provisioner
    # replace with namespace where provisioner is deployed
    namespace: kube-system
roleRef:
  kind: Role
  name: leader-locking-nfs-client-provisioner
  apiGroup: rbac.authorization.k8s.io

---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nfs-client-provisioner
  labels:
    app: nfs-client-provisioner
  # replace with namespace where provisioner is deployed
  namespace: kube-system
spec:
  replicas: 1
  strategy:
    type: Recreate
  selector:
    matchLabels:
      app: nfs-client-provisioner
  template:
    metadata:
      labels:
        app: nfs-client-provisioner
    spec:
      serviceAccountName: nfs-client-provisioner
      containers:
        - name: nfs-client-provisioner
          image: dyrnq/nfs-subdir-external-provisioner:v4.0.2
          volumeMounts:
            - name: nfs-client-root
              mountPath: /persistentvolumes
          env:
            - name: PROVISIONER_NAME
              value: k8s-sigs.io/nfs-subdir-external-provisioner
            - name: NFS_SERVER
              value: 192.168.100.105   # 実際の NFS サーバーを入力
            - name: NFS_PATH
              value: /nfsdata   # 実際の共有ディレクトリ
      volumes:
        - name: nfs-client-root
          nfs:
            server: 192.168.100.105 # 実際の NFS サーバーアドレスを入力
            path: /nfsdata  # 実際の共有ディレクトリ
---
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: df-nfs-storage
  annotations:
    storageclass.beta.kubernetes.io/is-default-class: "true"  # この StorageClass をデフォルトとして設定
    storageclass.kubernetes.io/is-default-class: "true"
provisioner: k8s-sigs.io/nfs-subdir-external-provisioner # or choose another name, must match deployment's env PROVISIONER_NAME'
allowVolumeExpansion: true 
reclaimPolicy: Delete
parameters:
  archiveOnDelete: "false"

以下のコマンドを実行してインストールします：

kubectl apply -f nfs-provisioner.yaml

2. デプロイの検証¶

2.1 Pod のステータスを確認¶

$ kubectl get pod -n kube-system | grep  nfs-provisione

nfs-provisioner-nfs-subdir-external-provisioner-79d448b5d7tbp7v   1/1     Running   0          3d5h

2.2 PVC を作成¶

以下のコマンドを実行して PVC を作成します：

$ cat <<EOF | kubectl apply -f -
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
 name: cfs-pvc001
spec:
 accessModes:
   - ReadWriteOnce
 resources:
   requests:
     storage: 1Gi
 storageClassName: df-nfs-storage
EOF

2.3 PVC のステータスを確認¶

$ kubectl get pvc | grep cfs-pvc001

cfs-pvc001       Bound    pvc-a17a0e50-04d2-4ee0-908d-bacd8d53aaa4   1Gi        RWO            df-nfs-storage           3d7h

Bound がデプロイ成功の基準です。

アンインストール方法¶