5.21. CIFS/SMB CSI Driver Operator

1. Web コンソールにログインします。

2. CIFS/SMB CSI Operator をインストールします。

   1. Operators OperatorHub をクリックします。
   2. フィルターボックスに CIFS/SMB CSI と入力して、CIFS/SMB CSI Operator を見つけます。
   3. CIFS/SMB CSI Driver Operator ボタンをクリックします。
   4. CIFS/SMB CSI Driver Operator ページで、Install をクリックします。

   5. Install Operator のページで、以下のことを確認してください。

      • All namespaces on the cluster (default) が選択されている。
      • Installed Namespace が openshift-cluster-csi-drivers に設定されている。

   6. Install をクリックします。

      インストールが終了すると、CIFS/SMB CSI Operator が Web コンソールの Installed Operators に表示されます。

手順

1. Administration CustomResourceDefinitions ClusterCSIDriver をクリックします。
2. Instances タブで Create ClusterCSIDriver をクリックします。

3. 以下の YAML ファイルを使用します。

   apiVersion: operator.openshift.io/v1
   kind: ClusterCSIDriver
   metadata:
       name: smb.csi.k8s.io
   spec:
     managementState: Managed

4. Create をクリックします。

5. 以下の条件が "True" に変わるのを待ちます。

   • SambaDriverControllerServiceControllerAvailable
   • SambaDriverNodeServiceControllerAvailable

1. 以下のコマンドと次のサンプル YAML ファイルを使用して、Samba サーバーにアクセスするためのシークレットを作成します。

   $ oc create -f <file_name>.yaml

   シークレット YAML ファイルの例

   apiVersion: v1
   kind: Secret
   metadata:
     name: smbcreds 1
     namespace: samba-server 2
   stringData:
     username: <username> 3
     password: <password> 4

   1

   Samba サーバーのシークレットの名前。

   2

   Samba サーバーのシークレットの namespace。

   3

   Samba サーバーのシークレットのユーザー名。

   4

   Samba サーバーのシークレットのパスワード

2. 次のサンプル YAML ファイルを使用して次のコマンドを実行して、ストレージクラスを作成します。

   $ oc create -f <sc_file_name>.yaml 1

   1

   ストレージクラス YAML ファイルの名前。

   ストレージクラスのサンプル YAML ファイル

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: <sc_name> 1
   provisioner: smb.csi.k8s.io
   parameters:
     source: //<hostname>/<shares> 2
     csi.storage.k8s.io/provisioner-secret-name: smbcreds 3
     csi.storage.k8s.io/provisioner-secret-namespace: samba-server 4
     csi.storage.k8s.io/node-stage-secret-name: smbcreds 5
     csi.storage.k8s.io/node-stage-secret-namespace: samba-server 6
   reclaimPolicy: Delete
   volumeBindingMode: Immediate
   mountOptions:
     - dir_mode=0777
     - file_mode=0777
     - uid=1001
     - gid=1001

   1

   ストレージクラス名

   2

   Samba サーバーをインストールし、クラスターからアクセスできるようにする必要があります。<`hostname>` は Samba サーバーのホスト名、<shares> はエクスポートされた共有で使用するために設定したパスを表します。

   3 5

   前の手順で設定した Samba サーバーのシークレットの名前。csi.storage.k8s.io/provisioner-secret が指定されている場合は、source の下に PV 名を持つサブディレクトリーが作成されます。

   4 6

   前の手順で設定した Samba サーバーのシークレットの namespace。

3. PVC を作成します。

   1. 次のサンプル YAML ファイルを使用して次のコマンドを実行し、PVC を作成します。

      $ oc create -f <pv_file_name>.yaml 1

      1

      PVC YAML ファイルの名前。

      PVC YAML ファイルの例

      kind: PersistentVolumeClaim
      apiVersion: v1
      metadata:
        name: <pvc_name> 1
      spec:
        accessModes:
          - ReadWriteMany
        resources:
          requests:
            storage: <storage_amount> 2
        storageClassName: <sc_name> 3

      1

      PVC の名前。

      2

      ストレージ要求の量。

      3

      前の手順で作成した CIFS/SMB ストレージクラスの名前。

   2. 次のコマンドを実行して、PVC が作成され、バインドステータスになっていることを確認します。

      $ oc describe pvc <pvc_name> 1

      1

      前の手順で作成した PVC の名前。

      出力例

      Name:          pvc-test
      Namespace:     default
      StorageClass:  samba
      Status:        Bound 1
      ...

      1

      PVC のステータスは Bound です。

