Behebung von Problemen bei Java-Transformationen - Amazon Q Developer
Warum kann Amazon Q mein Projekt nicht hochladen?Warum schlagen meine Maven-Befehle fehl?Wie füge ich Maven meinem PATH hinzu?Warum kann Amazon Q meinen Code nicht erstellen?Warum ist meine Transformation nach 55 Minuten fehlgeschlagen?Warum kann ich meinen transformierten Code nicht herunterladen?Wie greife ich auf Code-Transformationsprotokolle zu?Wie finde ich meine Transformationsauftrags-ID?

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.

Behebung von Problemen bei Java-Transformationen

Die folgenden Informationen können Ihnen helfen, häufig auftretende Probleme bei der Transformation von Java-Anwendungen mit Amazon Q Developer zu beheben.

Warum kann Amazon Q mein Projekt nicht hochladen?

Wenn Ihr Projekt nicht hochgeladen werden kann, liegt dies wahrscheinlich an einem der folgenden Probleme. Sehen Sie sich das Thema an, das dem Fehler entspricht, den Sie von Amazon Q erhalten haben.

Reduzierung der Projektgröße

Zum Transformieren Ihres Codes generiert Amazon Q ein Projektartefakt, das Ihren Quellcode, Projektabhängigkeiten und Build-Protokolle enthält. Die maximale Größe des Projektartefakts für einen Transformationsauftrag beträgt 2 GB. Wenn Sie im Zusammenhang mit der Größe des Projektartefakts eine Fehlermeldung erhalten, müssen Sie die Größe Ihres Projekts verringern oder versuchen, ein kleineres Projekt zu transformieren. Sie können die Größe Ihrer Projektartefaktdatei in den Codetransformationsprotokollen einsehen. Weitere Informationen finden Sie unter Wie greife ich auf Code-Transformationsprotokolle zu?.

Konfigurieren der Proxy-Einstellungen in Ihrer IDE

Zum Transformieren Ihres Codes lädt Amazon Q Ihr Projektartefakt in einen serviceeigenen Amazon-S3-Bucket hoch. Im Rahmen des Upload-Vorgangs werden SSL- oder TLS-Zertifikate verwendet, um die Kommunikation zwischen Amazon S3 und Ihrer IDE herzustellen. Wenn Sie einen Proxy-Server verwenden, müssen die von Ihrem Proxy-Server verwendeten SSL- oder TLS-Zertifikate vertrauenswürdig sein, andernfalls kann Amazon Q Ihr Projekt nicht hochladen.

Wenn Sie einen Fehler im Zusammenhang mit Ihrem Proxy oder Ihren Zertifikaten erhalten, müssen Sie gegebenenfalls Ihre IDE oder Ihr Betriebssystem so konfigurieren, dass es Ihren Zertifikaten vertraut, oder andere Proxy-Einstellungen aktualisieren.

Anmerkung

Wenn Sie sich hinter dem Proxy-Server oder der Firewall Ihres Unternehmens befinden, treten möglicherweise auch Probleme auf, die nichts mit Zertifikaten zu tun haben. Wenn Sie die folgenden Verfahren zur Konfiguration Ihrer Zertifikate ausführen und nach wie vor Probleme auftreten, wenden Sie sich an Ihren Netzwerkadministrator, um sicherzustellen, dass Sie von Ihrer IDE aus mit Amazon S3 kommunizieren dürfen. Weitere Informationen finden Sie unter Zulassen des Zugriffs auf Amazon S3.

Konfigurieren von Zertifikaten in JetBrains

Damit Sie Ihre Java-Laufzeitumgebung (JRE) der JetBrains-IDE so konfigurieren, dass sie den von Ihrem Proxy-Server verwendeten SSL- oder TLS-Zertifikaten vertraut, müssen Sie die SSL- oder TLS-Zertifikate in die Datei cacerts in der JRE importieren. Die Datei cacerts enthält vertrauenswürdige Stammzertifikate für sichere Verbindungen wie HTTPS und SSL. Sie ist Teil der JRE-Sicherheitseinstellungen. Gehen Sie wie folgt vor, um ein Zertifikat zu importieren.

Anmerkung

