了解儲存桶的建立和刪除

• 您可以透過在 PVC 中指定儲存桶名稱來使用現有儲存桶。
• 如果您提供儲存桶名稱，但該儲存桶不存在，則會建立具有該名稱的儲存桶。
• 如果您不提供儲存桶名稱，則會建立具有命名約定 temp-xxx 的儲存桶。
• 根據儲存類別中定義的回收策略刪除儲存桶。
  • 如果設定了 reclaimPolicy: Delete，則刪除PVC時，該桶也會被刪除。
  • 如果設定了 reclaimPolicy: Retain，則即使刪除PVC，該桶仍會保留。

限制節點伺服器 Pod 的調度

預設情況下，COS CSI 驅動程式節點伺服器 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. 請確認 nodeserver 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. 查看該附加元件提供的新儲存類別 並選擇取代類別。

   • 如果您使用了 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>。