Mise à jour du module complémentaire de cluster File Storage for VPC

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

1. Obtenez l'ID de votre cluster.

   ibmcloud ks cluster ls
   

2. Examinez les versions des modules complémentaires disponibles.

   ibmcloud ks cluster addon versions
   

3. Désactivez le module complémentaire.

   ibmcloud ks cluster addon disable vpc-file-csi-driver --cluster CLUSTER
   

4. Activez la version la plus récente du module complémentaire.

   ibmcloud ks cluster addon enable vpc-file-csi-driver --cluster CLUSTER --version VERSION
   

5. Vérifiez que le module complémentaire est activé en exécutant les commandes suivantes.

   kubectl get deploy -n kube-system | grep file
   

   ibm-vpc-file-csi-controller   2/2     2            2           13m
   

   kubectl get ds -n kube-system | grep file
   

   ibm-vpc-file-csi-node    2         2         2       2            2           <none>          14m
   

   kubectl get pods -n kube-system  | grep file
   

   ibm-vpc-file-csi-controller-7899db784-kc29g   5/5     Running   0             14m
   ibm-vpc-file-csi-controller-7899db784-mp5jt   5/5     Running   0             14m
   ibm-vpc-file-csi-node-bfqdz                   4/4     Running   0             14m
   ibm-vpc-file-csi-node-n7jbx                   4/4     Running   0             14m
   

Fixer des limites de ressources et de requêtes dans la carte de configuration

1. Exécutez la commande ci-dessous pour éditer la mappe de configuration.

   kubectl edit cm addon-vpc-file-csi-driver-configmap -n kube-system
   

   Exemple de sortie.

   apiVersion: v1
   data:
     CSIBlockDriverCPULimit: 300m
     CSIBlockDriverCPURequest: 75m
     CSIBlockDriverMemoryLimit: 600Mi
     CSIBlockDriverMemoryRequest: 150Mi
     CSIDriverRegistrarCPULimit: 40m
     CSIDriverRegistrarCPURequest: 10m
     CSIDriverRegistrarMemoryLimit: 80Mi
     CSIDriverRegistrarMemoryRequest: 20Mi
     CSILivenessProbeCPULimit: 20m
     CSILivenessProbeCPURequest: 5m
     CSILivenessProbeMemoryLimit: 40Mi
     CSILivenessProbeMemoryRequest: 10Mi
     CSINodeDriverCPULimit: 120m
     CSINodeDriverCPURequest: 30m
     CSINodeDriverMemoryLimit: 300Mi
     CSINodeDriverMemoryRequest: 75Mi
     CSIProvisionerCPULimit: 80m
     CSIProvisionerCPURequest: 20m
     CSIProvisionerMemoryLimit: 160Mi
     CSIProvisionerMemoryRequest: 40Mi
     CSIResizerCPULimit: 80m
     CSIResizerCPURequest: 20m
     CSIResizerMemoryLimit: 160Mi
     CSIResizerMemoryRequest: 40Mi
     EIT_ENABLED_WORKER_POOLS: ""
     ENABLE_EIT: "false"
     SET_DEFAULT_STORAGE_CLASS: ""
     SecretSidecarCPULimit: 60m
     SecretSidecarCPURequest: 15m
     SecretSidecarMemoryLimit: 80Mi
     SecretSidecarMemoryRequest: 20Mi
   kind: ConfigMap
   metadata:
     creationTimestamp: "2025-06-19T11:23:13Z"
     labels:
       app.kubernetes.io/name: ibm-vpc-file-csi-driver
     name: addon-vpc-file-csi-driver-configmap
   

2. Modifiez les paramètres si nécessaire, puis enregistrez le fichier.

Désactivation du module complémentaire

La désactivation de vpc-file-csi-driver supprime les packages de chiffrement en transit de vos noeuds worker.

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

   ibmcloud ks cluster addon disable --addon vpc-file-csi-driver --cluster CLUSTER
   

2. Vérifiez que les pods ont été retirés.

   kubectl get pods -n kube-system  | grep file
   

Description de vos options de retrait de stockage

Le balisage n'était pas pris en charge dans la version 1.2. Cela a un impact sur la suppression des partages de fichiers lorsqu'un cluster est supprimé avec l'option --force-delete-storage. Veillez à nettoyer toutes les réservations de volume persistant qui ont été créées avec la version 1.2 du module complémentaire avant de supprimer votre cluster.

La procédure de retrait du stockage persistant de votre compte IBM Cloud varie en fonction de la façon dont vous avez mis à disposition le stockage et des composants que vous avez déjà retirés.

