Behebung von Problemen mit dem Amazon Q Developer Agent for code transformation - Amazon Q Developer
Warum kann Amazon Q mein Projekt nicht hochladen?Warum sind meine Maven Befehle schlagen fehl?Wie füge ich Maven zu meinem hinzu? PATHWarum 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 die Codetransformationsprotokolle zu?Wie finde ich meine Transformationsjob-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 mit dem Amazon Q Developer Agent for code transformation

Die folgenden Informationen können Ihnen helfen, häufig auftretende Probleme mit dem zu beheben Amazon Q Developer Agent for code transformation.

Warum kann Amazon Q mein Projekt nicht hochladen?

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

Reduzieren Sie die Projektgröße

Um Ihren Code zu transformieren, generiert Amazon Q ein Projektartefakt, das Ihren Quellcode, Projektabhängigkeiten und Build-Logs 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 die Codetransformationsprotokolle zu?

Konfigurieren Sie die Proxyeinstellungen in Ihrem IDE

Um Ihren Code zu transformieren, lädt Amazon Q Ihr Projektartefakt in einen serviceeigenen Amazon S3 S3-Bucket hoch. Ein Teil des Upload-Vorgangs beinhaltet die Verwendung von SSL TLS Zertifikaten, um die Kommunikation zwischen Amazon S3 und Ihrem herzustellenIDE. Wenn Sie einen Proxy-Server verwenden, müssen die SSL von Ihrem Proxy-Server verwendeten TLS Zertifikate vertrauenswürdig sein, andernfalls kann Amazon Q Ihr Projekt nicht hochladen.

Wenn Sie im Zusammenhang mit Ihrem Proxy oder Ihren Zertifikaten eine Fehlermeldung erhalten, müssen Sie wahrscheinlich Ihr Betriebssystem IDE oder Ihr Betriebssystem so konfigurieren, dass es Ihren Zertifikaten vertraut, oder andere Proxyeinstellungen aktualisieren.

Anmerkung

Möglicherweise treten auch Probleme auf, die nichts mit Zertifikaten zu tun haben, wenn Sie sich hinter dem Proxyserver oder der Firewall Ihres Unternehmens befinden. Wenn Sie die folgenden Verfahren zur Konfiguration Ihrer Zertifikate ausführen und weiterhin Probleme haben, wenden Sie sich an Ihren Netzwerkadministrator, um sicherzustellen, dass Sie von Ihrem aus mit Amazon S3 kommunizieren dürfenIDE. Weitere Informationen finden Sie unter Zugriff auf Amazon S3 zulassen.

Konfigurieren Sie Zertifikate in JetBrains

Um Ihre zu konfigurieren JetBrains IDEJava Runtime Environment (JRE) Um den SSL von Ihrem Proxyserver verwendeten TLS Oder-Zertifikaten zu vertrauen, müssen Sie die SSL TLS Oder-Zertifikate in die cacerts Datei im importierenJRE. Bei der cacerts Datei handelt es sich um eine Datei, die vertrauenswürdige Stammzertifikate für sichere Verbindungen wie HTTPS und SSL enthält. Sie ist Teil der JRE Sicherheitseinstellungen von. Gehen Sie wie folgt vor, um ein Zertifikat zu importieren.

