Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Migrationsleitfaden für die AWS CLI Version 2

Dieser Abschnitt enthält Anweisungen zum Aktualisieren AWS CLI von Version 1 auf AWS CLI Version 2. Die AWS CLI Version 2 baut auf AWS CLI Version 1 auf und enthält Funktionen und Verbesserungen, die auf dem Feedback der Community basieren. Die AWS CLI Version 2 ist die neueste Hauptversion von AWS CLI und unterstützt alle aktuellen Funktionen. Einige in Version 2 eingeführte Features werden nicht auf Version 1 zurückportiert und Sie müssen ein Upgrade durchführen, um auf diese Features zugreifen zu können.

Um unerwartete Probleme zu vermeiden, sollten Sie sich vor der Migration auf die Version 2 über die Unterschiede zwischen den Versionen informieren. Die AWS CLI Version 2 enthält neue Funktionen und Änderungen, für die Sie möglicherweise Ihre Skripts oder Befehle aktualisieren müssen, um die Abwärtskompatibilität zu gewährleisten.

AWS CLI Die Versionen 1 und 2 verwenden denselben aws Befehlsnamen. Wenn beide Versionen installiert sind, verwendet der Computer die erste im Suchpfad gefundene Version. Dies könnte dazu führen, dass Ihr aws Befehlsname Ihre alte AWS CLI Version aufruft, auch wenn Sie die neue installiert haben.

Um auf AWS CLI Version 2 zu aktualisieren, folgen Sie einer der folgenden Anweisungen:

Verwendung von AWS CLI-Migrationstools zur Minimierung von Sicherheitslücken

Es gibt Verhaltensänderungen zwischen AWS CLI-Version 1 und AWS CLI-Version 2, sodass Sie möglicherweise Ihre Skripts oder Befehle aktualisieren müssen. Wenn Sie auf AWS CLI-Version 2 aktualisieren, ohne zu überprüfen, ob Ihre vorhandenen Skripts sicher migriert wurden, besteht die Gefahr, dass beim Ausführen der Skripts mit AWS CLI-Version 2 unerwartete Auswirkungen auftreten, z. B. unbeabsichtigte Änderungen an den Ressourcen in Ihren Konten. AWS

Es gibt zwei AWS eigene Tools, mit denen Sie Ihre Migration steuern können. Unabhängig davon, welches Tool Sie verwenden, empfehlen wir, dass Sie Wichtigste Änderungen zwischen AWS CLI Version 1 und AWS CLI Version 2 im Neue Funktionen und Änderungen in der AWS CLI Version 2 Leitfaden darauf verweisen.

Aktualisieren Sie den Debug-Modus

Der Upgrade-Debug-Modus ist eine Funktion in AWS CLI Version 1, die in Versionen 1.44.0 und höher verfügbar ist. Wenn diese Funktion aktiviert ist, wird jeder AWS CLI-Befehl, den Sie ausführen, daraufhin überprüft, ob er in AWS CLI-Version 2 wahrscheinlich ein anderes Verhalten aufweist, vorausgesetzt, die Ausführungsumgebung bleibt dieselbe. Wenn ein ausgeführter Befehl in AWS CLI Version 2 ein anderes Verhalten haben würde, wird neben der Befehlsausgabe eine Warnung mit vorgeschlagenen Maßnahmen angezeigt, die ergriffen werden können, um das Verhalten von AWS CLI Version 1 in AWS CLI Version 2 beizubehalten.

Der Hauptgrund, warum Sie den Upgrade-Debug-Modus als Leitfaden für Ihre Migration verwenden sollten, besteht darin, dass er eine hohe Abdeckung bietet, um zu erkennen, ob Befehle zu Verhaltensänderungen führen. 14 der 15 wichtigsten Änderungen, die unter beschrieben sind, Wichtigste Änderungen zwischen AWS CLI Version 1 und AWS CLI Version 2 können im Upgrade-Debug-Modus erkannt werden — die Einschränkungen dieser Funktion finden Sie unterEinschränkungen. Verwenden des Upgrade-Debug-Modus zum Upgrade von AWS CLI Version 1 auf AWS CLI Version 2 Andererseits besteht der Hauptnachteil der Verwendung des Upgrade-Debug-Modus darin, dass seine Ausgabe nur innerhalb der Ausführungsumgebung relevant ist. Wenn sich nach der Migration auf CLI-Version 2 irgendwelche AWS CLI-Konfigurationseinstellungen in der Umgebung ändern, können dennoch wichtige Änderungen auftreten, und Sie sollten dies erneut überprüfen, indem Sie den Upgrade-Debug-Modus in der aktualisierten Umgebung verwenden. AWS

AWS CLI v1-zu-V2-Migrationstool

Das AWS CLI v1-to-v2 Migration Tool ist ein eigenständiges Tool, das mit Python 3.9 und höher verwendet werden kann. Dieses Tool ist ein statischer Linter, der unabhängig von der AWS CLI ausgeführt wird. Es lintet Bash-Skripte, die AWS CLI-Befehle der Version 1 enthalten, die sich in AWS CLI-Version 2 möglicherweise anders verhalten. Für die meisten Befehle, bei denen festgestellt wird, dass sie in AWS CLI Version 2 wahrscheinlich ein anderes Verhalten haben, kann es den Befehl innerhalb des Skripts automatisch aktualisieren, um das Verhalten von AWS CLI Version 1 in AWS CLI Version 2 beizubehalten.

Der Hauptgrund für die Verwendung des AWS CLI v1-to-v2-Migrationstools zur Steuerung Ihrer Migration besteht darin, dass es Ihre Skripts automatisch aktualisieren kann, um das Verhalten von AWS CLI-Version 1 in AWS CLI-Version 2 beizubehalten, sodass Sie Zeit und Mühe sparen, die Aktualisierungen selbst vorzunehmen. Andererseits besteht der Hauptnachteil der Verwendung des Migrationstools darin, dass es eine geringere Reichweite hat, um zu erkennen, ob Befehle einer Verhaltensänderung ausgesetzt sind. Da es sich um ein statisches Tool handelt, sucht es nicht nach Verhaltensänderungen, die zur Laufzeit bestimmt werden.

Wählen Sie zwischen dem Upgrade-Debug-Modus und dem AWS CLI v1-to-v2-Migrationstool

In der folgenden Tabelle werden die Hauptunterschiede zwischen dem Upgrade-Debug-Modus und dem AWS CLI v1-to-v2-Migrationstool hervorgehoben. Sie kann Ihnen bei der Auswahl des richtigen Tools für Ihren Anwendungsfall helfen.

Die folgende Tabelle zeigt, welche von den beiden Migrationstools unterstützt Wichtigste Änderungen zwischen AWS CLI Version 1 und AWS CLI Version 2 werden.

Weitere Themen in diesem Abschnitt