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.
Guide de migration pour la AWS CLI version 2
Cette section contient des instructions pour mettre à jour la AWS CLI version 1 vers AWS CLI la version 2. La AWS CLI version 2 s'appuie sur la AWS CLI version 1 et inclut des fonctionnalités et des améliorations basées sur les commentaires de la communauté. La AWS CLI version 2 est la version majeure la plus récente AWS CLI et prend en charge toutes les dernières fonctionnalités. Certaines fonctionnalités introduites dans la version 2 ne sont pas rétrocompatibles avec la version 1, et vous devez effectuer une mise à niveau pour accéder à celles-ci.
Pour éviter des problèmes inattendus, découvrez les différences entre les versions avant de migrer vers la version 2. La AWS CLI version 2 inclut de nouvelles fonctionnalités et des modifications qui peuvent vous obliger à mettre à jour vos scripts ou commandes pour des raisons de rétrocompatibilité.
AWS CLI les versions 1 et 2 utilisent le même nom de aws commande. Si les deux versions sont installées, votre ordinateur utilise la première indiquée dans votre chemin de recherche. Cela peut entraîner l'appel de votre ancienne AWS CLI version par le nom de votre aws commande, même si la nouvelle est installée.
Pour passer à la AWS CLI version 2, suivez l'une des instructions ci-dessous :
-
Si vous avez déjà installé AWS CLI la version 1, suivez les instructions figurant dansInstallation de AWS CLI la version 2 à partir de AWS CLI la version 1.
-
Si vous n'avez pas encore installé AWS CLI la version 1, suivez les instructions figurant dansMise en route avec l’AWS CLI.
Utilisation des outils de migration de la AWS CLI pour atténuer les ruptures
Des changements de comportement entre la version 1 de la AWS CLI et la version 2 de la AWS CLI peuvent nécessiter la mise à jour de vos scripts ou de vos commandes. La mise à niveau vers la version 2 de la AWS CLI sans vérifier que vos scripts existants ont été migrés en toute sécurité risque de provoquer des effets inattendus lors de l'exécution des scripts avec la version 2 de la AWS CLI, tels que des modifications involontaires des ressources de vos AWS comptes.
Il existe deux outils AWS propres que vous pouvez utiliser pour guider votre migration. Quel que soit l'outil que vous utilisez, nous vous recommandons de le référencer Changements majeurs entre AWS CLI la version 1 et AWS CLI la version 2 dans le Nouvelles fonctionnalités et modifications de la AWS CLI version 2 guide.
Mettre à niveau le mode de débogage
Le mode de débogage de mise à niveau est une fonctionnalité de la version 1 de la AWS CLI disponible dans les versions 1.44.0 et supérieures. Lorsque cette fonctionnalité est activée, chaque commande AWS CLI que vous exécutez est vérifiée pour déterminer si elle est susceptible d'avoir un comportement différent dans la version 2 de la AWS CLI, en supposant que l'environnement d'exécution reste le même. Si une commande exécutée aurait un comportement différent dans la version 2 de la AWS CLI, un avertissement sera affiché à côté de la sortie de la commande avec des suggestions d'actions pouvant être entreprises pour préserver le comportement de la AWS CLI version 1 dans la version 2 de la AWS CLI.
La principale raison d'utiliser le mode de mise à niveau pour guider votre migration est qu'il permet de détecter si les commandes sont susceptibles de changer de comportement. 14 des 15 modifications majeures décrites dans Changements majeurs entre AWS CLI la version 1 et AWS CLI la version 2 peuvent être détectées avec le mode de débogage de mise à niveau. Consultez la section Utilisation du mode de mise à niveau et de débogage pour mettre à niveau la version 1 de la AWS CLI vers la version 2 de la AWS CLI pour connaître Limitations les limites de cette fonctionnalité. D'autre part, le principal inconvénient de l'utilisation du mode de débogage de mise à niveau est que sa sortie n'est pertinente que dans son environnement d'exécution ; si des paramètres de configuration de la AWS CLI changent dans l'environnement après la migration vers la version 2 de la AWS CLI, des modifications importantes peuvent toujours se produire, et vous devez vérifier à nouveau en utilisant le mode de débogage de mise à niveau dans l'environnement mis à jour.
AWS Outil de migration de CLI v1-v2
L'outil de migration AWS CLI v1-v2 est un outil autonome qui peut être utilisé avec Python 3.9 et versions ultérieures. Cet outil est un linter statique qui s'exécute indépendamment de la AWS CLI. Il contient des scripts bash contenant des commandes de la version 1 de la AWS CLI qui peuvent avoir un comportement différent dans la version 2 de la AWS CLI. Pour la plupart des commandes qu'il détecte comme susceptibles d'avoir un comportement différent dans la version 2 de la AWS CLI, il peut automatiquement mettre à jour la commande dans le script afin de préserver le comportement de la version 1 de la AWS CLI dans la version 2 de la AWS CLI.
La principale raison d'utiliser l'outil de migration de la AWS CLI v1-v2 pour guider votre migration est qu'il peut automatiquement mettre à jour vos scripts afin de préserver le comportement de la version 1 de la AWS CLI dans la version 2 de la AWS CLI, ce qui vous permet d'économiser du temps et des efforts lorsque vous effectuez vous-même les mises à jour. D'un autre côté, le principal inconvénient de l'utilisation de l'outil de migration est qu'il offre une couverture plus faible pour détecter si les commandes seront confrontées à un changement de comportement. En tant qu'outil statique, il ne vérifie pas les changements de comportement déterminés lors de l'exécution.
Choix entre le mode de mise à niveau et l'outil de migration v1-v2 de la AWS CLI
Le tableau suivant met en évidence les principales différences entre le mode de mise à niveau et l'outil de migration de la AWS CLI v1-v2, et peut être utilisé pour vous aider à choisir l'outil adapté à votre cas d'utilisation.
| Mettre à niveau le mode de débogage | AWS Outil de migration de CLI v1-v2 |
|---|---|
| Détecte 14 des 15 modifications majeures entre la version 1 de la AWS CLI et la version 2 de la AWS CLI. | Détecte 7 des 15 modifications majeures entre la version 1 de la AWS CLI et la version 2 de la AWS CLI. |
| Compatible avec n'importe quel programme de terminal capable d'exécuter la AWS CLI. | Supporte uniquement les scripts bash linting. |
Nécessite la version 1 de la AWS CLI, version 1.44.0 ou supérieure. |
S'exécute indépendamment de la AWS CLI ; elle ne nécessite pas l'installation de la AWS CLI. |
| Des corrections manuelles doivent être apportées pour préserver le comportement de la version 1 de la AWS AWS CLI dans la version 2 de la CLI. | Corrige automatiquement la plupart des commandes de la version 1 de la AWS CLI qu'il détecte comme susceptibles d'avoir un comportement différent dans la version 2 de la AWS CLI. |
| Les détections et les corrections suggérées ne concernent que l'environnement d'exécution (c'est-à-dire la configuration de la AWS CLI) dans lequel elles sont exécutées. | Les détections et les solutions proposées sont indépendantes de l'environnement. |
| Nécessite l'exécution de chaque commande AWS CLI testée pour le changement de comportement. | Ne nécessite pas l'exécution de commandes AWS CLI. Ne doit être exécuté qu'une seule fois par script bash. |
| Possède exactement 5 cas connus où il produira des détections faussement positives. | Possède exactement 3 cas connus où il produira des détections faussement positives. |
Le tableau suivant indique ceux qui Changements majeurs entre AWS CLI la version 1 et AWS CLI la version 2 sont pris en charge dans chacun des deux outils de migration.
Rubriques supplémentaires de cette section