Anmerkung

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

  1. Ermitteln Sie den Pfad zu der cacerts Datei in IhremJRE. Der Pfad der cacerts Datei in der internen Datei, die mit Ihrem JRE geliefert wurde JetBrains IDEhängt vom Betriebssystem und der Version des JetBrains IDEdu benutzt.

    Im Folgenden finden Sie Beispiele für Pfade zur cacerts Datei 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 sind installiert. Dieses Verzeichnis wird normalerweise während des Installationsvorgangs ausgewählt.

    Der jbr Ordner steht für das JRE Paket mit JetBrains IDEs, das ist eine spezielle Version von, die JRE auf die Verwendung mit zugeschnitten ist JetBrains IDEs.

    Windows

    Der cacerts Dateipfad für ein JetBrains IDEauf Windows installiert ist:

    <JetBrains Installation Folder>\jbr\bin\cacerts

    Wenn Sie beispielsweise eine installiert haben JetBrains IDEunter Windows im Standardverzeichnis könnte der Pfad wie folgt lauten:

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

    Der cacerts Dateipfad für eine JetBrains IDEauf macOS installiert ist:

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

    Wenn Sie beispielsweise eine installiert haben JetBrains IDEauf macOS am Standardspeicherort 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 JetBrains IDEauf Linux installiert ist:

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

  2. Ermitteln Sie das Zertifikat, das Sie in die cacerts Datei importieren müssen. Die Zertifikatsdatei hat in der Regel die .der Dateierweiterung .cer.crt,, oder. 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 cacerts Keystore. Sie können dies mit dem keytool Java-Befehl tun.

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

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

    2. Sie können <alias> nämlich einen Namen für das Zertifikat hinzufügen, das Sie importieren, um später darauf zu verweisen. Dieser 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.cer, oder .der -Datei sein.crt, die das Zertifikat enthält.

    4. Geben Sie für <path_to_cacerts> den Pfad zu der cacerts Keystore-Datei an, die Sie in Schritt 1 gespeichert haben. Dies ist die Datei, in die Sie das Zertifikat importieren.

    Zum Beispiel, wenn Sie ein Zertifikat importieren möchten, das my_certificate.cer in den cacerts Keystore des gebündelten Zertifikats benannt ist JRE IntelliJ IDEA unter Windows und Sie möchten dem Zertifikat den Alias geben, myalias 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 cacerts Keystore lautet. changeit

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

  6. Möglicherweise müssen Sie zusätzlich zu dem auch die Zertifikate IDE selbst hinzufügenJRE. Weitere Informationen finden Sie unter Serverzertifikate im JetBrains -Dokumentation.

Mehr anzeigenWeniger anzeigen

Konfigurieren Sie Zertifikate in Visual Studio Code

Um zu konfigurieren Visual Studio Code Um den SSL von Ihrem Proxy-Server verwendeten TLS Zertifikaten zu vertrauen, stellen Sie sicher, dass Sie die folgenden Proxyeinstellungen für Ihr Betriebssystem konfiguriert haben.

Konfigurieren Sie die folgenden Proxyeinstellungen für Visual Studio Code auf macOS.

Fügen Sie Ihrem macOS-Schlüsselbund Zertifikate hinzu

Falls Sie dies noch nicht getan haben, müssen Sie die von Ihrem Proxyserver verwendeten Zertifikate zu Ihrem hinzufügen macOS Schlüsselbund. Informationen zum Hinzufügen von Zertifikaten zu Ihrem Schlüsselbund finden Sie unter Hinzufügen von Zertifikaten zu einem Schlüsselbund mithilfe von Keychain Access auf dem Mac im Keychain Access-Benutzerhandbuch.

Installieren Sie die Mac CA-Erweiterung VSCode

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

Um die Erweiterung zu installieren:

  1. Suchen Sie nach mac-ca-vscode in VS Code Erweiterungsfenster und wählen Sie Installieren.

  2. Neustart VS Code.

Aktualisieren Sie die Proxyeinstellungen in VS Code auf macOS

Aktualisieren Sie die folgenden Einstellungen, um sicherzugehen VS Code ist ordnungsgemäß für Ihren Proxy konfiguriert.

  1. Öffnen Sie die Einstellungen in VS Code.

  2. Geben Sie im Suchfeld proxy ein.

  3. Fügen Sie im Feld Http: Proxy Ihren Proxy hinzuURL.

  4. Deaktivieren Sie Http: Proxy Strict SSL.

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

  6. Geben http.experimental.systemCertificatesV2 Sie in der Suchleiste für Einstellungen ein. Wählen Sie Http › Experimentell: Systemzertifikate V2.

Konfigurieren Sie die folgenden Proxyeinstellungen für Visual Studio Code unter Windows.

Fügen Sie das Zertifikat unter Windows als vertrauenswürdiges Stammzertifikat hinzu