Mon stockage persistant est-il supprimé lorsque je supprime mon cluster?

Lors de la suppression du cluster, vous avez la possibilité de retirer votre stockage persistant. Toutefois, selon la façon dont votre stockage a été mis à disposition, la procédure de retrait de votre stockage peut ne pas inclure tous les composants de stockage. Si vous avez provisionné dynamiquement le stockage avec une classe de stockage qui définit reclaimPolicy: Delete, votre PVC, PV et l'instance de stockage sont automatiquement supprimés lorsque vous supprimez le cluster. Pour le stockage provisionné statiquement ou le stockage provisionné avec une classe de stockage qui définit reclaimPolicy: Retain, le PVC et le PV sont supprimés lorsque vous supprimez le cluster, mais votre instance de stockage et vos données sont conservées. L'utilisation de votre instance de stockage vous est toujours facturée. Par ailleurs, si vous avez supprimé votre cluster alors qu'il n'était pas à l'état sain, le stockage peut encore exister, même si vous choisissez de le supprimer.

Comment supprimer le stockage lorsque je souhaite conserver mon cluster?

Lorsque vous avez mis à disposition le stockage de façon dynamique avec une classe de stockage indiquant reclaimPolicy: Delete, vous pouvez retirer la réservation de volume persistant (PVC) pour lancer le processus de suppression de votre stockage persistant. Votre réservation de volume persistant (PVC), votre volume persistant (PV) et votre instance de stockage sont automatiquement retirés. Pour le stockage qui a été provisionné de manière statique ou le stockage que vous avez provisionné avec une classe de stockage qui définit reclaimPolicy: Retain, vous devez supprimer manuellement le PVC, le PV et l'instance de stockage pour éviter d'autres frais.

Comment la facturation s'arrête-t-elle après que j'ai supprimé mon stockage?

Selon les composants de stockage que vous supprimez et le moment auquel vous les supprimez, il se peut que le cycle de facturation ne s'arrête pas immédiatement. Si vous supprimez la réservation de volume persistant et le volume persistant, mais pas l'instance dans votre compte IBM Cloud, cette instance continue à exister et vous êtes facturé pour son utilisation.

Si vous supprimez la PVC, le PV et l'instance de stockage, le cycle de facturation s'arrête en fonction du type de facturation (billingType) que vous avez choisi lors de la mise à disposition de votre stockage et de la façon dont vous avez choisi de supprimer le stockage.

• Lorsque vous annulez manuellement l'instance de stockage persistant à partir de la console IBM Cloud ou du CLI, la facturation s'arrête comme suit :

  • Stockage horaire : la facturation cesse immédiatement. Une fois votre stockage annulé, il se peut que votre instance de stockage soit toujours visible dans la console pendant une durée maximale de 72 heures.
  • Stockage mensuel : vous pouvez choisir l'option Annulation immédiate ou Annulation à la date anniversaire. Dans les deux cas, la facturation se poursuit jusqu'à la fin du cycle de facturation en cours et cesse pour le cycle de facturation suivant. Une fois votre stockage annulé, il se peut que votre instance de stockage soit toujours visible dans la console ou l'interface de ligne de commande pendant une durée maximale de 72 heures.
  • Annulation immédiate : choisissez cette option pour retirer immédiatement votre stockage. Ni vous ni vos utilisateurs ne pouvez plus utiliser le stockage ou récupérer les données.
  • Annulation à la date anniversaire : choisissez cette option pour annuler votre stockage à la date anniversaire suivante. Vos instances de stockage restent actives jusqu'à la date anniversaire suivante et vous pouvez continuer de les utiliser jusqu'à cette date, par exemple, afin de permettre à votre équipe de créer des copies de sauvegarde de vos données.

• Lorsque vous avez mis à disposition le stockage de façon dynamique avec une classe de stockage indiquant reclaimPolicy: Delete que vous choisissez de retirer la réservation de volume persistant (PVC), le volume persistant (PV) et l'instance de stockage sont immédiatement retirés. Pour le stockage facturé à l'heure, la facturation s'arrête immédiatement. Pour le stockage facturé au mois, vous êtes facturé jusqu'à la fin du mois en cours. Une fois votre stockage retiré et la facturation arrêtée, il se peut que votre instance de stockage soit toujours visible dans la console ou l'interface de ligne de commande pendant une durée maximale de 72 heures.

Que dois-je savoir avant de supprimer le stockage persistant?