1. 以下のコマンドと次のサンプル YAML ファイルを使用して、Samba サーバーにアクセスするためのシークレットを作成します。

   $ oc create -f <file_name>.yaml

   シークレット YAML ファイルの例

   apiVersion: v1
   kind: Secret
   metadata:
     name: smbcreds 1
     namespace: samba-server 2
   stringData:
     username: <username> 3
     password: <password> 4

   1

   Samba サーバーのシークレットの名前。

   2

   Samba サーバーのシークレットの namespace。

   3

   Samba サーバーのシークレットのユーザー名。

   4

   Samba サーバーのシークレットのパスワード

2. 次のサンプル YAML ファイルを使用して次のコマンドを実行し、PV を作成します。

   $ oc create -f <pv_file_name>.yaml 1

   1

   PV YAML ファイルの名前。

   PV YAML ファイルの例

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     annotations:
       pv.kubernetes.io/provisioned-by: smb.csi.k8s.io
     name: <pv_name> 1
   spec:
     capacity:
       storage: 100Gi
     accessModes:
       - ReadWriteMany
     persistentVolumeReclaimPolicy: Retain
     storageClassName: ""
     mountOptions:
       - dir_mode=0777
       - file_mode=0777
     csi:
       driver: smb.csi.k8s.io
       volumeHandle: smb-server.default.svc.cluster.local/share/ 2
       volumeAttributes:
         source: //<hostname>/<shares> 3
       nodeStageSecretRef:
         name: <secret_name_shares> 4
         namespace: <namespace> 5

   1

   PV の名前。

   2

   volumeHandle の形式: {smb-server-address}.{sub-dir-name}.{share-name}。この値がクラスター内のすべての共有に対して一意であることを確認してください。

   3

   Samba サーバーをインストールし、クラスターからアクセスできるようにする必要があります。<hostname> は Samba サーバーのホスト名、<shares> はエクスポートされた共有で使用するために設定したパスを表します。

   4

   共有のシークレットの名前。

   5

   適用可能な namespace。

3. PVC を作成します。

   1. 次のサンプル YAML ファイルを使用して次のコマンドを実行し、PVC を作成します。

      $ oc create -f <pv_file_name>.yaml 1

      1

      PVC YAML ファイルの名前。

      PVC YAML ファイルの例

      kind: PersistentVolumeClaim
      apiVersion: v1
      metadata:
        name: <pvc_name> 1
      spec:
        accessModes:
          - ReadWriteMany
        resources:
          requests:
            storage: <storage_amount> 2
        storageClassName: ""
        volumeName: <pv_name> 3

      1

      PVC の名前。

      2

      ストレージ要求の量。

      3

      最初のステップの PV の名前。

   2. 次のコマンドを実行して、PVC が作成され、バインドステータスになっていることを確認します。

      $ oc describe pvc <pvc_name> 1

      1

      前の手順で作成した PVC の名前。

      出力例

      Name:          pvc-test
      Namespace:     default
      StorageClass:
      Status:        Bound 1
      ...

      1

      PVC のステータスは Bound です。

4. 次のサンプル YAML ファイルを使用して次のコマンドを実行し、Linux 上にデプロイメントを作成します。

   注記

   前の手順で作成した PV と PVC を使用する場合、次のデプロイメントは必須ではありません。これらはどのように使用できるかの例です。

   $ oc create -f <deployment_file_name>.yaml 1

   1

   デプロイメント YAML ファイルの名前。

   デプロイメント YAML ファイルの例

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     labels:
       app: nginx
     name: <deployment_name> 1
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
         name: <deployment_name> 2
       spec:
         nodeSelector:
           "kubernetes.io/os": linux
         containers:
           - name: <deployment_name> 3
             image: quay.io/centos/centos:stream8
             command:
               - "/bin/bash"
               - "-c"
               - set -euo pipefail; while true; do echo $(date) >> <mount_path>/outfile; sleep 1; done 4
             volumeMounts:
               - name: <vol_mount_name> 5
                 mountPath: <mount_path> 6
                 readOnly: false
         volumes:
           - name: <vol_mount_name> 7
             persistentVolumeClaim:
               claimName: <pvc_name> 8
     strategy:
       rollingUpdate:
         maxSurge: 0
         maxUnavailable: 1
       type: RollingUpdate

   1 2 3

   デプロイメントの名前。

   4 6

   ボリュームマウントパス。

   5 7

   ボリュームマウントの名前。

   8

   前述の手順で作成された PVC の名前。

5. コンテナーで df -h コマンドを実行して、設定を確認します。

   $ oc exec -it <pod_name> -- df -h 1

   1

   Pod の名前。

   出力例

   Filesystem            Size  Used Avail Use% Mounted on
   ...
   /dev/sda1              97G   21G   77G  22% /etc/hosts
   //20.43.191.64/share   97G   21G   77G  22% /mnt/smb
   ...

   この例では、Common Internet File System (CIFS) ファイルシステムとしてマウントされた /mnt/smb ディレクトリーがあります。