了解水桶的创建和移除

• 您可以通过在 PVC 中指定水桶名称来使用现有的水桶。
• 如果您提供了一个水桶名称，而该水桶并不存在，那么就会创建一个具有该名称的水桶。
• 如果不提供存储桶名称，则会创建一个命名为 temp-xxx 的存储桶。
• 根据存储类中定义的回收策略删除存储桶。
  • 如果设置了 reclaimPolicy: Delete，则在删除 PVC 时删除水桶。
  • 如果设置了 reclaimPolicy: Retain，则即使删除了 PVC，也会保留水桶。

限制节点服务器 Pod 的调度

默认情况下，COS CSI 驱动程序的 nodeserver Pod 会调度到集群中的所有节点上。 您可以使用 restrictNodeServerScheduling 参数，将nodeserver的Pod调度限制在仅带有 cos.csi.ibm.io/csi-node=true 标签的节点上。

您可以在启用该插件时配置 restrictNodeServerScheduling，也可以稍后通过修补 ConfigMap 文件来更新它。

• 若要在启用该附加组件时将 restrictNodeServerScheduling 设置为启用状态，请在启用命令中包含 --param 标志。

  ibmcloud oc cluster addon enable ibm-object-csi-driver --cluster CLUSTER --param "restrictNodeServerScheduling=true"
  

• 若要在已启用该附加组件后更新“restrictNodeServerScheduling”，请按照以下步骤操作。

1. 列出集群中的节点，并确定希望在哪些节点上运行 COS 驱动程序 Pod。

   oc get nodes
   

   示例输出

   NAME            STATUS   ROLES    AGE    VERSION
   10.241.0.11     Ready    <none>   5d2h   v1.35.5+IKS
   10.241.0.12     Ready    <none>   5d2h   v1.35.5+IKS
   10.241.0.13     Ready    <none>   5d2h   v1.35.5+IKS
   10.241.128.10   Ready    <none>   5d2h   v1.35.5+IKS
   10.241.128.11   Ready    <none>   5d2h   v1.35.5+IKS
   10.241.128.9    Ready    <none>   5d2h   v1.35.5+IKS
   10.241.65.12    Ready    <none>   5d2h   v1.35.5+IKS
   10.241.65.13    Ready    <none>   5d2h   v1.35.5+IKS
   10.241.65.14    Ready    <none>   5d2h   v1.35.5+IKS
   

2. 请检查所有节点上是否都有节点服务器 Pod 正在运行。

   oc get pods -n ibm-object-csi-operator -l app.kubernetes.io/component=node -o wide
   

   示例输出

   NAME                        READY   STATUS    RESTARTS   AGE    IP              NODE            NOMINATED NODE   READINESS GATES
   ibm-object-csi-node-2pj2j   3/3     Running   0          145m   172.17.14.10    10.241.0.12     <none>           <none>
   ibm-object-csi-node-7bhwh   3/3     Running   0          145m   172.17.1.72     10.241.65.12    <none>           <none>
   ibm-object-csi-node-7l9hc   3/3     Running   0          145m   172.17.17.6     10.241.128.9    <none>           <none>
   ibm-object-csi-node-cxzt7   3/3     Running   0          145m   172.17.39.72    10.241.0.11     <none>           <none>
   ibm-object-csi-node-dw6qs   3/3     Running   0          145m   172.17.46.77    10.241.128.10   <none>           <none>
   ibm-object-csi-node-rpcvr   3/3     Running   0          145m   172.17.32.198   10.241.65.13    <none>           <none>
   ibm-object-csi-node-swqtg   3/3     Running   0          145m   172.17.16.69    10.241.0.13     <none>           <none>
   ibm-object-csi-node-sxbbs   3/3     Running   0          145m   172.17.26.7     10.241.65.14    <none>           <none>
   ibm-object-csi-node-xm8bt   3/3     Running   0          145m   172.17.20.200   10.241.128.11   <none>           <none>
   

3. 为希望调度 nodeserver Pod 的节点添加标签。

   oc label nodes NODE-NAME-1 NODE-NAME-2 cos.csi.ibm.io/csi-node=true
   

   示例输出

   node/10.241.0.11 labeled
   node/10.241.0.12 labeled
   