Lorsque vous nettoyez du stockage persistant, vous supprimez toutes les données qui y sont stockées. Si vous avez besoin d'une copie des données, effectuez une sauvegarde.

J'ai supprimé mon instance de stockage. Pourquoi puis-je encore voir mon instance?

Une fois que vous avez retiré le stockage persistant, il peut s'écouler jusqu'à 72 heures avant que le retrait soit total et que le stockage disparaisse de votre console ou interface de ligne de commande IBM Cloud.

Nettoyage de stockage persistant

Retirez la PVC, le PV et l'instance de stockage de votre compte IBM Cloud afin d'éviter d'autres frais liés à votre stockage persistant.

Avant de commencer :

• Vérifiez que vous avez sauvegardé les données que vous souhaitez conserver.
• Connectez-vous à votre compte. Le cas échéant, ciblez le groupe de ressources approprié. Définissez le contexte de votre cluster.

Pour nettoyer des données persistantes :

1. Répertoriez les réservations de volume persistant (PVC) figurant dans votre cluster et notez le nom de la PVC (NAME), la classe de stockage (STORAGECLASS) et le nom du volume persistant lié à la PVC indiqué sous VOLUME.

   kubectl get pvc
   

   Exemple de sortie

   NAME                  STATUS    VOLUME                                     CAPACITY   ACCESSMODES   STORAGECLASS            AGE
   claim1   Bound     pvc-06886b77-102b-11e8-968a-f6612bb731fb   20Gi       RWO           class       78d
   claim2     Bound     pvc-457a2b96-fafc-11e7-8ff9-b6c8f770356c   4Gi        RWX           class 105d
   claim3      Bound     pvc-1efef0ba-0c48-11e8-968a-f6612bb731fb   24Gi       RWX           class        83d
   

2. Passez en revue la ReclaimPolicy et le billingType correspondant à la classe de stockage.

   kubectl describe storageclass <storageclass_name>
   

   Si la politique de récupération indique Delete, votre volume persistant et le stockage physique sont supprimés en même temps que la PVC. Si la politique de récupération indique Retain ou si vous avez mis à disposition votre stockage sans classe de stockage, votre volume persistant et votre stockage physique ne sont pas supprimés en même temps que la PVC. Vous devez supprimer la PVC, le volume persistant et le stockage physique séparément.

   Si vous êtes facturé tous les mois pour le stockage, vous êtes redevable pour le mois complet, même si vous supprimez le stockage avant la fin du cycle de facturation.

3. Supprimez les pods qui montent la PVC. Répertoriez les pods qui montent la PVC. Si aucun pod n'est retourné dans votre sortie CLI, vous n'avez pas de pod qui utilise le PVC.

   kubectl get pods --all-namespaces -o=jsonpath='{range .items[*]}{"\n"}{.metadata.name}{":\t"}{range .spec.volumes[*]}{.persistentVolumeClaim.claimName}{" "}{end}{end}' | grep "<pvc_name>"
   

   Exemple de sortie

   depl-12345-prz7b:    claim1
   

4. Supprimez le pod utilisant la PVC. Si le pod fait partie d'un déploiement, retirez ce déploiement.

   kubectl delete pod <pod_name>
   

5. Vérifiez que le pod est supprimé.

   kubectl get pods
   

6. Supprimez la PVC.

   kubectl delete pvc <pvc_name>
   

7. Examinez le statut de votre volume persistant. Utilisez le nom du volume persistant que vous avez récupéré précédemment sous VOLUME. Lorsque vous supprimez la PVC, le volume persistant lié à cette PVC est libéré. Selon le mode de mise à disposition de votre stockage, votre volume persistant va passer à l'état Deleting (suppression) si sa suppression est automatique ou à l'état Released (libéré) si vous devez le supprimer manuellement. Remarque : pour les volumes persistants supprimés automatiquement, l'état peut brièvement indiquer Released avant sa suppression définitive. Exécutez à nouveau la commande au bout de quelques minutes pour voir si le volume persistant est supprimé.

   kubectl get pv <pv_name>
   

8. Si votre volume persistant n'est pas supprimé, supprimez-le manuellement.

   kubectl delete pv <pv_name>
   

9. Vérifiez que le volume persistant (PV) est supprimé.

   kubectl get pv
   

10. Répertoriez vos partages.

    ibmcloud is shares
    

11. Répertoriez chaque partage de fichiers et recherchez l'ID de cluster associé.

    ibmcloud is share SHARE | grep CLUSTER-ID
    

12. Supprimez les partages.

    ibmcloud is share-delete (SHARE1 SHARE2 ...)