主页
产品
OpenShift Container Platform
4.17
存储
6.20. CIFS/SMB CSI Driver Operator

6.20. CIFS/SMB CSI Driver Operator

OpenShift Container Platform 能够置备持久性卷 (PV)，它带有一个用于通用互联网文件系统(CIFS) dialect/Server Message Block (SMB)协议的 Container Storage Interface (CSI) 驱动程序。

重要

CIFS/SMB CSI Driver Operator 只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议（SLA）支持，且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能，并有机会在开发阶段提供反馈意见。

有关红帽技术预览功能支持范围的更多信息，请参阅技术预览功能支持范围。

在使用 CSI Operator 和驱动程序时，建议先熟悉持久性存储和配置 CSI 卷。

安装 CIFS/SMB CSI Driver Operator 后，OpenShift Container Platform 默认会在 openshift-cluster-csi-drivers 命名空间中为 Operator 和驱动程序安装对应的 pod。这允许 CIFS/SMB CSI 驱动程序创建挂载到 CIFS/SMB 共享的 CSI 置备的持久性卷 (PV)。

安装之后，CIFS/SMB CSI Driver Operator 不会默认创建存储类来创建持久性卷声明 (PVC)。但是，您可以手动为动态置备创建 CIFS/SMB StorageClass。CIFS/SMB CSI Driver Operator 支持动态卷置备，方法是允许按需创建存储卷。这消除了集群管理员预置备存储的需求。
CIFS/SMB CSI 驱动程序 允许您创建并挂载 CIFS/SMB PV。

6.20.1. 关于 CSI
复制链接

在过去，存储厂商一般会把存储驱动作为 Kubernetes 的一个部分提供。随着容器存储接口 (CSI) 的实现，第三方供应商可以使用标准接口来提供存储插件，而无需更改核心 Kubernetes 代码。

CSI Operators 为 OpenShift Container Platform 用户提供了存储选项，如卷快照，它无法通过 in-tree 卷插件实现。

6.20.2. 限制：
复制链接

以下限制适用于通用互联网文件系统(CIFS)/服务器消息块(SMB) Container Storage Interface (CSI) Driver Operator：

不支持 FIPS 模式：
启用联邦信息处理标准(FIPS)模式时，禁用 md4 和 md5 的使用，这会阻止用户使用 ntlm、ntlmv2 或 ntlmssp 身份验证。另外，无法使用签名，因为它使用了 md5。在启用了 FIPS 模式时，使用这些方法的 CIFS 挂载都会失败。
CSI 驱动程序不支持使用 HTTP 代理配置连接到集群 SMB 服务器外。
由于 CIFS/SMB 是 LAN 协议，但可以路由到子网，它不设计为通过 WAN 扩展，且不支持 HTTP 代理设置。

6.20.3. 安装 CIFS/SMB CSI Driver Operator
复制链接

默认情况下，在 OpenShift Container Platform 中不会安装 CIFS/SMB CSI Driver Operator (Red Hat Operator)。使用以下步骤在集群中安装和配置 CIFS/SMB CSI Driver Operator。

先决条件

访问 OpenShift Container Platform Web 控制台。

流程

从 web 控制台安装 CIFS/SMB CSI Driver Operator：

登录到 web 控制台。
安装 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。

6.20.4. 安装 CIFS/SMB CSI 驱动程序
复制链接

安装 CIFS/SMB Container Storage Interface (CSI) Driver Operator 后，安装 CIFS/SMB CSI 驱动程序。

先决条件

访问 OpenShift Container Platform Web 控制台。
已安装 CIFS/SMB CSI Driver Operator。

流程

点 Administration CustomResourceDefinitions ClusterCSIDriver。
在 Instances 选项卡上，单击 Create ClusterCSIDriver。

使用以下 YAML 文件：

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

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

Copy to Clipboard

Toggle word wrap

点 Create。
等待以下 Conditions 更改为 "True" 状态：
- SambaDriverControllerServiceControllerAvailable
- SambaDriverNodeServiceControllerAvailable

6.20.5. 动态置备
复制链接

您可以创建一个存储类来动态置备通用互联网文件系统(CIFS)偏移/服务器消息块(SMB)协议卷。置备卷会在存储类中定义的 source 下创建具有持久性卷 (PV) 名称的子目录。

先决条件

已安装 CIFS/SMB CSI Driver Operator 和驱动程序。
已登陆到正在运行的 OpenShift Container Platform 集群。
已安装 SMB 服务器并了解有关服务器的以下信息：
- 主机名
- 共享名称
- 用户名和密码

流程

设置动态置备：

使用以下命令，使用以下示例 YAML 文件创建 Secret 以访问 Samba 服务器：
```
oc create -f <file_name>.yaml
```
```
$ oc create -f <file_name>.yaml
```
Copy to Clipboard Toggle word wrap
Secret YAML 文件示例
```
apiVersion: v1
kind: Secret
metadata:
  name: smbcreds 
  namespace: samba-server 
stringData:
  username: <username> 
  password: <password> 
```
```
apiVersion: v1
kind: Secret
metadata:
  name: smbcreds 
```
1
```
  namespace: samba-server 
```
2
```
stringData:
  username: <username> 
```
3
```
  password: <password> 
```
4
Copy to Clipboard Toggle word wrap
1
Samba 服务器的 Secret 名称。
2
Samba 服务器的 Secret 的命名空间。
3
Samba 服务器 Secret 的用户名。
4
Samba 服务器的 Secret 的密码。