4. 通过更新 ConfigMap 来启用该限制。

   oc patch cm managed-addon-ibm-object-csi-driver -n kube-system \
     --type merge -p '{"data":{"restrictNodeServerScheduling":"true"}}'
   

   示例输出

   configmap/managed-addon-ibm-object-csi-driver patched
   

5. 请确认节点服务器 Pod 仅被调度到带有标签的节点上。

   oc get pods -n ibm-object-csi-operator -l app.kubernetes.io/component=node -o wide
   

   示例输出

   NAME                        READY   STATUS    RESTARTS   AGE    IP             NODE           NOMINATED NODE   READINESS GATES
   ibm-object-csi-node-cxzt7   3/3     Running   0          145m   172.17.39.72   10.241.0.11    <none>           <none>
   ibm-object-csi-node-7bhwh   3/3     Running   0          145m   172.17.1.72    10.241.65.12   <none>           <none>
   

设置每个节点的最大卷数

默认情况下，COS CSI 驱动程序不会限制单个节点上可挂载的卷数量。 您可以使用 maxVolumesPerNode 参数来设置每个节点上的卷最大数量。

您可以在启用该插件时配置 maxVolumesPerNode，也可以稍后通过修补 ConfigMap 文件来更新它。

• 若要在启用该附加组件时将 maxVolumesPerNode 设置为启用状态，请在启用命令中包含 --param 标志。

  ibmcloud oc cluster addon enable ibm-object-csi-driver --cluster CLUSTER --param "maxVolumesPerNode=VALUE"
  

• 若要在已启用该附加组件后更新 maxVolumesPerNode，请修补受管附加组件 ConfigMap。

  oc patch cm managed-addon-ibm-object-csi-driver -n kube-system --type merge -p '{"data":{"maxVolumesPerNode":"VALUE"}}'
  

  示例输出

  configmap/managed-addon-ibm-object-csi-driver patched
  

部署使用IBM Cloud Object Storage的应用程序

cos.csi.driver/secret: "<custom-secret>"

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: cos-secret-1 # Give your PVC the same name as the secret you created in the previous step.
  namespace: <namespace> # The namespace where you want to create the PVC.
spec:
  accessModes:
  - ReadWriteMany
  resources:
    requests:
      storage: 10Gi
  storageClassName: <storage_class_name> # The storage class you want to use.

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: cos-csi-pvc1
  namespace: <namespace> # The namespace where you want to create the PVC.
  annotations:
    cos.csi.driver/secret: "<custom-secret>"
spec:
  accessModes:
  - ReadWriteOnce
  resources:
    requests:
      storage: 256Mi
  storageClassName: <storage_class_name> # The storage class you want to use.

禁用IBM Cloud Object Storage附加组件

禁用插件或补丁更新不会删除现有的机密、PVC 和部署。 不会中断客户现有的工作负载。

1. 运行以下命令以禁用该插件。

    ibmcloud oc cluster addon disable ibm-object-csi-driver --cluster CLUSTER
   

   示例输出

   Data and resources that you created for the add-on might be deleted when the add-on is disabled. Continue? [y/N]> y
   Disabling add-on ibm-object-csi-driver for cluster XXX...
   OK
   

2. 验证是否已删除附加组件。

   ibmcloud oc cluster addon ls --cluster CLUSTER
   

从Helm插件迁移到群集插件

1. 访问您的Red Hat OpenShift集群。

2. 获取 PVC 的详细信息并选择一个进行迁移。

   oc get pvc --all-namespaces -o custom-columns='NAMESPACE:.metadata.namespace,NAME:.metadata.name' | tail -n +2 | while read namespace pvc; do kubectl describe pvc "$pvc" -n "$namespace" | grep 'volume.kubernetes.io/storage-provisioner: ibm.io/ibmc-s3fs' > /dev/null ; if [ $? -eq 0 ]; then echo "PVC: $pvc in Namespace: $namespace uses ibm.io/ibmc-s3fs storage provisioner"; fi; done
   

   示例输出

   PVC: pvc-test in Namespace: default uses ibm.io/ibmc-s3fs storage provisioner
   