Wir empfehlen, vor der Änderung eine Sicherungskopie der Datei cacerts zu erstellen, da Fehler zu Problemen mit sicheren Verbindungen führen können.

  1. Ermitteln Sie den Pfad zur Datei cacerts in Ihrer JRE. Der Pfad der Datei cacerts in der internen JRE, die im Lieferumfang Ihrer JetBrains-IDE enthalten ist, hängt vom Betriebssystem und der Version der JetBrains-IDE ab, die Sie verwenden.

    Im Folgenden finden Sie Beispiele für Pfade zur Datei cacerts in gängigen Betriebssystemen. Wählen Sie Ihr Betriebssystem aus, um Beispiele zu sehen.

    Anmerkung

    <JetBrains Installation Folder> bezieht sich auf das Verzeichnis, in dem JetBrains-Produkte installiert sind. Dieses Verzeichnis wird normalerweise während des Installationsvorgangs ausgewählt.

    Der jbr Ordner stellt die mitgelieferte JRE dar. Dabei handelt es sich um eine spezielle Version der JRE JetBrains IDEs, die auf die Verwendung mit zugeschnitten ist. JetBrains IDEs

    Windows

    Der cacerts-Dateipfad für eine unter Windows installierte JetBrains-IDE lautet:

    <JetBrains Installation Folder>\jbr\bin\cacerts

    Wenn Sie beispielsweise eine JetBrains-IDE unter Windows im Standardverzeichnis installiert haben, könnte der Pfad wie folgt lauten:

    C:\Program Files\JetBrains\jbr\bin\cacerts
    macOS

    Der cacerts-Dateipfad für eine unter macOS installierte JetBrains-IDE lautet:

    /Applications/JetBrains Toolbox/<version>/JetBrains Toolbox.app/Contents/jbr/Contents/Home/lib/security/cacerts

    Wenn Sie beispielsweise eine JetBrains-IDE unter macOS im Standardverzeichnis installiert haben, könnte der Pfad wie folgt lauten:

    /Applications/JetBrains Toolbox/2022.3.4/JetBrains Toolbox.app/Contents/jbr/Contents/Home/lib/security/cacerts
    Linux

    Der cacerts-Dateipfad für eine unter Linux installierte JetBrains-IDE lautet:

    /opt/jetbrains/jbr/lib/security/cacerts

  2. Ermitteln Sie das Zertifikat, das Sie in die Datei cacerts importieren müssen. Die Zertifikatsdatei hat in der Regel die Dateierweiterung .cer, .crt oder .der. Wenn Sie nicht sicher sind, welche Zertifikate Sie hinzufügen müssen, wenden Sie sich an Ihren Netzwerkadministrator.

  3. Importieren Sie das Zertifikat in den Keystore cacerts. Für diesen Vorgang können Sie den Java-Befehl keytool verwenden.

    1. Öffnen Sie eine Eingabeaufforderung und geben Sie den folgenden Befehl ein:

      keytool -import -alias <alias> -file <certificate_file> -keystore <path_to_cacerts>

    2. Für <alias> können Sie einen Namen für das Zertifikat hinzufügen, das Sie importieren, um später darauf verweisen zu können. Diese Option ist optional.

    3. Geben Sie für <certificate_file> den Pfad zu dem Zertifikat an, das Sie importieren. Dies sollte ein Pfad zu der Datei .cer, .crt oder .der sein, die das Zertifikat enthält.

    4. Geben Sie als <path_to_cacerts> den Pfad zu der in Schritt 1 gespeicherten Keystore-Datei cacerts an. Dies ist die Datei, in die Sie das Zertifikat importieren.

    Wenn Sie beispielsweise ein Zertifikat mit dem Namen my_certificate.cer in den Keystore cacerts der gebündelten JRE in IntelliJ IDEA unter Windows importieren möchten, und Sie dem Zertifikat den Alias myalias geben möchten, könnte der Befehl wie folgt lauten:

    keytool -import -alias myalias -file my_certificate.cer -keystore "C:\Program Files\JetBrains\IntelliJ IDEA 2022.3.2\jbr\bin\cacerts"

  4. Während des Importvorgangs werden Sie aufgefordert, das Keystore-Passwort einzugeben. Das Standardkennwort für den Keystore cacerts lautet changeit.

  5. Nachdem Sie den Befehl ausgeführt haben, werden Sie aufgefordert, zu bestätigen, dass Sie dem Zertifikat vertrauen. Geben Sie yes ein, um zu bestätigen, dass das Zertifikat vertrauenswürdig ist, und den Import abzuschließen.

  6. Möglicherweise müssen Sie die Zertifikate neben der JRE auch zur IDE hinzufügen. Weitere Informationen erhalten Sie unter Server Certificates in der JetBrains-Dokumentation.