运行以下命令，使用以下示例 YAML 文件创建存储类：

oc create -f <sc_file_name>.yaml

$ oc create -f <sc_file_name>.yaml

Copy to Clipboard

Toggle word wrap

1: 存储类 YAML 文件的名称。

存储类示例 YAML 文件

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

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: <sc_name>


provisioner: smb.csi.k8s.io
parameters:
  source: //<hostname>/<shares>


  csi.storage.k8s.io/provisioner-secret-name: smbcreds


  csi.storage.k8s.io/provisioner-secret-namespace: samba-server


  csi.storage.k8s.io/node-stage-secret-name: smbcreds


  csi.storage.k8s.io/node-stage-secret-namespace: samba-server


reclaimPolicy: Delete
volumeBindingMode: Immediate
mountOptions:
  - dir_mode=0777
  - file_mode=0777
  - uid=1001
  - gid=1001

Copy to Clipboard

Toggle word wrap

1: 存储类的名称。
2: Samba 服务器必须安装在某个可从集群中访问的位置，其中 <'hostname>' 是 Samba 服务器的主机名，<shares> 是服务器配置为在导出的共享中的路径。
3 5: 上一步中设置的 Samba 服务器的 Secret 名称。如果提供了 csi.storage.k8s.io/provisioner-secret，则会使用 PV 名称在 source 下创建一个子目录。
4 6: 上一步中设置的 Samba 服务器的 Secret 的命名空间。

创建 PVC：

运行以下命令，使用以下示例 YAML 文件创建 PVC：

oc create -f <pv_file_name>.yaml

$ oc create -f <pv_file_name>.yaml

Copy to Clipboard

Toggle word wrap

1: PVC YAML 文件的名称。

PVC YAML 文件示例

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

kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: <pvc_name>


spec:
  accessModes:
    - ReadWriteMany
  resources:
    requests:
      storage: <storage_amount>


  storageClassName: <sc_name>

Copy to Clipboard

Toggle word wrap

1: PVC 的名称。
2: 存储请求量。
3: 您在上一步中创建的 CIFS/SMB 存储类的名称。

运行以下命令，确保 PVC 已创建并处于 "Bound" 状态：
```
oc describe pvc <pvc_name>
```
```
$ oc describe pvc <pvc_name> 
```
1
Copy to Clipboard Toggle word wrap
1
上一步中创建的 PVC 名称。
输出示例
```
Name:          pvc-test
Namespace:     default
StorageClass:  samba
Status:        Bound 
...
```
```
Name:          pvc-test
Namespace:     default
StorageClass:  samba
Status:        Bound 
```
1
```
...
```
Copy to Clipboard Toggle word wrap
1
PVC 处于 Bound 状态。

6.20.6. 静态置备
复制链接

您可以使用静态置备来创建持久性卷 (PV) 和持久性卷声明 (PVC) 来使用现有的服务器消息块协议 (SMB) 共享：

先决条件

访问 OpenShift Container Platform Web 控制台。
已安装 CIFS/SMB CSI Driver Operator 和驱动程序。
已安装 SMB 服务器并了解有关服务器的以下信息：
- 主机名
- 共享名称
- 用户名和密码

流程

设置静态置备：

使用以下命令，使用以下示例 YAML 文件创建 Secret 以访问 Samba 服务器：
```
oc create -f <file_name>.yaml
```
```
$ oc create -f <file_name>.yaml
```
Copy to Clipboard Toggle word wrap
Secret YAML 文件示例
```
apiVersion: v1
kind: Secret
metadata:
  name: smbcreds 
  namespace: samba-server 
stringData:
  username: <username> 
  password: <password> 
```
```
apiVersion: v1
kind: Secret
metadata:
  name: smbcreds 
```
1
```
  namespace: samba-server 
```
2
```
stringData:
  username: <username> 
```
3
```
  password: <password> 
```
4
Copy to Clipboard Toggle word wrap
1
Samba 服务器的 Secret 名称。
2
Samba 服务器的 Secret 的命名空间。
3
Samba 服务器 Secret 的用户名。
4
Samba 服务器的 Secret 的密码。

运行以下命令，使用以下示例 YAML 文件创建 PV：

oc create -f <pv_file_name>.yaml

$ oc create -f <pv_file_name>.yaml

Copy to Clipboard

Toggle word wrap

1: PV YAML 文件的名称。

PV YAML 文件示例

apiVersion: v1
kind: PersistentVolume
metadata:
  annotations:
    pv.kubernetes.io/provisioned-by: smb.csi.k8s.io
  name: <pv_name> 
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#
    volumeAttributes:
      source: //<hostname>/<shares> 
    nodeStageSecretRef:
      name: <secret_name_shares> 
      namespace: <namespace>

