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 sich mit AWS Identity and Access Management (IAM) oder IAM Identity Center authentifizieren, um Transformationen in der Befehlszeile auszuführen. Stellen Sie unabhängig von der verwendeten Authentifizierungsmethode sicher, dass Sie über die richtigen Berechtigungen verfügen.

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 mit IAM

Um sich mit IAM zu authentifizieren, müssen Sie:

Sie können diese Konfiguration in Ihrer Befehlszeile angeben, indem Sie aws configure nach der Installation von den AWS CLI ausführen.

Sie geben das AWS CLI Profil an, in dem Sie konfiguriert habenSchritt 4: Konfiguration und Authentifizierung.

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

Schritt 3: Erstellen Sie eine Abhängigkeitsupgrade-Datei (optional)

Sie können Amazon Q eine Abhängigkeitsupgrade-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.

Damit Amazon Q alle Abhängigkeiten von Erstanbietern aktualisieren kann, müssen Sie sie in der Datei angeben. Es kann Abhängigkeiten von Drittanbietern aktualisieren, die Sie nicht angeben. Wenn es jedoch Abhängigkeiten oder Versionen gibt, für die Sie sicherstellen möchten, dass es aktualisiert wird, fügen Sie sie der Datei hinzu.

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:

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.

Schritt 5: Führen Sie eine Transformation durch

Wählen Sie die Art der Transformation, die Sie durchführen, um die erforderliche Konfiguration und die erforderlichen Befehle zu sehen.

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>Aktualisieren Sie auch 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 schreibt den Code in einem oder mehreren Commits fest, 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.