Ausführen einer Transformation in der Befehlszeile mit Amazon Q Developer - Amazon Q Developer
VoraussetzungenSchritt 1: Wählen Sie die Authentifizierungsmethode und fügen Sie Berechtigungen hinzuSchritt 2: Installieren Sie das ToolSchritt 3: Erstellen Sie eine Abhängigkeitsupgrade-Datei (optional)Schritt 4: Konfiguration und AuthentifizierungSchritt 5: Führen Sie eine Transformation durch

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:

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

  1. Laden Sie das Amazon Q-Befehlszeilentool für Transformationen herunter.

    Informationen zum Herunterladen einer früheren Version des Befehlszeilentools finden Sie unterVersionshistorie.

  2. 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

  3. Um die virtuelle Umgebung zu aktivieren, führen Sie Folgendes aus: 

    source qct-cli/bin/activate

  4. 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.

  5. 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.

  1. 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

  2. Führen Sie den folgenden Befehl aus, um den Transformationskonfigurationsprozess zu starten:

    qct configure

  3. 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.

  4. 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.

  5. Als Nächstes werden Sie aufgefordert, Ihre Authentifizierungsmethode auszuwählen.

    1. 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.

    2. Um sich über Ihr Amazon Q Developer-Abonnement bei IAM Identity Center zu authentifizieren2, 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

  6. 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.

  7. 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.

Java upgrade

Den Transformationsplan ändern

Bei Upgrades der Java-Version generiert Amazon Q einen Transformationsplan, den Sie vor Beginn der Transformation überprüfen können. Sie haben die Möglichkeit, die folgenden Änderungen am Plan zu beantragen:

  • Welche Bibliotheken Amazon Q aktualisiert, aus der Liste, die im Plan enthalten ist

    • Beispiel-Eingabeaufforderungen:

      • Nur upgraden <dependency1><dependency2>, und <dependency5>

      • Führen Sie kein Upgrade durch <dependency1>oder <dependency2>

  • Die Zielversion, auf die eine Bibliothek aktualisiert werden soll

    • Beispiel-Eingabeaufforderungen:

      • Führen Sie stattdessen ein <dependency>Upgrade auf diese Version durch <version>

  • Welche Schritte Amazon Q ausführen sollte

    • Beispiel-Eingabeaufforderungen:

      • Führen Sie nur die Schritte 1 bis 7 aus

      • Führen Sie die Schritte 5-9 nicht aus

  • Fügen Sie zusätzliche Abhängigkeiten für das Upgrade hinzu (nur eine Option beim Upgrade auf eine neuere JDK-Version)

    • Beispiel-Eingabeaufforderungen:

      • <dependency1>Führen Sie auch ein Upgrade auf <version2>

Aktualisieren Sie den Java-Code

  1. Führen Sie den folgenden Befehl aus, um eine Transformation für ein Java-Upgrade zu starten. Ersetzen Sie <path-to-folder> es durch den Pfad zu dem Ordner mit dem Code, den Sie transformieren, und <your-target-java-version> durch entweder JAVA_17 oderJAVA_21.

    qct transform --source_folder <path-to-folder>
    --target_version <your-target-java-version>

    Zusätzliche Befehlsoptionen:

    • Wenn Sie Abhängigkeiten für das Upgrade angeben, fügen Sie die --dependency_upgrade_file Option mit dem Pfad zu Ihrer Abhängigkeitsupgrade-Datei hinzu.

    • Wenn Sie den Transformationsplan nicht überprüfen oder aktualisieren möchten, fügen Sie Ihrem Befehl das --no-interactive Kennzeichen hinzu. Amazon Q wird Sie nicht um Feedback zum Plan bitten, und Sie haben auch nicht die Möglichkeit, Änderungen zu beantragen.

  2. Wenn Sie die --no-interactive Markierung nicht hinzugefügt haben, werden Sie von Amazon Q aufgefordert, Feedback zum Transformationsplan zu geben. Sie können die Änderungen, die Sie vornehmen möchten, in englischer Sprache erläutern, und Amazon Q aktualisiert den Plan, sofern er die von Ihnen angeforderten Änderungen unterstützt.

  3. Amazon Q beginnt mit der Transformation. Es wird während der gesamten Transformation Status-Updates ausgeben. Wenn der Vorgang abgeschlossen ist, gibt Amazon Q den Pfad an, in dem die Transformationsergebnisse, Protokolle und Konfigurationsdateien ausgegeben werden.

    Ihr aktualisierter Code wird der neuen Filiale zugewiesen, die Amazon Q erstellt hat. Amazon Q überträgt den Code in einem oder mehreren Commits, je nachdem, welche Auswahl Sie bei der Ausführung getroffen haben. qct configure

  4. Wenn Sie nach dem Upgrade Ihrer Java-Version eine weitere Transformation ausführen, starten Sie die zweite Transformation in derselben Filiale, in der Sie die Änderungen aus der ersten Transformation übernommen haben.

SQL conversion

Bevor Sie beginnen, stellen Sie sicher, dass Sie die Voraussetzungen für diese Art von Transformation gelesen haben, Konvertieren von Embedded SQL in Java-Anwendungen mit Amazon Q Developer um sie zu verstehen.

  1. Um Embedded SQL zu konvertieren, müssen Sie zunächst eine YAML-Datei erstellen, die den Pfad zur Schema-Metadatendatei aus Ihrer AWS DMS Schemakonvertierung enthält.

    Im Folgenden ist das erforderliche Format der Datei aufgeführt: 

    schema_conv_metadata_path: <path-to-metadata-zip-file>

  2. Führen Sie den folgenden Befehl aus, um eine Transformation für eine SQL-Konvertierung zu starten. Ersetzen <path-to-folder> Sie durch den Pfad zu dem Ordner mit dem Code, den Sie transformieren, und <path-to-sql-config-file> durch den Pfad zu der YAML-Datei, die Sie in Schritt 1 erstellt haben.

    qct transform --source_folder <path-to-folder>
    --sql_conversion_config_file <path-to-sql-config-file>

  3. Wenn Amazon Q mehrere Schemas in Ihrer Schema-Metadatendatei findet, wird die Transformation gestoppt und eine Liste der erkannten Schemas bereitgestellt. Wählen Sie aus, welches Schema für die SQL-Konvertierung verwendet werden soll, und fügen Sie dann der YAML-Datei ein neues Feld schema: <schema-name> hinzu.

  4. Amazon Q beginnt mit der Transformation. Es wird während der gesamten Transformation Status-Updates ausgeben. Wenn der Vorgang abgeschlossen ist, gibt Amazon Q den Pfad an, in dem die Transformationsergebnisse, Protokolle und Konfigurationsdateien ausgegeben werden.

    Ihr aktualisierter Code wird der neuen Filiale zugewiesen, die Amazon Q erstellt hat.