apiVersion: v1
kind: PersistentVolume
metadata:
  annotations:
    pv.kubernetes.io/provisioned-by: smb.csi.k8s.io
  name: <pv_name>


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#


    volumeAttributes:
      source: //<hostname>/<shares>


    nodeStageSecretRef:
      name: <secret_name_shares>


      namespace: <namespace>

Copy to Clipboard

Toggle word wrap

1: PV 的名称。
2: volumeHandle 格式：{smb-server-address}#{sub-dir-name}#{share-name}。确保这个值对于集群中的每个共享都是唯一的。
3: Samba 服务器必须安装在某个可从集群中访问的位置，其中 <hostname> 是 Samba 服务器的主机名，<shares> 是服务器配置为在导出的共享中的路径。
4: 共享的 Secret 名称。
5: 适用的命名空间。

创建 PVC：

运行以下命令，使用以下示例 YAML 文件创建 PVC：

oc create -f <pv_file_name>.yaml

$ oc create -f <pv_file_name>.yaml

Copy to Clipboard

Toggle word wrap

1: PVC YAML 文件的名称。

PVC YAML 文件示例

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

kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: <pvc_name>


spec:
  accessModes:
    - ReadWriteMany
  resources:
    requests:
      storage: <storage_amount>


  storageClassName: ""
  volumeName: <pv_name>

Copy to Clipboard

Toggle word wrap

1: PVC 的名称。
2: 存储请求量。
3: 第一步中的 PV 名称。

运行以下命令，确保 PVC 已创建并处于 "Bound" 状态：
```
oc describe pvc <pvc_name>
```
```
$ oc describe pvc <pvc_name> 
```
1
Copy to Clipboard Toggle word wrap
1
上一步中创建的 PVC 名称。
输出示例
```
Name:          pvc-test
Namespace:     default
StorageClass:
Status:        Bound 
...
```
```
Name:          pvc-test
Namespace:     default
StorageClass:
Status:        Bound 
```
1
```
...
```
Copy to Clipboard Toggle word wrap
1
PVC 处于 Bound 状态。

运行以下命令，使用以下示例 YAML 文件在 Linux 上创建部署：

注意

以下部署不是使用在前面的步骤中创建的 PV 和 PVC 所必需的。以下是如何使用它们的示例。

oc create -f <deployment_file_name>.yaml

$ oc create -f <deployment_file_name>.yaml

Copy to Clipboard

Toggle word wrap

1: 部署 YAML 文件的名称。

部署 YAML 文件示例

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

apiVersion: apps/v1
kind: Deployment
metadata:
  labels:
    app: nginx
  name: <deployment_name>


spec:
  replicas: 1
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
      name: <deployment_name>


    spec:
      nodeSelector:
        "kubernetes.io/os": linux
      containers:
        - name: <deployment_name>


          image: quay.io/centos/centos:stream8
          command:
            - "/bin/bash"
            - "-c"
            - set -euo pipefail; while true; do echo $(date) >> <mount_path>/outfile; sleep 1; done


          volumeMounts:
            - name: <vol_mount_name>


              mountPath: <mount_path>


              readOnly: false
      volumes:
        - name: <vol_mount_name>


          persistentVolumeClaim:
            claimName: <pvc_name>


  strategy:
    rollingUpdate:
      maxSurge: 0
      maxUnavailable: 1
    type: RollingUpdate

Copy to Clipboard

Toggle word wrap

1 2 3: 部署的名称。
4 6: 卷挂载路径。
5 7: 卷挂载的名称。
8: 上一步中创建的 PVC 名称。

在容器中运行 df -h 命令检查设置：

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

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

Copy to Clipboard

Toggle word wrap

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

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

Copy to Clipboard

Toggle word wrap

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

返回顶部

6.20. CIFS/SMB CSI Driver Operator

6.20.1. 关于 CSI
复制链接

6.20.2. 限制：
复制链接

6.20.3. 安装 CIFS/SMB CSI Driver Operator
复制链接

6.20.4. 安装 CIFS/SMB CSI 驱动程序
复制链接

6.20.5. 动态置备
复制链接

6.20.6. 静态置备
复制链接

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

6.20. CIFS/SMB CSI Driver Operator

6.20.1. 关于 CSI复制链接链接已复制到粘贴板!

6.20.2. 限制：复制链接链接已复制到粘贴板!

6.20.3. 安装 CIFS/SMB CSI Driver Operator复制链接链接已复制到粘贴板!

6.20.4. 安装 CIFS/SMB CSI 驱动程序复制链接链接已复制到粘贴板!

6.20.5. 动态置备复制链接链接已复制到粘贴板!

6.20.6. 静态置备复制链接链接已复制到粘贴板!

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

6.20.1. 关于 CSI
复制链接

6.20.2. 限制：
复制链接

6.20.3. 安装 CIFS/SMB CSI Driver Operator
复制链接

6.20.4. 安装 CIFS/SMB CSI 驱动程序
复制链接

6.20.5. 动态置备
复制链接

6.20.6. 静态置备
复制链接