Mehr anzeigenWeniger anzeigen

Konfigurieren von Zertifikaten in Visual Studio Code

Damit Visual Studio Code so konfiguriert wird, dass den von Ihrem Proxy-Server verwendeten SSL- oder TLS-Zertifikaten vertraut wird, stellen Sie sicher, dass Sie die folgenden Proxy-Einstellungen für Ihr Betriebssystem konfiguriert haben.

Konfigurieren Sie die folgenden Proxy-Einstellungen für Visual Studio Code unter macOS.

Hinzufügen von Zertifikaten zu Ihrem macOS-Schlüsselbund

Sie müssen die von Ihrem Proxy-Server verwendeten Zertifikate Ihrem macOS-Schlüsselbund hinzufügen, falls Sie dies noch nicht getan haben. Informationen zum Hinzufügen von Zertifikaten zu Ihrem Schlüsselbund finden Sie unter Hinzufügen von Zertifikaten zu einem Schlüsselbund mit der Schlüsselbundverwaltung auf dem Mac im Benutzerhandbuch für die Schlüsselbundverwaltung.

Installieren Sie die Mac CA-Erweiterung VSCode

Die VSCode Mac-CA-Erweiterung ermöglicht Amazon Q den Zugriff auf die Zertifikate, die Sie zu Keychain Access auf Ihrem Mac hinzugefügt haben.

So installieren Sie die Erweiterung:

  1. Suchen Sie mac-ca-vscode im VS Code-Erweiterungsbereich und wählen Sie Installieren aus.

  2. Starten Sie VS Code neu.

Aktualisieren der Proxy-Einstellungen in VS Code unter macOS

Aktualisieren Sie die folgenden Einstellungen, um sicherzustellen, dass VS Code für Ihren Proxy richtig konfiguriert sind.

  1. Öffnen Sie die Einstellungen in VS Code.

  2. Geben Sie im Suchfeld proxy ein.

  3. Fügen Sie im Feld Http: Proxy Ihre Proxy-URL hinzu.

  4. Deaktivieren Sie Http: Proxy Strict SSL.

  5. Wählen Sie in der Dropdown-Liste Http: Proxy Support die Option on aus.

  6. Geben Sie im Suchfeld „Einstellungen“ http.experimental.systemCertificatesV2 ein. Wählen Sie Http › Experimental: System Certificates V2 aus.

Konfigurieren Sie die folgenden Proxy-Einstellungen für Visual Studio Code unter Windows.

Hinzufügen des Zertifikats unter Windows als vertrauenswürdiges Stammzertifikat

Sie müssen die von Ihrem Proxy-Server verwendeten Zertifikate Ihrem Speicher für vertrauenswürdige Stammzertifizierungsstellen unter Windows hinzufügen, falls Sie dies noch nicht getan haben. Gehen Sie wie folgt vor, um ein Zertifikat hinzuzufügen:

  1. Öffnen Sie das Suchtool oder das Befehlsfenster „Ausführen“.

  2. Geben Sie Folgendes ein, um das Certificate-Manager-Tool zu öffnen:

    certmgr.msc

  3. Wählen Sie den Speicher Vertrauenswürdige Stammzertifizierungsstellen aus.

  4. Klicken Sie mit der rechten Maustaste auf Zertifikate, Alle Aufgaben und Importieren …

  5. Folgen Sie den angegebenen Anweisungen, um Ihr Proxy-Zertifikat zu importieren.

  6. Nachdem Sie Ihr Zertifikat importiert haben, vergewissern Sie sich, dass das Zertifikat hinzugefügt wurde.

    Doppelklicken Sie im Speicher Vertrauenswürdige Stammzertifizierungsstellen auf Zertifikate. Klicken Sie mit der rechten Maustaste auf das hinzugefügte Zertifikat und wählen Sie Eigenschaften aus. Unter Zertifikatszwecke sollte die Option Alle Zwecke für dieses Zertifikat aktivieren ausgewählt sein.

