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.
Ausführen einer Transformation in der Befehlszeile mit Amazon Q Developer
Gehen Sie wie folgt vor, um Ihren Code in der Befehlszeile mit dem Befehlszeilentool Amazon Q Developer zu transformieren.
Voraussetzungen
Bevor Sie mit einer Transformation in der Befehlszeile beginnen, müssen die folgenden Voraussetzungen erfüllt sein:
-
Wenn Sie Ihre Java-Code-Version aktualisieren, erfüllt Ihr Projekt die Voraussetzungen für ein Upgrade von Java-Versionen mit Amazon Q.
-
Wenn Sie Embedded SQL in eine Java-Anwendung konvertieren, erfüllt Ihre Anwendung die Voraussetzungen für die Konvertierung von Embedded SQL mit Amazon Q.
-
Sie haben Python in Ihrer Befehlszeilenumgebung installiert. So installieren Sie das Befehlszeilentool. Die unterstützte Python-Mindestversion ist 3.12.
-
Sie führen die Transformation auf macOS oder Linux aus.
-
Die Größe Ihrer Anwendung beträgt 2 GB oder weniger.
-
Wenn Sie bestimmte Abhängigkeiten haben, für die Amazon Q ein Upgrade durchführen soll, haben Sie eine Upgrade-Datei für Abhängigkeiten konfiguriert.
Schritt 1: Wählen Sie die Authentifizierungsmethode und fügen Sie Berechtigungen hinzu
Sie können IAM Identity Center authentifizieren, um Transformationen in der Befehlszeile auszuführen. Stellen Sie sicher, dass Sie über die richtigen Berechtigungen verfügen.
Anmerkung
Vom Kunden verwaltete Schlüssel werden für Transformationen, die über die Befehlszeile ausgeführt werden, nicht unterstützt.
Berechtigungen hinzufügen
Die IAM-Identität, die entweder dem AWS CLI Profil oder dem Amazon Q Developer-Abonnement zugeordnet ist, das Sie zur Authentifizierung verwenden, muss über Berechtigungen verfügen, um Transformationen in der Befehlszeile durchzuführen. Bevor Sie fortfahren, stellen Sie sicher, dass Ihre IAM-Identität über die in definierten Berechtigungen verfügt. Erlauben Sie Benutzern, Transformationen in der Befehlszeile auszuführen
Authentifizieren Sie sich bei IAM Identity Center über ein Amazon Q Developer-Abonnement
Um sich bei IAM Identity Center zu authentifizieren, müssen Sie von Ihrem Administrator Amazon Q Developer Pro als Workforce-Benutzer abonniert haben und Sie müssen die Start-URL angeben, um sich über Ihr Abonnement zu authentifizieren. Sie oder Ihr Administrator finden die Start-URL in der Amazon Q Developer Console. Weitere Informationen finden Sie unter Finden der Start-URL für die Verwendung mit Amazon Q Developer.
Informationen zum Hinzufügen der erforderlichen Berechtigungen finden Sie unterBerechtigungen hinzufügen.
Sie geben die Start-URL in einSchritt 4: Konfiguration und Authentifizierung.
Schritt 2: Installieren Sie das Tool
-
Laden Sie das Amazon Q-Befehlszeilentool für Transformationen
herunter. Informationen zum Herunterladen einer früheren Version des Befehlszeilentools finden Sie unterVersionshistorie.
-
Wir empfehlen, dass Sie eine virtuelle Umgebung in Python einrichten, um das Tool zu installieren. Um eine virtuelle Umgebung zu erstellen, öffnen Sie ein Terminalfenster und führen Sie Folgendes aus:
python -m venv qct-cli
-
Um die virtuelle Umgebung zu aktivieren, führen Sie Folgendes aus:
source qct-cli/bin/activate
-
Um das Tool in Ihrer Befehlszeile zu installieren, führen Sie folgenden Befehl aus:
pip install amzn_qct_cli-1.0.0-py3-none-any.whl
Anmerkung
Wenn Sie eine ältere Version des Befehlszeilentools für Transformationen verwenden,
1.0.0
ersetzen Sie es durch die Version, die Sie heruntergeladen haben. -
Führen Sie folgenden Befehl aus, um zu überprüfen, ob das Tool installiert wurde:
which qct
Schritt 3: Erstellen Sie eine Abhängigkeitsupgrade-Datei (optional)
Sie können Amazon Q eine Abhängigkeits-Upgrade-Datei zur Verfügung stellen, eine YAML-Datei, in der die Abhängigkeiten Ihres Projekts und die Versionen aufgeführt sind, auf die während einer Transformation aktualisiert werden soll. Durch die Bereitstellung einer Abhängigkeits-Upgrade-Datei können Sie Abhängigkeiten von Drittanbietern und Erstanbietern angeben, von denen Amazon Q sonst möglicherweise nicht weiß, dass sie aktualisiert werden sollen.
Abhängigkeiten von Erstanbietern beziehen sich auf die Bibliotheken, Plugins und Frameworks, die Ihre Organisation verwaltet und die nur lokal oder im privaten Netzwerk Ihrer Organisation verfügbar sind. Amazon Q kann auf Ihre Erstanbieter-Abhängigkeiten zugreifen, wenn es Builds in Ihrer lokalen Umgebung ausführt. Weitere Informationen finden Sie unter Baucode in Ihrer lokalen Umgebung. Bei Abhängigkeiten von Drittanbietern handelt es sich um öffentlich verfügbare oder Open-Source-Abhängigkeiten, die nicht nur für Ihr Unternehmen gelten.
Sie können Abhängigkeiten von Erstanbietern, die Sie aktualisieren möchten, in einer YAML-Datei angeben, und Amazon Q aktualisiert sie während des JDK-Upgrades (z. B. Java 8 auf 17). Sie können nach dem ersten JDK-Upgrade eine separate Transformation (17 bis 17 oder 21 bis 21) initiieren, um Abhängigkeiten von Drittanbietern zu aktualisieren.
Sobald Amazon Q mindestens ein JDK-Upgrade durchgeführt hat, können Sie eine separate Transformation einleiten, um alle Abhängigkeiten von Drittanbietern zu aktualisieren. Alternativ können Sie Abhängigkeiten von Drittanbietern und deren Versionen in einer YAML-Datei angeben, um nur diese Abhängigkeiten während der Transformation des Bibliotheks-Upgrades zu aktualisieren.
Amazon Q fordert Sie während der Transformation auf, eine Upgrade-Datei für Abhängigkeiten bereitzustellen. Wenn Sie eine bereitstellen möchten, stellen Sie zunächst sicher, dass Sie die Datei richtig konfiguriert haben. Die folgenden Felder sind in der YAML-Datei erforderlich:
-
name — Der Name der Abhängigkeitsupgrade-Datei.
-
description (optional) — Eine Beschreibung der Abhängigkeitsupgrade-Datei und für welche Transformation.
-
dependencyManagement — Enthält die Liste der Abhängigkeiten und Plugins, die aktualisiert werden sollen.
-
dependencies — Enthält den Namen und die Version der zu aktualisierenden Bibliotheken.
-
plugins — Enthält die Namen und Versionen der zu aktualisierenden Plugins.
-
Identifier — Der Name der Bibliothek, des Plugins oder einer anderen Abhängigkeit.
-
targetVersion — Die Version der Abhängigkeit, auf die ein Upgrade durchgeführt werden soll.
-
versionProperty (optional) — Die Version der Abhängigkeit, die Sie definieren, wie sie mit
properties
dem Tag in der Datei Ihrer Anwendung festgelegt istpom.xml
. -
originType — Gibt an, ob es sich bei der Abhängigkeit um eine erste oder eine Drittanbieterabhängigkeit handelt, angegeben durch FIRST_PARTY oder THIRD_PARTY.
Im Folgenden finden Sie ein Beispiel für eine YAML-Datei für ein Abhängigkeitsupgrade und die erforderliche Konfiguration, die Amazon Q analysieren muss:
name: dependency-upgrade description: "Custom dependency version management for Java migration from JDK 8/11/17 to JDK 17/21" dependencyManagement: dependencies: - identifier: "com.example:library1" targetVersion: "2.1.0" versionProperty: "library1.version" # Optional originType: "FIRST_PARTY" - identifier: "com.example:library2" targetVersion: "3.0.0" originType: "THIRD_PARTY" plugins: - identifier: "com.example.plugin" targetVersion: "1.2.0" versionProperty: "plugin.version" # Optional originType: "THIRD_PARTY"
Schritt 4: Konfiguration und Authentifizierung
Bevor Sie mit der Transformation beginnen können, müssen Sie sich bei der authentifizieren AWS CLI und die Konfigurationsdetails für Ihre Transformation angeben.
-
Wenn Sie sich mit IAM authentifizieren und das noch nicht konfiguriert haben, führen Sie den folgenden Befehl aus AWS CLI, um Authentifizierungsdetails anzugeben.
aws configure
-
Führen Sie den folgenden Befehl aus, um den Transformationskonfigurationsprozess zu starten:
qct configure
-
Zunächst wird Ihre Maven-Version verifiziert. Wenn Sie mindestens die unterstützte Mindestversion haben, wird die folgende Ausgabe angezeigt:
Running command: mvn --version at: path/to/current/directory Your Maven version is supported for transformations.
Wenn Sie keine unterstützte Version von Maven haben, müssen Sie diese aktualisieren, um fortzufahren. Weitere Informationen hierzu finden Sie unter Voraussetzungen.
-
Sie werden dann aufgefordert, einen JDK-Pfad für jede unterstützte Java-Version einzugeben. Sie müssen nur den Pfad zum JDK der Java-Version angeben, die Sie aktualisieren.
-
Als Nächstes werden Sie aufgefordert, Ihre Authentifizierungsmethode auszuwählen.
-
Um sich mit den in Ihrem AWS CLI Profil gespeicherten IAM-Anmeldeinformationen zu authentifizieren, geben Sie ein.
1
Sie können einen bestimmten Profilnamen angeben oder die Eingabetaste drücken, um das Standardprofil zu verwenden.Wenn Sie Ihrer Transformation Tags hinzufügen möchten, können Sie eine CSV-Datei bereitstellen, in der Ihre Tags gespeichert werden. Die CSV-Datei muss zwei Spalten mit Überschriften mit den Bezeichnungen Schlüssel und Wert enthalten, in denen Tag-Schlüssel-Wert-Paare aufgeführt sind. Um diese Tags zu Ihrer Transformation hinzuzufügen, geben Sie den Pfad zur CSV-Datei ein, in der die Tags gespeichert sind.
-
Um sich über Ihr Amazon Q Developer-Abonnement bei IAM Identity Center zu authentifizieren
2
, geben Sie die Start-URL für Ihr Abonnementprofil ein und geben Sie sie dann ein.Geben Sie als Nächstes den Ort, AWS-Region an dem Sie abonniert wurden, im folgenden Format ein:.
us-east-1
Eine Liste der unterstützten -Regionen finden Sie unter Unterstützte Regionen. Eine Liste der Regionscodes finden Sie im Handbuch unter Regionale Endpunkte.Allgemeine AWS-Referenz
-
-
Wenn Sie die Java Version Ihres Codes aktualisieren, haben Sie die Möglichkeit, Ihre Codevorschläge von Amazon Q in einem Commit oder mehreren Commits zu erhalten. Amazon Q teilt den aktualisierten Code standardmäßig in mehrere Commits auf. Wenn Sie möchten, dass alle Ihre Codeänderungen in einem Commit erscheinen, geben Sie den Buchstaben „O“ für einen Commit ein, wenn Sie dazu aufgefordert werden.
Weitere Informationen darüber, wie Amazon Q die Codeänderungen aufteilt, finden Sie unterÜberprüfung der Transformationszusammenfassung und Annahme von Änderungen.
-
Ihre Konfigurationseinstellungen werden in einer Datei configuration.ini gespeichert.
Schritt 5: Führen Sie eine Transformation durch
Wählen Sie die Art der Transformation, die Sie durchführen, um die erforderliche Konfiguration und Befehle zu sehen.
Anmerkung
Schalten Sie Ihren lokalen Computer während der Codetransformation nicht aus oder schließen Sie ihn nicht, da für den clientseitigen Build eine stabile Netzwerkverbindung erforderlich ist.