Falls Sie dies noch nicht getan haben, müssen Sie die von Ihrem Proxyserver verwendeten Zertifikate zu Ihrem Speicher für vertrauenswürdige Stammzertifizierungsstellen unter Windows hinzufügen. 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 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, wählen Sie Alle Aufgaben und dann Import... .

  5. Folgen Sie den Anweisungen, um Ihr Proxyzertifikat zu importieren.

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

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

Installieren Sie die Win-CA-Erweiterung VSCode

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

Um die Erweiterung zu installieren:

  1. Suchen Sie nach win-ca in VS Code Bereich mit den Einstellungen.

  2. Wählen Sie in der Dropdownliste Injizieren die Option Anhängen aus.

Aktualisieren Sie die Proxyeinstellungen in VS Code unter Windows

Aktualisieren Sie die folgenden Einstellungen, um sicherzugehen VS Code ist ordnungsgemäß für Ihren Proxy konfiguriert.

  1. Öffnen Sie die Einstellungen in VS Code.

  2. Geben Sie im Suchfeld proxy ein.

  3. Fügen Sie im Feld Http: Proxy Ihren Proxy hinzuURL.

  4. Deaktivieren Sie Http: Proxy Strict SSL.

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

  6. Geben http.experimental.systemCertificatesV2 Sie in der Suchleiste für Einstellungen ein. Wählen Sie Http › Experimentell: Systemzertifikate V2.

  7. Neustart VS Code.

Zugriff auf Amazon S3 zulassen

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

Um sicherzustellen, dass 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 ermöglichen. Möglicherweise müssen Sie auch den Amazon S3 S3-Bucket zulassen, in den Amazon Q Ihr Projekt hochlädt. Weitere Informationen finden Sie unter Datenperimeter für Amazon Q-Ressourcen.

Wenn Sie ein großes Projekt transformieren, können DLP Richtlinien oder andere Netzwerkkomponenten zu Verzögerungen führen und einen erfolgreichen Upload verhindern, wenn sie nicht so konfiguriert sind, dass sie den Amazon S3 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 sind meine Maven Befehle schlagen fehl?

Es folgen Maven Konfigurationsprobleme, die Sie möglicherweise in der JetBrains and Visual Studio Code IDEs. Wenn Sie die Probleme beheben und immer noch sehen Maven Fehler, möglicherweise liegt ein Problem mit Ihrem Projekt vor. Verwenden Sie die Informationen in den Fehlerprotokollen, um alle Probleme mit Ihrem Projekt zu beheben, und versuchen Sie dann erneut, Ihr Projekt zu transformieren.

Aktualisierung Maven Konfiguration in JetBrains

Wenn eine Transformation fehlschlägt in JetBrains aufgrund Maven Bei Befehlsproblemen 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:

  • Stellen Sie sicher, dass Ihr Maven Der Heimatpfad ist auf Gebündelt gesetzt. Gehen Sie zu Einstellungen und erweitern Sie dann den Abschnitt Build, Execution, Deployment. Erweitern Sie den Abschnitt Build Tools und erweitern Sie dann Maven. Wählen Sie in der Dropdownliste für den Maven-Home-Pfad die Option Bundled aus.

  • Stellen Sie sicher, dass Java Die Laufzeitumgebung (JRE) verwendet Ihr ProjektJDK. Gehen Sie zu Einstellungen und erweitern Sie dann den Abschnitt Build, Execution, Deployment. Erweitern Mavenund wähle Runner. Wählen Sie in der JREDropdownliste die Option Projekt JDK verwenden aus.

  • Stellen Sie sicher, dass Maven ist aktiviert. Gehe zu Einstellungen und wähle Plugins. Suche nach Maven und wähle Maven Plugin. Wenn Sie eine Schaltfläche „Aktivieren“ sehen, wählen Sie sie aus, um sie zu aktivieren Maven.

Aktualisierung Maven Konfiguration in Visual Studio Code

Wenn eine Transformation fehlschlägt in VS Code wegen Maven Bei Befehlsproblemen wird eine Textdatei, die die Fehlerprotokolle enthält, 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 eine Maven Wrapper im Stammordner des Projekts

  • Eine Version von Maven unterstützt von Amazon Q ist auf Ihrem PATH

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