3. 描述 PVC 并获取水桶名称。

   oc describe pvc <pvc_name> | grep ibm.io/bucket:
   

   示例输出

   ibm.io/bucket: test-s3
   

4. 重新创建包含水桶名称的秘密。

   apiVersion: v1
   kind: Secret
   type: cos-s3-csi-driver
   metadata:
       name: cos-secret-1 # Name your secret.
       namespace: <namespace> # Specify the namespace where you want to create the secret.
   data:
       accessKey: <base64-encoded-HMAC-access-key>
       secretKey: <base64-encoded-HMAC-secret-key>
   stringData:
       bucketName: <bucket-name>
       # uid: "3000" # Optional: Provide a uid to run as non root user. This must match runAsUser in SecurityContext of pod spec.
       mountOptions: |
           key1=value1
           key2=value2
   

5. 查找 PVC 中使用的存储类。

   oc describe pvc <pvc_name> | grep StorageClass:
   

   名为 test-s3 的 PVC 的命令示例。

   oc describe pvc test-s3 | grep StorageClass:
   

   示例输出

   StorageClass:  ibmc-s3fs-smart-perf-regional
   

6. 查看新的存储类别 that are available with the add-on and select a replacement class.

   • 如果您使用的是 flex 类，请选择一个新的 smart 类。
   • 如果您使用的是 standard 类，请选择一个新的 standard 类。
   • 附加组件不再提供 cold 和 vault 类，请选择 smart 或 standard 类。

7. 查看 PVC 的详细信息。

   oc describe pvc test-s3
   

   示例输出

   Name:          pvc-test
   Namespace:     default
   StorageClass:  ibmc-s3fs-smart-perf-regional
   Status:        Bound
   Volume:        pvc-c625474d-31f0-4929-bc3e-feace1fb42fb
   Labels:        <none>
   Annotations:   ibm.io/auto-create-bucket: true
               ibm.io/auto-delete-bucket: true
               ibm.io/bucket: bha-test-s23
               ibm.io/secret-name: satstoragesecret
               pv.kubernetes.io/bind-completed: yes
               pv.kubernetes.io/bound-by-controller: yes
               volume.kubernetes.io/storage-provisioner: ibm.io/ibmc-s3fs
   Finalizers:    [kubernetes.io/pvc-protection]
   Capacity:      3Gi
   Access Modes:  RWO
   VolumeMode:    Filesystem
   Used By:       test-pod
   Events:        <none>
   

8. 创建一个替代 PVC，使用新的存储类并引用你之前创建的秘密。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
   name: cos-csi-pvc1
   namespace: <namespace> # The namespace where you want to create the PVC.
   annotations:
       cos.csi.driver/secret: "cos-secret-1"  # Secret created in step 4
   spec:
   accessModes:
   - ReadWriteOnce
   resources:
       requests:
       storage: 256Mi
   storageClassName: <storage_class_name> # The storage class you picked based on old storage class mapping.
   

9. 确认 PVC 为 Bound。

   oc get pvc
   

10. 获取应用程序的详细信息。

    oc get pods
    

11. 将应用程序的规模缩小到零。

    kubectl scale deployment --replicas=0 my-app
    

12. 创建一个替换部署，引用上一步中创建的 PVC。

13. 新部署运行后，可以删除旧部署。

14. 对于每个需要迁移的 PVC，请重复上述步骤。

IBM Cloud Object Storage集群附加存储类

IBM Cloud Object Storage 群集附加组件为 s3fs 和 rclone 安装程序提供存储类。 选择符合您的数据访问需求的存储类。 存储类别决定了为工作负载创建的存储桶类别、回收策略和默认挂载行为。

标准

用于您经常访问的热数据，如网络或移动应用程序的数据。

智能

适用于没有特定使用模式的工作负载和数据，或使用模式难以预测的情况。

要查看存储类的详细存储桶配置，请运行 oc describe storageclass <storageclass_name> 或 oc describe storageclass <storageclass_name>。