Foire aux questions sur la migration vers Amazon EBS CSI - Amazon EKS

Aidez à améliorer cette page

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Vous souhaitez contribuer à ce guide de l'utilisateur ? Choisissez le GitHub lien Modifier cette page sur qui se trouve dans le volet droit de chaque page. Vos contributions aideront à améliorer notre guide de l'utilisateur pour tout le monde.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Foire aux questions sur la migration vers Amazon EBS CSI

Important

Si vous avez Pods s'exécutant sur une version 1.22 ou un cluster antérieur, vous devez installer le pilote Amazon EBS CSI (voirStockage Kubernetes volumes avec Amazon EBS) avant de mettre à jour votre cluster vers la version 1.23 afin d'éviter toute interruption de service.

La fonctionnalité de migration de l'interface de stockage de conteneurs (CSI) Amazon EBS transfère la responsabilité de la gestion des opérations de stockage du fournisseur de stockage EBS intégré à l'arborescence Amazon EBS au pilote Amazon EBS CSI (voir). Stockage Kubernetes volumes avec Amazon EBS

Que sont les pilotes CSI ?

Pilotes CSI :

  • Remplacez le Kubernetes pilotes de stockage « intégrés à l'arbre » qui existent dans le Kubernetes code source du projet.

  • Travaillez avec des fournisseurs de stockage, tels qu'Amazon EBS.

  • Proposez un modèle de plug-in simplifié qui permet aux fournisseurs de stockage de AWS publier plus facilement des fonctionnalités et de maintenir le support sans dépendre du Kubernetes cycle de publication.

Pour plus d'informations, voir Introduction dans le Kubernetes Documentation CSI.

Qu'est-ce que la migration vers CSI ?

Le Kubernetes La fonction de migration CSI déplace la responsabilité de la gestion des opérations de stockage des plugins de stockage intégrés existantskubernetes.io/aws-ebs, tels que les pilotes CSI correspondants. Les objets existants StorageClass,PersistentVolume e tPersistentVolumeClaim (PVC) continuent de fonctionner tant que le pilote CSI correspondant est installé. Lorsque la fonctionnalité est activée :

  • Les charges de travail existantes utilisées PVCs continuent de fonctionner comme elles l'ont toujours fait.

  • Kubernetes transmet le contrôle de toutes les opérations de gestion du stockage aux pilotes CSI.

Pour plus d'informations, consultez Kubernetes1.23 : Mise à jour du statut de migration des volumes Kubernetes In-Tree vers CSI sur le Kubernetes blogue.

Pour vous aider à migrer du plug-in intégré à l'arborescence vers les pilotes CSI, les drapeaux CSIMigration et CSIMigration AWS sont activés par défaut sur la version 1.23 d'Amazon EKS et les clusters de versions ultérieures. Ces indicateurs permettent à votre cluster de traduire l'arborescence APIs en son équivalent APIs CSI. Ces drapeaux sont placés sur le Kubernetes plan de contrôle géré par Amazon EKS et dans les kubelet paramètres configurés dans Amazon EKS optimisés AMIs. Si vous avez Pods si vous utilisez des volumes Amazon EBS dans votre cluster, vous devez installer le pilote Amazon EBS CSI avant de mettre à jour la version de votre cluster. 1.23 Dans le cas contraire, les opérations de volume telles que le provisionnement et le montage risquent de ne pas fonctionner comme prévu. Pour de plus amples informations, veuillez consulter Stockage Kubernetes volumes avec Amazon EBS.

Note

Le fournisseur de StorageClass dans l'arborescence est nommé kubernetes.io/aws-ebs. Le fournisseur Amazon EBS CSI StorageClass est nommé ebs.csi.aws.com.

Puis-je monter les volumes kubernetes.io/aws-ebs StorageClass dans la version 1.23 et les versions ultérieures des clusters ?

Oui, tant que le Pilote CSI Amazon EBS est installé. Pour une nouvelle version 1.23 et pour les versions ultérieures de clusters, nous vous recommandons d'installer le pilote Amazon EBS CSI dans le cadre de votre processus de création de cluster. Nous recommandons également d'utiliser uniquement StorageClasses basé sur le kit du fournisseur ebs.csi.aws.com.

Si vous avez mis à jour la version de votre plan de contrôle de cluster 1.23 et que vous n'avez pas encore mis à jour vos nœuds1.23, les indicateurs CSIMigration et CSIMigration AWS kubelet ne sont pas activés. Dans ce cas, le pilote intégré à l'arborescence est utilisé pour monter les volumes basés sur kubernetes.io/aws-ebs. Le pilote Amazon EBS CSI doit cependant toujours être installé pour garantir que Pods l'utilisation de volumes kubernetes.io/aws-ebs basés peut être planifiée. Le pilote est également requis pour garantir le succès des autres opérations de volume.

