了解水桶的创建和移除

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

启用IBM Cloud Object Storage附加组件

开始之前 访问你的Red Hat OpenShift集群。

1. 列出附加组件并找到要安装的版本。

   ibmcloud oc cluster addon versions
   

   示例输出

   OK
   Name                        Version            Supported Kubernetes Range   Supported OpenShift Range   Kubernetes Default                   OpenShift Default
   ibm-object-csi-driver       0.1 (default)      >=1.30.0                     >=4.15.0                    -                                    -
   

2. 安装插件。

   ibmcloud oc cluster addon enable ibm-object-csi-driver --cluster CLUSTER [--version VERSION]
   

3. 验证安装。

   ibmcloud oc cluster addon ls --cluster CLUSTER
   

   OK
   Name                    Version   Health State   Health Status
   ibm-object-csi-driver   0.1       normal         Addon Ready. For more info: http://ibm.biz/addon-state (H1500)
   

4. 列出可用的存储类别。

   oc get sc | grep object
   

   ibm-object-storage-smart-rclone             cos.s3.csi.ibm.io   Delete          Immediate           false                  17h
   ibm-object-storage-smart-rclone-retain      cos.s3.csi.ibm.io   Retain          Immediate           false                  17h
   ibm-object-storage-smart-s3fs               cos.s3.csi.ibm.io   Delete          Immediate           false                  17h
   ibm-object-storage-smart-s3fs-retain        cos.s3.csi.ibm.io   Retain          Immediate           false                  17h
   ibm-object-storage-standard-rclone          cos.s3.csi.ibm.io   Delete          Immediate           false                  17h
   ibm-object-storage-standard-rclone-retain   cos.s3.csi.ibm.io   Retain          Immediate           false                  17h
   ibm-object-storage-standard-s3fs            cos.s3.csi.ibm.io   Delete          Immediate           false                  17h
   ibm-object-storage-standard-s3fs-retain     cos.s3.csi.ibm.io   Retain          Immediate           false                  17h
   

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

为陈旧卷设置自动恢复功能

当 ibm-object-csi-driver 节点服务器 pod 和应用程序 pod 之间的连接丢失时，可能会出现 TransportEndpoint 连接错误。 出现这种错误的一种可能情况是应用了补丁更新。 为避免出现连接错误，请通过完成以下步骤设置过期卷的自动恢复。

1. 复制以下 yaml 并将其保存为名为 stale.yaml 的文件

   apiVersion: objectdriver.csi.ibm.com/v1alpha1
   kind: RecoverStaleVolume
   metadata:
     labels:
       app.kubernetes.io/name: recoverstalevolume
       app.kubernetes.io/instance: recoverstalevolume-sample
     name: recoverstalevolume-sample
     namespace: default
   spec:
     logHistory: 200
     data:
       - namespace: default # The namesapce where your app is deployed
         deployments: [<A comma separated list of all the apps you want to recover>]
   

2. 在群集中创建 RecoverStaleVolume 资源。

   oc create -f stale.yaml
   

   示例输出

   recoverstalevolume.objectdriver.csi.ibm.com/recoverstalevolume-sample created
   

3. 确认资源已创建。

   oc get recoverstalevolume
   

   示例输出

   NAME  AGE  recoverstalevolume-sample   41s
   

4. 如果问题仍然存在，请联系支持团队。 打开 支持案例。 在案例详细信息中，请务必包含任何相关日志文件、错误信息或命令输出。

禁用IBM Cloud Object Storage附加组件

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. 创建一个与 PVC 名称相同的秘密。

   apiVersion: v1
   kind: Secret
   type: cos-s3-csi-driver
   metadata:
       name: test-s3 # Name your secret the same name your PVC
       namespace: default # Specify the namespace where you want to create the secret. In this example, the previous PVC and secret were in the default namespace.
   data:
       bucketName: <base64-encoded-bucket-name>
       apiKey: <base64-encoded-COS-Service-Instance-API-key>
       accessKey: <base64-encoded-HMAC-access-key>
       secretKey: <base64-encoded-HMAC-secret-key>
   stringData:
   # uid: "3000" # Optional: Provide a uid to run as non root user. This must match runAsUser in SecurityContext of pod spec.
   mountOptions: |
   

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.beta.kubernetes.io/storage-provisioner: ibm.io/ibmc-s3fs
               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: test-s3 # Enter the same name as the secret you created earlier.
   spec:
   accessModes:
   - ReadWriteOnce
   resources:
       requests:
       storage: 3Gi
   storageClassName: ibm-object-storage-smart-s3fs
   

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集群附加存储类