Wie füge ich Maven zu meinem hinzu? PATH

Um deinen Code umzuwandeln in VS Code ohne eine zu verwenden Maven Wrapper, du musst installieren Maven und füge es zu deiner PATH Variablen hinzu.

Um zu überprüfen, ob Sie Maven ist bereits korrekt installiert, führe es mvn -v in einem neuen Betriebssystem-Terminal außerhalb von aus Visual Studio Code. Sie sollten eine Ausgabe mit Ihrem sehen Maven Version.

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

Um hinzuzufügen Maven zu IhremPATH, folgen Sie den Anweisungen für Ihr Gerät.

macOS

Zum Hinzufügen Maven führen Sie auf Ihrem macOS PATH die folgenden Schritte aus.

  1. Suchen Sie Ihr Maven Installationsverzeichnis oder den Ordner, in dem Sie installiert haben Maven, 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 von 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 mvn Befehl in allen Terminals verfügbar.

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

  4. Um das zu überprüfen Maven wurde zu Ihrem hinzugefügtPATH, öffnen Sie ein neues Betriebssystem-Terminal und führen Sie den folgenden Befehl aus:

    mvn -v

    Sie sollten eine Ausgabe mit Ihrem sehen Maven Version.

  5. Nachdem ich deine gesehen habe Maven Ausgabe, neu starten Visual Studio Code. Möglicherweise müssen Sie Ihren Computer auch neu starten. Öffne ein neues Visual Studio Code Terminal und führe den folgenden Befehl aus: 

    mvn -v

    Die Ausgabe sollte mit der Ausgabe in Schritt 4 identisch sein. Wenn das Symbol Visual Studio Code Die Ausgabe ist unterschiedlich. Versuchen Sie Folgendes, um sicherzustellen, dass Ihr Setup korrekt ist:

    • Überprüfe deine PATH Variable in Visual Studio Code. Eine IDE Erweiterung könnte sie PATH so ändern, dass sie sich von Ihrer lokalen PATH Variablen unterscheidet. Deinstallieren Sie die Erweiterung, um sie von Ihrem PATH zu entfernen.

    • Überprüfen Sie Ihre Standard-Shell in Visual Studio Code. Wenn es auf etwas anderes als eingestellt istzsh, wiederholen Sie diese Schritte für Ihre Shell.

Windows

Um hinzuzufügen Maven zu deinem Windows PATH, führen Sie die folgenden Schritte aus:

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

  2. Öffnen Sie das Fenster mit den Umgebungsvariablen:

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

    2. Geben Sie es ein Edit environment variables for your account und wählen Sie es aus.

  3. Suchen Sie im Fenster mit den Umgebungsvariablen nach der Path-Variablen. Wenn Sie bereits eine Path-Variable haben, wählen Sie Bearbeiten... um sie zu aktualisieren. Wenn Sie keine Path-Variable sehen, wählen Sie Neu... 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, 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 \bin am Ende des Pfads ein Suffix hinzu, wie im folgenden Beispiel:

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

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

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

    mvn -v

    Sie sollten eine Ausgabe mit Ihrem sehen Maven Version.

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 Ihren Code erstellt. Möglicherweise müssen Sie Ihre Build-Konfiguration oder Code-Implementierung aktualisieren.

Prüfen Sie die Build-Log-Ausgabe, 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önnten, Ihren Code zu erstellen.

Entfernen Sie absolute Pfade in pom.xml

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

Im Folgenden finden Sie ein Beispiel für einen absoluten Pfad, den Sie in Ihrer pom.xml Datei 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 Sie lokale oder externe Datenbanken in Komponententests

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

Warum ist meine Transformation nach 55 Minuten fehlgeschlagen?

Wenn Ihr Codetransformationsjob 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. Erwägen Sie auch, 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 das wahrscheinlich an einem der folgenden Probleme. Sehen Sie sich das Thema an, das dem Fehler entspricht, den Sie von Amazon Q erhalten haben.

