了解水桶的创建和移除

• 您可以通过在 PVC 中指定水桶名称来使用现有的水桶。
• 如果您提供了一个水桶名称，而该水桶并不存在，那么就会创建一个具有该名称的水桶。
• 如果您未提供存储桶名称，系统将根据挂载器类型，创建一个遵循命名规范 s3fs-<timestamp>-xxx 或 rclone-<timestamp>-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>
       mountOptions: |
           # uid=3000  # Optional: Run as non-root user. Must match runAsUser in SecurityContext of pod spec.
           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 安装程序提供存储类。 选择符合您的数据访问需求的存储类。 存储类别决定了为工作负载创建的存储桶类别、回收策略和默认挂载行为。

标准

适用于频繁访问的“热数据”。 常见用例是 Web 或移动应用程序。

保险库

适用于访问频率较低的工作负载或冷数据，例如每月访问一次或更少。 常见用例是归档、短期数据保留、数字资产保留、磁带更换和灾难恢复。

Cold

适用于很少被访问（每90天或更少）的冷数据，或非活跃数据。 常见用例是归档、长期备份、为合规性保留的历史数据或很少访问的工作负载和应用程序。

智能

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

决定用于存储区中所存储数据的弹性级别。 有关更多信息，请参阅区域和端点。

跨区域

您的数据存储在同一地理位置内的三个区域中，以确保最高可用性。 如果您具有跨区域分布的工作负载，那么会将请求路由到离您最近的区域端点。 地理位置的 IBM Cloud Object Storage 端点会根据您的集群所在的位置自动设置。 例如，如果您的集群位于 US South，那么您的存储类将配置为使用 US GEO 作为存储桶的端点。 选择名称中包含“cross-region”的存储类。

区域

您的数据会在同一区域内的多个可用区中进行复制。 如果您的工作负载位于同一区域中，那么会看到相比跨区域设置，等待时间更短，性能更好。 区域终点会根据您的集群所在的位置自动设置。 例如，如果您的集群位于 US South，则您的存储类已配置为使用 US South 作为存储桶的区域端点。 请选择名称中不包含“cross-region”的存储类。

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