Installieren Sie die Win-CA-Erweiterung VSCode

Die VSCode Win-CA-Erweiterung ermöglicht Amazon Q den Zugriff auf die Zertifikate, die Sie zu Trusted Root Certificates in Windows hinzugefügt haben.

So installieren Sie die Erweiterung:

  1. Suchen Sie win-ca im VS Code-Einstellungsbereich.

  2. Wählen Sie in der Dropdown-Liste Inject die Option Append aus.

Aktualisieren der Proxy-Einstellungen in VS Code unter Windows

Aktualisieren Sie die folgenden Einstellungen, um sicherzustellen, dass VS Code für Ihren Proxy richtig konfiguriert sind.

  1. Öffnen Sie die Einstellungen in VS Code.

  2. Geben Sie im Suchfeld proxy ein.

  3. Fügen Sie im Feld Http: Proxy Ihre Proxy-URL hinzu.

  4. Deaktivieren Sie Http: Proxy Strict SSL.

  5. Wählen Sie in der Dropdown-Liste Http: Proxy Support die Option on aus.

  6. Geben Sie im Suchfeld „Einstellungen“ http.experimental.systemCertificatesV2 ein. Wählen Sie Http › Experimental: System Certificates V2 aus.

  7. Starten Sie VS Code neu.

Zulassen des Zugriffs auf Amazon S3

Während einer Transformation lädt Amazon Q Ihren Code in einen serviceeigenen Amazon-S3-Bucket hoch. Wenn Ihr Netzwerk oder Ihre Organisation den Zugriff auf Amazon S3 nicht konfiguriert hat, kann Amazon Q Ihr Projekt nicht hochladen.

Damit Amazon Q Ihr Projekt hochladen kann, stellen Sie sicher, dass Ihre Proxy-Konfiguration und andere Netzwerkkomponenten, wie Data Lost Prevention (DLP)-Richtlinien, so konfiguriert sind, dass sie den Zugriff auf Amazon S3 erlauben. Es könnte sein, dass Sie auch den Amazon-S3-Bucket, in den Amazon Q Ihr Projekt hochlädt, auf die Zulassungsliste setzen müssen. Weitere Informationen finden Sie unter Amazon S3 S3-Bucket URLs und ARNs zur Allowlist.

Beim Transformieren eines großen Projekts können DLP-Richtlinien oder andere Netzwerkkomponenten Verzögerungen verursachen und einen erfolgreichen Upload verhindern, wenn sie nicht so konfiguriert sind, dass sie den Amazon-S3-Bucket zulassen. Wenn Sie den Bucket nicht auf die Zulassungsliste setzen möchten, müssen Sie möglicherweise ein kleineres Projekt transformieren, damit Amazon Q es hochladen kann.

Warum schlagen meine Maven-Befehle fehl?

Im Folgenden sind Maven Konfigurationsprobleme aufgeführt, die möglicherweise im JetBrains und Visual Studio Code IDEs auftreten. Wenn Sie die Probleme beheben und weiterhin Maven-Fehler auftreten, liegt möglicherweise ein Problem mit Ihrem Projekt vor. Verwenden Sie die Informationen in den Fehlerprotokollen, um alle Probleme mit Ihrem Projekt zu beheben. Versuchen Sie dann erneut, Ihr Projekt zu transformieren.

Aktualisieren der Maven-Konfiguration in JetBrains

