Comprendere la creazione e la rimozione dei bucket

• È possibile utilizzare un bucket esistente specificando il nome del bucket nel PVC.
• Se si fornisce il nome di un bucket e questo non esiste, viene creato un bucket con quel nome.
• Se non si fornisce un nome al bucket, viene creato un bucket con la convenzione di denominazione temp-xxx.
• I bucket vengono eliminati in base ai criteri di recupero definiti nella classe di archiviazione.
  • Se è impostato reclaimPolicy: Delete, il bucket viene eliminato quando il PVC viene cancellato.
  • Se viene impostato reclaimPolicy: Retain, il bucket viene mantenuto anche dopo la cancellazione del PVC.

Limitazione della pianificazione dei pod del nodeserver

Per impostazione predefinita, i pod del driver COS CSI nodeserver vengono pianificati su tutti i nodi del cluster. È possibile utilizzare il parametro restrictNodeServerScheduling per limitare la pianificazione dei pod del nodeserver esclusivamente ai nodi contrassegnati con l'etichetta cos.csi.ibm.io/csi-node=true``.

È possibile configurare l' restrictNodeServerScheduling e al momento dell'attivazione del componente aggiuntivo oppure aggiornarla in un secondo momento applicando una patch all' ConfigMap.

• Per impostare restrictNodeServerScheduling all'attivazione del componente aggiuntivo, includere il flag --param nel comando di abilitazione.

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

• Per aggiornare restrictNodeServerScheduling dopo che l'estensione è già stata abilitata, segui questi passaggi.

1. Elenca i nodi del tuo cluster e stabilisci dove desideri che vengano eseguiti i pod del driver COS.

   oc get nodes
   

   Output di esempio

   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. Verificare che i pod di nodeserver siano attualmente in esecuzione su tutti i nodi.

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

   Output di esempio

   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. Contrassegna i nodi su cui desideri che vengano pianificati i pod di nodeserver.

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

   Output di esempio

   node/10.241.0.11 labeled
   node/10.241.0.12 labeled
   

4. Per attivare la restrizione, aggiorna il file ConfigMap.

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

   Output di esempio

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

5. Verificare che i pod dei nodi server vengano pianificati esclusivamente su nodi contrassegnati.

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

   Output di esempio

   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>
   

Impostazione dei volumi massimi per nodo

Per impostazione predefinita, il driver COS CSI non limita il numero di volumi che possono essere montati su un singolo nodo. È possibile utilizzare il parametro maxVolumesPerNode per impostare il numero massimo di volumi per nodo.

È possibile configurare l' maxVolumesPerNode e al momento dell'attivazione del componente aggiuntivo oppure aggiornarla in un secondo momento applicando una patch all' ConfigMap.

• Per impostare maxVolumesPerNode all'attivazione del componente aggiuntivo, includere il flag --param nel comando di abilitazione.

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

• Per aggiornare maxVolumesPerNode dopo che l'add-on è già stato abilitato, applicare la patch all'add-on gestito ConfigMap.

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

  Output di esempio

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

Distribuzione di un'applicazione che utilizza 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.

Disabilitazione del componente aggiuntivo IBM Cloud Object Storage

I segreti, i PVC e le distribuzioni esistenti non vengono cancellati dalla disattivazione del componente aggiuntivo o dagli aggiornamenti della patch. Non ci sono interruzioni nei carichi di lavoro esistenti dei clienti.

1. Eseguire il seguente comando per disattivare il componente aggiuntivo.

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

   Output di esempio

   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. Verificare che il componente aggiuntivo sia stato rimosso.

   ibmcloud oc cluster addon ls --cluster CLUSTER
   

Migrazione dal plug-in Helm al componente aggiuntivo per cluster

1. Accedi al tuo cluster Red Hat OpenShift.

2. Ottenete i dettagli dei vostri PVC e selezionatene uno da migrare.

   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
   

   Output di esempio

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

3. Descrivere il PVC e ottenere il nome del secchio.

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

   Output di esempio

   ibm.io/bucket: test-s3
   

4. Ricreate il vostro segreto con il nome del secchio incluso.

   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. Trovare la classe di archiviazione utilizzata nel PVC.

   oc describe pvc <pvc_name> | grep StorageClass:
   

   Esempio di comando per un PVC chiamato test-s3.

   oc describe pvc test-s3 | grep StorageClass:
   

   Output di esempio

   StorageClass:  ibmc-s3fs-smart-perf-regional
   

6. Esaminare le nuove classi di archiviazione disponibili con il componente aggiuntivo e selezionare una classe sostitutiva.

   • Se si è utilizzata una classe flex, scegliere una delle nuove classi smart.
   • Se avete usato una classe standard, scegliete una delle nuove classi standard.
   • Le classi cold e vault non sono più disponibili con il componente aggiuntivo; scegliete invece una classe smart o standard.

7. Esaminate i dettagli del vostro PVC.

   oc describe pvc test-s3
   

   Output di esempio

   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. Creare un PVC sostitutivo che utilizzi una nuova classe di archiviazione e faccia riferimento al segreto creato in precedenza.

   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. Verificare che il PVC sia Bound.

   oc get pvc
   

10. Scopri i dettagli della tua app.

    oc get pods
    

11. Riducete la vostra applicazione a zero.

    kubectl scale deployment --replicas=0 my-app
    

12. Creare un'installazione sostitutiva che faccia riferimento al PVC creato nel passaggio precedente.

13. Dopo che la nuova installazione client è in esecuzione, è possibile eliminare la vecchia installazione client.

14. Ripeti questi passaggi per ogni PVC che desideri migrare.

IBM Cloud Object Storage classi di archiviazione aggiuntive al cluster

Il componente aggiuntivo per cluster IBM Cloud Object Storage fornisce classi di archiviazione per i montaggi s3fs e rclone. Scegli una classe di archiviazione adatta ai tuoi requisiti di accesso ai dati. La classe di archiviazione determina la classe del bucket, il criterio di recupero e il comportamento di montaggio predefinito per il bucket creato per il carico di lavoro.

Standard

Utilizzare per i dati caldi a cui si accede di frequente, come i dati per le applicazioni web o mobili.

Intelligenza

Da utilizzare per carichi di lavoro e dati che non seguono un modello di utilizzo specifico o quando il modello di utilizzo è difficile da prevedere.

Per esaminare la configurazione dettagliata dei bucket per una classe di archiviazione, eseguire oc describe storageclass <storageclass_name> o oc describe storageclass <storageclass_name>.