6.20. CIFS/SMB CSI Driver Operator

1. 登录到 web 控制台。

2. 安装 CIFS/SMB CSI Operator：

   1. 点 Operators OperatorHub。
   2. 通过在过滤器框中输入 CIFS/SMB CSI 来找到 CIFS/SMB CSI。
   3. 点 CIFS/SMB CSI Driver Operator 按钮。
   4. 在 CIFS/SMB CSI Driver Operator 页中，点 Install。

   5. 在 Install Operator 页面中，确保：

      • 选择 All namespaces on the cluster (default)。
      • 安装的命名空间 被设置为 openshift-cluster-csi-drivers。

   6. 点 Install。

      安装完成后，Web 控制台的 Installed Operators 部分列出了 CIFS/SMB CSI Operator。

流程

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. 等待以下 Conditions 更改为 "True" 状态：

   • SambaDriverControllerServiceControllerAvailable
   • SambaDriverNodeServiceControllerAvailable

1. 使用以下命令，使用以下示例 YAML 文件创建 Secret 以访问 Samba 服务器：

   $ oc create -f <file_name>.yaml

   Secret YAML 文件示例

   apiVersion: v1
   kind: Secret
   metadata:
     name: smbcreds 

   1

   
     namespace: samba-server 

   2

   
   stringData:
     username: <username> 

   3

   
     password: <password> 

   4

   1

   Samba 服务器的 Secret 名称。

   2

   Samba 服务器的 Secret 的命名空间。

   3

   Samba 服务器 Secret 的用户名。

   4

   Samba 服务器的 Secret 的密码。

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 服务器的 Secret 名称。如果提供了 csi.storage.k8s.io/provisioner-secret，则会使用 PV 名称在 source 下创建一个子目录。

   4 6

   上一步中设置的 Samba 服务器的 Secret 的命名空间。

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 已创建并处于 "Bound" 状态：

      $ oc describe pvc <pvc_name> 

      1

      1

      上一步中创建的 PVC 名称。

      输出示例

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

      1

      
      ...

      1

      PVC 处于 Bound 状态。

1. 使用以下命令，使用以下示例 YAML 文件创建 Secret 以访问 Samba 服务器：

   $ oc create -f <file_name>.yaml

   Secret YAML 文件示例

   apiVersion: v1
   kind: Secret
   metadata:
     name: smbcreds 

   1

   
     namespace: samba-server 

   2

   
   stringData:
     username: <username> 

   3

   
     password: <password> 

   4

   1

   Samba 服务器的 Secret 名称。

   2

   Samba 服务器的 Secret 的命名空间。

   3

   Samba 服务器 Secret 的用户名。

   4

   Samba 服务器的 Secret 的密码。

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

   共享的 Secret 名称。

   5

   适用的命名空间。

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 已创建并处于 "Bound" 状态：

      $ 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
   ...

   在本例中，有 /mnt/smb 目录被挂载为通用 Internet 文件系统 (CIFS) 文件系统。