Wenn eine Transformation in JetBrains aufgrund von Maven-Befehlsproblemen fehlschlägt, werden die Fehlerprotokolle auf der Registerkarte Ausführen angezeigt. Verwenden Sie die Informationen in den Protokollen, um das Problem zu beheben. Im Folgenden sind einige Probleme aufgeführt, die Sie möglicherweise beheben müssen:

  • Vergewissern Sie sich, dass Ihr Maven-Home-Pfad auf Bundled eingestellt ist. Erweitern Sie im Dialogfeld Settings den Abschnitt Build, Execution, Deployment. Erweitern Sie den Abschnitt Build Tools und dann Maven. Wählen Sie in der Dropdown-Liste Maven home path die Option Bundled aus.

  • Stellen Sie sicher, dass die Java-Laufzeitumgebung (JRE) Ihr Projekt-JDK verwendet. Erweitern Sie im Dialogfeld Settings den Abschnitt Build, Execution, Deployment. Erweitern Sie Maven und wählen Sie Runner aus. Wählen Sie in der Dropdown-Liste JRE die Option Use Project JDK aus.

  • Stellen Sie sicher, dass Maven aktiviert ist. Gehen Sie zu Settings und wählen Sie Plugins aus. Suchen Sie nach Maven und wählen Sie das Maven-Plugin aus. Wenn Sie die Schaltfläche Aktivieren sehen, wählen Sie sie aus, um Maven zu aktivieren.

Aktualisieren der Maven-Konfiguration in Visual Studio Code

Wenn eine Transformation in VS Code aufgrund von Maven-Befehlsproblemen fehlschlägt, wird eine Textdatei mit den Fehlerprotokollen auf einer neuen Registerkarte geöffnet. Verwenden Sie die Informationen in den Protokollen, um das Problem zu beheben.

Stellen Sie sicher, dass Sie eine der folgenden Optionen konfiguriert haben:

  • Ihr Projekt enthält einen Maven Wrapper im Stammordner des Projekts.

  • Eine von Amazon Q unterstützte Maven-Version ist in Ihrem PATH verfügbar.

Weitere Informationen finden Sie unter Wie füge ich Maven meinem PATH hinzu?.

Wie füge ich Maven meinem PATH hinzu?

Wenn Sie Ihren Code in VS Code ohne Verwendung eines Maven Wrappers umwandeln möchten, müssen Sie Maven installieren und Ihrer Variablen PATH hinzufügen.

Wenn Sie überprüfen möchten, ob Sie Maven bereits korrekt installiert haben, führen Sie mvn -v in einem neuen Betriebssystem-Terminal außerhalb von Visual Studio Code aus. Sie sollten eine Ausgabe mit Ihrer Maven-Version sehen.

Wenn Sie eine Ausgabe zwar in Ihrem Visual Studio Code-Terminal, nicht aber in Ihrem Betriebssystem-Terminal erhalten, oder wenn der Befehl nicht gefunden wird, müssen Sie Maven Ihrem PATH hinzufügen.

Folgen Sie den Anweisungen für Ihr Gerät, um Maven Ihrem PATH hinzuzufügen.

macOS

Führen Sie die folgenden Schritte aus, um Maven Ihrem macOS PATH hinzuzufügen.

  1. Suchen Sie Ihr Maven-Installationsverzeichnis oder den Ordner, in dem Sie Maven installiert haben, und speichern Sie den Pfad zu diesem Ordner.

  2. Öffnen Sie die Konfigurationsdatei für Ihre Shell in einem Editor Ihrer Wahl. Für aktuelle macOS-Versionen ist die Standard-Shell zsh und die Standardkonfigurationsdatei befindet sich unter ~/.zshrc.

    Fügen Sie die folgenden Zeilen am Ende der Konfigurationsdatei hinzu. Stellen Sie den Wert M2_HOME auf den Pfad ein, den Sie in Schritt 1 gespeichert haben:

    export M2_HOME="your Maven installation directory"