Reduzieren Sie die Projektgröße

Nach Abschluss der Transformation generiert Amazon Q ein Ausgabeartefakt, das einen Unterschied zu Ihrem aktualisierten Code und eine Transformationszusammenfassung mit Informationen zu den vorgenommenen Änderungen enthält. Das Ausgabeartefakt muss 1 GB oder weniger groß sein, damit es heruntergeladen werden IDE kann.

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

Laden Sie den Code Diff innerhalb von 24 Stunden herunter

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

Konfigurieren Sie die Proxyeinstellungen in Ihrem IDE

Das Tool Amazon Q Developer Agent for code transformation lädt Ihren aktualisierten Code aus einem service-eigenen Amazon S3 S3-Bucket herunter. Ein Teil des Download-Vorgangs beinhaltet die Verwendung von SSL TLS Zertifikaten, um die Kommunikation zwischen Amazon S3 und Ihrem herzustellenIDE. Wenn Sie einen Proxy-Server verwenden, müssen die SSL von Ihrem Proxy-Server verwendeten TLS Zertifikate vertrauenswürdig sein, andernfalls kann Amazon Q Ihr Projekt nicht hochladen.

Um Ihren Code herunterzuladen, müssen Sie möglicherweise Ihre IDE Zertifikate als vertrauenswürdig konfigurieren oder andere Proxyeinstellungen aktualisieren. Weitere Informationen zur Aktualisierung Ihrer Proxyeinstellungen finden Sie unterKonfigurieren Sie die Proxyeinstellungen in Ihrem IDE.

Entfernen Sie Platzhalterzeichen in JetBrains Proxy-Einstellungen

Wenn Sie die Proxyeinstellungen in Ihrem konfiguriert haben JetBrains IDE, beim Herunterladen Ihres aktualisierten Codes wird 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 Ihren IDE Proxyeinstellungen verursacht. Das von der SDK verwendete Java Amazon Q Developer Agent for code transformation unterstützt keine Platzhaltereinträge in diesem Feld.

Um Ihren Code herunterzuladen, entfernen Sie alle Platzhalter aus dem Feld Kein Proxy für und starten Sie dann Ihren neu. IDE 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 Ihrem JetBrains IDE finden Sie unter HTTPProxy im JetBrains -Dokumentation.

Wie greife ich auf die Codetransformationsprotokolle zu?

Access meldet sich an JetBrains

Für Informationen zum Zugriff JetBrains Protokolldateien finden Sie unter Suchen nach IDE Protokolldateien im JetBrains -Dokumentation.

Um nach Protokollen zu suchen, die von Amazon Q Developer Agent for code transformation in JetBrains, suchen Sie in den IDE Protokollen nach der folgenden Zeichenfolge:

software.aws.toolkits.jetbrains.services.codemodernizer

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

Access meldet sich an Visual Studio Code

Um nach Protokollen zu suchen, die von Amazon Q Developer Agent for code transformation in VS Code, führen Sie die folgenden Schritte aus:

  1. Wählen Sie in der oberen Navigationsleiste „Ansicht“ und anschließend „Befehlspalette“.

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

  3. Die Protokolle werden in der geöffnetIDE. Verwenden Sie CMD + F oderCodeTransformation, um in den Protokolldateien zu suchenControl + F.

Die Codetransformation meldet sich an VS Code haben das Präfix. CodeTransformation: Im Folgenden finden Sie ein Beispiel für ein Protokoll, das in generiert wurde VS Code für ein Maven Fehler beim Kopieren von Abhängigkeiten:

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 Transformationsjob-ID?

Finden Sie Ihre Job-ID in JetBrains

Um eine Transformationsjob-ID zu finden in JetBrains, gehen Sie im Transformation Hub zur Registerkarte Transformationsdetails und wählen Sie das Symbol Jobstatus anzeigen (Uhr).

Finden Sie Ihre Job-ID in Visual Studio Code

Um eine Transformationsjob-ID in VS Code zu finden, gehen Sie zum Transformation Hub und wählen Sie das Symbol Jobstatus anzeigen (Uhr).