Puis-je provisionner les volumes kubernetes.io/aws-ebs StorageClass sur Amazon EKS 1.23 et sur les versions ultérieures des clusters ?

Oui, tant que le Pilote CSI Amazon EBS est installé.

Le fournisseur kubernetes.io/aws-ebs StorageClass a-t-il déjà été supprimé d'Amazon EKS ?

Le fournisseur kubernetes.io/aws-ebs StorageClass et le type de volume awsElasticBlockStore ne sont plus pris en charge. Toutefois, il n'est pas prévu de les supprimer. Ces ressources sont traitées comme faisant partie du Kubernetes API.

Comment puis-je installer le pilote CSI Amazon EBS ?

Nous vous recommandons d’installer le module complémentaire Amazon EKS du pilote CSI Amazon EBS. Lorsqu'une mise à jour est requise pour le module complémentaire Amazon EKS, vous devez lancer la mise à jour, puis Amazon EKS mettra à jour le module complémentaire Amazon EKS à votre place. Si vous souhaitez gérer le pilote vous-même, vous pouvez l'installer en utilisant l'open source les charts de Helm.

Important

Le Kubernetes le pilote Amazon EBS intégré s'exécute sur Kubernetes plan de contrôle. Il utilise les autorisations IAM attribuées au rôle IAM du cluster Amazon EKS pour approvisionner les volumes Amazon EBS. Le pilote CSI Amazon EBS s'exécute sur des nœuds. Le pilote requière les autorisations IAM pour provisionner des volumes. Pour de plus amples informations, veuillez consulter Étape 1 : Créer un rôle IAM.

Comment puis-je vérifier si le pilote Amazon EBS CSI est installé dans mon cluster ?

Pour déterminer si le pilote est installé sur votre cluster, exécutez la commande suivante :

kubectl get csidriver ebs.csi.aws.com

Pour vérifier si cette installation est gérée par Amazon EKS, exécutez la commande suivante :

aws eks list-addons --cluster-name my-cluster

Amazon EKS empêchera-t-il la mise à jour de la version du cluster 1.23 si je n'ai pas encore installé le pilote Amazon EBS CSI ?

Non.

Que se passe-t-il si j'oublie d'installer le pilote Amazon EBS CSI avant de mettre à jour mon cluster vers la version 1.23 ? Puis-je installer le pilote après avoir mis à jour mon cluster ?

Oui, mais les opérations de volume nécessitant le pilote Amazon EBS CSI échoueront après la mise à jour de votre cluster jusqu'à ce que le pilote soit installé.

Qu'est-ce que le StorageClass par défaut appliqué dans la nouvelle version d'Amazon EKS 1.23 et les versions ultérieures des clusters ?

La valeur par défaut du comportement de StorageClass reste inchangée. À chaque nouveau cluster, Amazon EKS applique un kubernetes.io/aws-ebs basé sur StorageClass nommégp2. Nous n'avons pas l'intention StorageClass de le supprimer des clusters nouvellement créés. Séparé du cluster StorageClass par défaut, si vous créez un StorageClass basé sur ebs.csi.aws.com sans spécifier de type de volume, le pilote Amazon EBS CSI utilisera gp3 par défaut.

Amazon EKS apportera-t-il des modifications à StorageClasses déjà présent dans mon cluster existant lorsque je mets à jour mon cluster vers la version 1.23 ?

Non.

Comment puis-je migrer un volume persistant à partir du kubernetes.io/aws-ebsStorageClass pour ebs.csi.aws.comà l'aide des instantanés ?

Pour migrer un volume persistant, consultez la section Migration de clusters Amazon EKS de volumes EBS gp2 vers gp3 sur le blog. AWS

Comment puis-je modifier un volume Amazon EBS à l'aide d'annotations ?

Dans un premier aws-ebs-csi-driver v1.19.0-eksbuild.2 temps, vous pouvez modifier les volumes Amazon EBS à l'aide d'annotations intégrées à chaque volume PersistentVolumeClaim (PVC). La nouvelle fonctionnalité de modification du volume est implémentée sous la forme d'un sidecar supplémentaire, appelé volumemodifier. Pour plus d'informations, consultez Simplifier la migration et la modification des volumes Amazon EBS sur Kubernetes à l'aide du pilote EBS CSI sur le blog. AWS

La migration est-elle prise en charge pour les charges de travail Windows ?

Oui. Si vous installez le pilote Amazon EBS CSI à l'aide du graphique Helm open source, node.enableWindows réglez-le sur. true Ce paramètre est défini par défaut dans le cas d'une installation du pilote Amazon EBS CSI en tant que module complémentaire. Lors de la création de StorageClasses, définissez le fsType vers un système de fichiers Windows, tel quentfs. Les opérations de volume pour les charges de travail Windows sont ensuite migrées vers le pilote Amazon EBS CSI de la même manière que pour les charges de travail Linux.