export PATH="${M2_HOME}/bin:${PATH}"

    Diese Befehle machen den Befehl mvn in allen Terminals verfügbar.

  3. Schließen Sie alle Betriebssystem-Terminalfenster und beenden Sie alle Instances von Visual Studio Code.

  4. Öffnen Sie ein neues Betriebssystem-Terminal und führen Sie den folgenden Befehl aus, um zu überprüfen, ob Maven Ihrem PATH hinzugefügt wurde:

    mvn -v

    Sie sollten eine Ausgabe mit Ihrer Maven-Version sehen.

  5. Nachdem Sie Ihre Maven-Ausgabe gesehen haben, starten Sie Visual Studio Code neu. Es kann sein, dass Sie auch Ihren Computer neu starten müssen. Öffnen Sie ein neues Terminal von Visual Studio Code und führen Sie den folgenden Befehl aus: 

    mvn -v

    Die Ausgabe sollte mit der Ausgabe in Schritt 4 identisch sein. Wenn die Ausgabe von Visual Studio Code abweicht, versuchen Sie Folgendes, um sicherzustellen, dass Ihre Konfiguration korrekt ist:

    • Überprüfen Sie Ihre PATH-Variable in Visual Studio Code. Eine IDE-Erweiterung ändert die PATH-Variable möglicherweise so, dass sie sich von Ihrer lokalen PATH-Variable unterscheidet. Deinstallieren Sie die Erweiterung, um sie aus Ihrem PATH zu entfernen.

    • Überprüfen Sie Ihre Standard-Shell in Visual Studio Code. Wenn sie auf einen anderen Wert als zsh eingestellt ist, wiederholen Sie diese Schritte für Ihre Shell.

Windows

Führen Sie die folgenden Schritte aus, um Maven Ihrem PATH unter Windows hinzuzufügen:

  1. Suchen Sie Ihr Maven-Installationsverzeichnis oder den Ordner, in dem Sie Maven installiert haben, und speichern Sie den Pfad zu diesem Ordner.

  2. Öffnen Sie das Fenster „Umgebungsvariablen“:

    1. Wählen Sie die Schaltfläche Windows, um die Suchleiste zu öffnen.

    2. Geben Sie Edit environment variables for your account ein und klicken Sie darauf.

  3. Suchen Sie im Fenster Umgebungsvariablen nach der PATH-Variablen. Wenn Sie bereits eine PATH-Variable vorliegen haben, wählen Sie Bearbeiten ... aus, um sie zu aktualisieren. Wenn Sie keine PATH-Variable sehen, wählen Sie Neu ... aus, um eine hinzuzufügen.

  4. Doppelklicken Sie im daraufhin angezeigten Fenster Umgebungsvariable bearbeiten auf den vorhandenen Pfad, um ihn zu bearbeiten, oder wählen Sie Neu aus, um einen neuen Pfadeintrag hinzuzufügen.

    Ersetzen Sie den vorhandenen Maven-Pfadeintrag durch den Pfad, den Sie in Schritt 1 gespeichert haben, oder fügen Sie den Pfad als neuen Eintrag hinzu. Fügen Sie am Ende des Pfads \bin als Suffix hinzu, wie im folgenden Beispiel gezeigt:

    C:\Users\yourusername\Downloads\apache-maven-3.9.6-bin\apache-maven-3.9.6\bin

  5. Wählen Sie OK aus, um den Pfadeintrag zu speichern, und klicken Sie dann im Fenster Umgebungsvariablen erneut auf OK.

  6. Öffnen Sie eine Eingabeaufforderung und führen Sie den folgenden Befehl aus:

    mvn -v

    Sie sollten eine Ausgabe mit Ihrer Maven-Version sehen.

Warum kann Amazon Q meinen Code nicht erstellen?

Wenn die Transformation fehlschlägt, während Amazon Q Ihren Code erstellt, ist Ihr Projekt möglicherweise nicht richtig für die Umgebung konfiguriert, in der Amazon Q den Code generiert. Möglicherweise müssen Sie Ihre Build-Konfiguration oder Code-Implementierung aktualisieren.

Prüfen Sie die Build-Protokollausgabe, die Amazon Q bereitstellt, um festzustellen, ob es Änderungen gibt, die Sie an Ihrem Projekt vornehmen können. Im Folgenden sind einige häufig auftretende Probleme aufgeführt, die Amazon Q daran hindern können, Ihren Code zu erstellen.

Entfernen absoluter Pfade in pom.xml

Wenn Sie einen absoluten Pfad in Ihrer Datei pom.xml vorliegen haben, kann Amazon Q die entsprechenden Dateien nicht finden und Ihren Code daher möglicherweise nicht erstellen.

Im Folgenden finden Sie ein Beispiel für einen absoluten Pfad, den Sie in Ihrer Datei pom.xml vorliegen haben könnten:

<toolspath>
    <path>/Library/Java/JavaVirtualMachines/jdk-11.0.11.jdk/Contents/Home/lib/tools.jar</path>
</toolspath>

Anstatt einen absoluten Pfad zu verwenden, können Sie mit einem Zeiger einen relativen Pfad erstellen. Im Folgenden finden Sie ein Beispiel dafür, wie Sie den vorherigen absoluten Pfad durch einen relativen Pfad ersetzen können:

<toolspath>
    <path>${java.home}/../lib/tools.jar</path>
</toolspath>

Entfernen lokaler oder externer Datenbanken in Modultests

Amazon Q führt alle Modultests in Ihrem Projekt durch, wenn es Ihren Code erstellt. Wenn ein Modultest eine lokale oder externe Datenbank aufruft, hat Amazon Q keinen Zugriff auf die Datenbank, sodass der Build fehlschlägt. Wenn Sie verhindern möchten, dass der Build fehlschlägt, müssen Sie entweder den Datenbankaufruf aus dem Modultest entfernen oder den Modultest entfernen, bevor Sie die Transformation absenden.

Warum ist meine Transformation nach 55 Minuten fehlgeschlagen?

Wenn Ihr Codetransformationsauftrag nach 55 Minuten fehlschlägt, überschreitet Ihre Codeerstellungszeit wahrscheinlich das Build-Zeitlimit. Derzeit gibt es ein Zeitlimit von 55 Minuten für die Erstellung Ihres Codes.

Wenn Ihre lokale Build-Zeit 55 Minuten oder länger dauert, reduzieren Sie die Build-Zeit Ihres Projekts, um Ihren Code zu transformieren. Wenn Ihr lokaler Build schneller ist als der Build mit Codetransformation, überprüfen Sie Ihr Projekt auf Aufgaben, die in einer anderen Umgebung möglicherweise fehlschlagen oder länger dauern. Erwägen Sie, Testfälle mit langer Laufzeit zu deaktivieren. Ziehen Sie auch in Betracht, Timeouts für Versuche zu verwenden, auf Ressourcen zuzugreifen, die in der sicheren IDE-Umgebung oder im Internet möglicherweise nicht verfügbar sind.

Warum kann ich meinen transformierten Code nicht herunterladen?

Wenn Sie Ihren Code nach Abschluss der Transformation nicht herunterladen können, liegt dies wahrscheinlich an einem der folgenden Probleme. Sehen Sie sich das Thema an, das dem Fehler entspricht, den Sie von Amazon Q erhalten haben.

Reduzierung der Projektgröße

Nach Abschluss der Transformation generiert Amazon Q ein Ausgabeartefakt, das eine Diff-Datei für Ihren aktualisierten Code und eine Transformationszusammenfassung mit Informationen zu den vorgenommenen Änderungen enthält. Das Ausgabeartefakt muss 1 GB oder kleiner sein, damit die IDE es herunterladen kann.

Wenn das Ausgabeartefakt das Limit überschreitet, können Sie Ihren aktualisierten Code oder die Transformationszusammenfassung nicht herunterladen. Versuchen Sie, ein kleineres Projekt zu transformieren, um ein großes Ausgabeartefakt zu vermeiden. Wenn das Problem weiterhin besteht, wenden Sie sich an Support. Informationen zur Kontaktaufnahme Support mit Amazon Q finden Sie unterVerwenden von Amazon Q Developer zum Chatten mit Support.

Herunterladen der Code-Diff-Datei innerhalb von 30 Tagen

Die Code-Diff-Datei mit Ihrem aktualisierten Code ist nach Abschluss der Transformation nur 30 Tage lang verfügbar. Wenn seit Abschluss der Transformation mehr als 30 Tage vergangen sind, starten Sie die Transformation neu, um die Diff-Datei herunterzuladen.

Konfigurieren der Proxy-Einstellungen in Ihrer IDE

Amazon Q lädt Ihren aktualisierten Code von einem serviceeigenen Amazon-S3-Bucket herunter. Im Rahmen des Download-Vorgangs werden SSL- oder TLS-Zertifikate verwendet, um die Kommunikation zwischen Amazon S3 und Ihrer IDE herzustellen. Wenn Sie einen Proxy-Server verwenden, müssen die von Ihrem Proxy-Server verwendeten SSL- oder TLS-Zertifikate vertrauenswürdig sein, andernfalls kann Amazon Q Ihr Projekt nicht hochladen.

