Comprendre la création et la suppression des seaux

• Vous pouvez utiliser un seau existant en spécifiant le nom du seau dans votre PVC.
• Si vous fournissez un nom de seau et que ce seau n'existe pas, un seau portant ce nom est créé.
• Si vous ne fournissez pas de nom de godet, un godet avec la convention de dénomination temp-xxx est créé.
• Les bacs sont supprimés en fonction de la politique de récupération définie dans votre classe de stockage.
  • Si reclaimPolicy: Delete est défini, le seau est supprimé lorsque le PVC est supprimé.
  • Si reclaimPolicy: Retain est défini, le seau est conservé même après la suppression du PVC.

Activation de l'extension IBM Cloud Object Storage

Avant de commencer : Connectez-vous à votre compte. Le cas échéant, ciblez le groupe de ressources approprié. Définissez le contexte de votre cluster.

1. Listez les modules complémentaires et trouvez la version que vous souhaitez installer.

   ibmcloud ks cluster addon versions
   

   Exemple de sortie

   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. Installer le module complémentaire.

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

3. Vérification de l'installation.

   ibmcloud ks 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. Liste des classes de stockage disponibles.

   kubectl 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
   

Déployer une application qui utilise IBM Cloud Object Storage

Configuration de la récupération automatique pour les volumes périmés

Lorsque la connexion est perdue entre les ibm-object-csi-driver pods de serveur de nœuds et les pods d'application, vous pouvez voir des TransportEndpoint erreurs de connexion. Cette erreur peut se produire lorsque des mises à jour de correctifs sont appliquées. Pour éviter les erreurs de connexion, configurez la récupération automatique des volumes périmés en suivant les étapes suivantes.

1. Copiez le fichier yaml suivant et enregistrez-le dans un fichier appelé 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. Créez la ressource RecoverStaleVolume dans votre cluster.

   kubectl create -f stale.yaml
   

   Exemple de sortie

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

3. Vérifier que la ressource a été créée.

   kubectl get recoverstalevolume
   

   Exemple de sortie

   NAME  AGE  recoverstalevolume-sample   41s
   

4. Si le problème persiste, contactez l'assistance. Ouverture d'un cas de support. Dans les détails de l'affaire, veillez à inclure tout fichier journal, message d'erreur ou résultat de commande pertinent.

Désactivation du module complémentaire IBM Cloud Object Storage

1. Exécutez la commande suivante pour désactiver le module complémentaire.

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

   Exemple de sortie

   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. Vérifier que le module complémentaire a été supprimé.

   ibmcloud ks cluster addon ls --cluster CLUSTER
   

Migration du plug-in Helm vers le module complémentaire cluster

1. Connectez-vous à votre compte. Le cas échéant, ciblez le groupe de ressources approprié. Définissez le contexte de votre cluster.

2. Obtenez les détails de vos PVC et sélectionnez-en un à migrer.

   kubectl 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
   

   Exemple de sortie

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

3. Décrire le PVC et obtenir le nom du seau.

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

   Exemple de sortie

   ibm.io/bucket: test-s3
   

4. Créez un secret portant le même nom que votre 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. Recherchez la classe de stockage utilisée dans votre PVC.

   kubectl describe pvc <pvc_name> | grep StorageClass:
   

   Exemple de commande pour un PVC appelé test-s3.

   kubectl describe pvc test-s3 | grep StorageClass:
   

   Exemple de sortie

   StorageClass:  ibmc-s3fs-smart-perf-regional
   

6. Examinez les nouvelles classes de stockage disponibles avec le module complémentaire et sélectionnez une classe de remplacement.

   • Si vous avez utilisé une classe flex, choisissez l'une des nouvelles classes smart
   • Si vous avez utilisé une classe standard, choisissez l'une des nouvelles classes standard
   • Les classes cold et vault ne sont plus disponibles avec le module complémentaire ; choisissez une classe smart ou standard à la place.

7. Examinez les détails de votre PVC.

   kubectl describe pvc test-s3
   

   Exemple de sortie

   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. Créez un PVC de remplacement qui utilise une nouvelle classe de stockage et fait référence au secret que vous avez créé précédemment.

   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. Vérifier que le PVC est Bound.

   kubectl get pvc
   

10. Obtenez les détails de votre application.

    kubectl get pods
    

11. Réduisez votre application à zéro.

    kubectl scale deployment --replicas=0 my-app
    

12. Créez un déploiement de remplacement qui fait référence au PVC que vous avez créé à l'étape précédente.

13. Une fois la nouvelle répartition en cours d'exécution, vous pouvez supprimer l'ancienne répartition.

14. Répétez ces étapes pour chaque PVC que vous souhaitez migrer.

IBM Cloud Object Storage cluster add-on storage classes