Damit Sie Ihren Code herunterladen können, müssen Sie möglicherweise Ihre IDE so konfigurieren, dass sie Zertifikaten vertraut, oder andere Proxy-Einstellungen aktualisieren. Weitere Informationen zum Aktualisieren Ihrer Proxy-Einstellungen finden Sie unter Konfigurieren der Proxy-Einstellungen in Ihrer IDE.

Entfernen von Platzhalterzeichen in den JetBrains-Proxy-Einstellungen

Wenn Sie Proxy-Einstellungen in Ihrer JetBrains-IDE konfiguriert haben, wird beim Herunterladen Ihres aktualisierten Codes möglicherweise der folgende Fehler angezeigt: 

software.amazon.awssdk.core.exception.SdkClientException: 
Unable to execute HTTP request: Dangling meta character '*' near index 0

Dies wird wahrscheinlich durch das Vorhandensein eines Platzhalterzeichens (*) im Feld Kein Proxy für in den Proxy-Einstellungen Ihrer IDE verursacht. Das von Amazon Q verwendete Java-SDK unterstützt keine Platzhaltereinträge in diesem Feld.

Damit Sie Ihren Code herunterladen können, entfernen Sie alle Platzhalter aus dem Feld Kein Proxy für und starten Ihre IDE neu. Wenn Sie Hosts angeben müssen, die den Proxy umgehen sollen, verwenden Sie einen regulären Ausdruck anstelle eines Platzhalters. Informationen zum Aktualisieren der Proxyeinstellungen in Ihrer JetBrains IDE finden Sie in der JetBrains Dokumentation unter HTTP-Proxy.

Wie greife ich auf Code-Transformationsprotokolle zu?

Zugreifen auf Protokolle in JetBrains

Informationen zum Zugreifen auf JetBrains-Protokolldateien finden Sie unter Locating IDE log files in der JetBrains-Dokumentation.

Wenn Sie von Amazon Q ausgegebene Protokolle in JetBrains finden möchten, suchen Sie in den IDE-Protokollen nach der folgenden Zeichenfolge:

software.aws.toolkits.jetbrains.services.codemodernizer

Codetransformationsprotokolle beginnen mit der vorhergehenden Zeichenfolge. Von Maven generierte Protokolle werden auf der Registerkarte Ausführen angezeigt und enthalten die vorangegangene Zeichenfolge vor und nach dem Protokolleintrag.

Zugreifen auf Protokolle in Visual Studio Code

Führen Sie die folgenden Schritte aus, um die von Amazon Q ausgegebenen Protokolle in VS Code zu finden:

  1. Wählen Sie in der oberen Navigationsleiste View und anschließend Command Palette aus.

  2. Suchen Sie Amazon Q: View Logs in der angezeigten Befehlspalette.

  3. Die Protokolle werden in der IDE geöffnet. Verwenden Sie CMD + F oder Control + F, um in den Protokolldateien nach CodeTransformation zu suchen.

Codetransformationsprotokolle in VS Code haben das Präfix CodeTransformation:. Im Folgenden finden Sie ein Beispiel für ein Protokoll in VS Code, das aufgrund eines Maven-Fehlers beim Kopieren von Abhängigkeiten generiert wurde:

2024-02-12 11:29:16 [ERROR]: CodeTransformation: Error in running Maven copy-dependencies command mvn = /bin/sh: mvn: command not found

Wie finde ich meine Transformationsauftrags-ID?

Suchen Ihrer Auftrags-ID in JetBrains

Wenn Sie eine Transformationsauftrags-ID in JetBrains suchen, gehen Sie im Transformation Hub zur Registerkarte Transformation details und wählen Sie das Symbol Jobstatus anzeigen (Uhr) aus.

Suchen Ihrer Auftrags-ID in Visual Studio Code

Wenn Sie eine Transformationsauftrags-ID in VS Code suchen, gehen Sie zum Transformation Hub und wählen Sie das Symbol Jobstatus anzeigen (Uhr) aus.