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 behebenAmazon Q Developer Agent for code transformation.
Themen
- Warum kann Amazon Q mein Projekt nicht hochladen?
- Warum schlagen meine Maven Befehle fehl?
- Wie füge ich Maven zu meinem hinzu? PATH
- 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 die Codetransformationsprotokolle zu?
- Wie finde ich meine Transformationsjob-ID?
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.
Themen
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 Ihr JetBrains IDE Java Runtime Environment (JRE) so zu konfigurieren, dass es den SSL von Ihrem Proxyserver verwendeten TLS Oder-Zertifikaten vertraut, müssen Sie die SSL TLS Oder-Zertifikate in die cacerts
Datei in der 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.
-
Ermitteln Sie den Pfad zu der
cacerts
Datei in IhremJRE. Der Pfad dercacerts
Datei in der internen Datei, die mit Ihrem JRE geliefert wurde, JetBrains IDE hängt vom Betriebssystem und der Version ab, die JetBrains IDE Sie verwenden.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 installiert sind. Dieses Verzeichnis wird normalerweise während des Installationsvorgangs ausgewählt.Der
jbr
Ordner steht für das JRE Paket mit. Dabei handelt es sich um eine spezifische Version von JetBrainsIDEs, die JRE auf die Verwendung mit JetBrains IDEs zugeschnitten ist. -
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. -
Importieren Sie das Zertifikat in den
cacerts
Keystore. Sie können dies mit demkeytool
Java-Befehl tun.-
Öffnen Sie eine Eingabeaufforderung und geben Sie den folgenden Befehl ein:
keytool -import -alias <alias> -file <certificate_file> -keystore <path_to_cacerts>
-
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. -
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. -
Geben Sie für
<path_to_cacerts>
den Pfad zu dercacerts
Keystore-Datei an, die Sie in Schritt 1 gespeichert haben. Dies ist die Datei, in die Sie das Zertifikat importieren.
Wenn Sie beispielsweise ein Zertifikat importieren möchten, das
my_certificate.cer
in dencacerts
Keystore des mitgelieferten JRE Zertifikats IntelliJ IDEA unter Windows benannt ist, und Sie dem Zertifikat den Alias geben möchten,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"
-
-
Während des Importvorgangs werden Sie aufgefordert, das Keystore-Passwort einzugeben. Das Standardkennwort für den
cacerts
Keystore lautet.changeit
-
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ßen
yes
. -
Möglicherweise müssen Sie zusätzlich zu dem auch die Zertifikate IDE selbst hinzufügenJRE. Weitere Informationen finden Sie in der JetBrains Dokumentation unter Serverzertifikate
.
Konfigurieren Sie Zertifikate in Visual Studio Code
Anmerkung
Die folgenden Informationen beziehen sich nur auf die Behebung von Proxyproblemen Visual Studio Code bei macOS aktivierter Option.
Stellen Sie sicherVisual Studio Code, dass Sie die SSL folgenden Proxyeinstellungen konfiguriert haben, um den von Ihrem Proxyserver verwendeten TLS Zertifikaten zu vertrauen.
Fügen Sie Ihrem Schlüsselbund Zertifikate hinzu
Falls Sie dies noch nicht getan haben, müssen Sie die von Ihrem Proxyserver verwendeten Zertifikate zu Ihrem macOS Schlüsselbund hinzufügen. 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
Installieren Sie die Mac CA-Erweiterung VSCode
Die VSCodeMac-CA-Erweiterung
Um die Erweiterung zu installieren:
-
Suchen Sie
mac-ca-vscode
im VS Code Erweiterungsbereich nach und wählen Sie Installieren. -
Starten Sie VS Code neu.
Aktualisieren Sie die Proxyeinstellungen in VS Code
Aktualisieren Sie die folgenden Einstellungen, um sicherzustellenVS Code, dass sie für Ihren Proxy richtig konfiguriert sind.
-
Öffnen Sie die Einstellungen inVS Code.
-
Geben Sie im Suchfeld
proxy
ein. -
Fügen Sie im Feld Http: Proxy Ihren Proxy hinzuURL.
-
Deaktivieren Sie Http: Proxy Strict SSL.
-
Wählen Sie im Dropdownmenü Http: Proxy Support die Option on aus.
-
Geben
http.experimental.systemCertificatesV2
Sie in der Suchleiste für Einstellungen ein. Wählen Sie Http › Experimentell: Systemzertifikate V2.
Zugriff auf Amazon S3 zulassen
Während einer Transformation Amazon Q Developer Agent for code transformation lädt der Ihren Code in einen diensteigenen 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-Bucket, in den Amazon Q Ihr Projekt hochlädt, auf eine Zulassungsliste setzen. 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 schlagen meine Maven Befehle fehl?
Im Folgenden sind Maven Konfigurationsprobleme aufgeführt, die möglicherweise im JetBrains und auftreten Visual Studio CodeIDEs. Wenn Sie die Probleme beheben und weiterhin Maven Fehler sehen, liegt möglicherweise 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.
Aktualisieren Sie die Maven Konfiguration in JetBrains
Wenn eine Transformation 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. Gehen Sie zu Einstellungen und erweitern Sie dann den Abschnitt Build, Execution, Deployment. Erweitern Sie den Abschnitt Build Tools und erweitern Sie ihn dann Maven. Wählen Sie im Dropdownmenü für den Maven-Startpfad die Option Bundled aus.
-
Stellen Sie sicher, dass die Java Laufzeitumgebung (JRE) Ihr Projekt verwendet. JDK Gehen Sie zu Einstellungen und erweitern Sie dann den Abschnitt Build, Execution, Deployment. Erweitern Sie Mavenund wählen Sie Runner. Wählen Sie im JREDropdownmenü die Option Projekt JDK verwenden aus.
-
Stellen Sie sicher, dass das aktiviert Maven ist. Gehe zu Einstellungen und wähle Plugins. Suchen Sie nach dem Maven Plugin Maven und wählen Sie es aus. Wenn Sie eine Schaltfläche „Aktivieren“ sehen, wählen Sie sie aus, um sie zu aktivierenMaven.
MavenKonfiguration aktualisieren in Visual Studio Code
Wenn eine Transformation 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 Maven unterstützte Version 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 Ihren Code VS Code ohne Verwendung eines Maven Wrappers umzuwandeln, müssen Sie ihn installieren Maven und zu Ihrer PATH
Variablen hinzufügen.
Um zu überprüfen, ob Sie die Maven Installation bereits korrekt durchgeführt haben, führen Sie das Programm mvn -v
in einem neuen Betriebssystem-Terminal außerhalb von ausVisual Studio Code. Sie sollten eine Ausgabe mit Ihrer Maven Version sehen.
Wenn Sie eine Ausgabe in Ihrem Visual Studio Code Terminal erhalten, aber nicht in Ihrem Betriebssystem-Terminal, oder wenn der Befehl nicht gefunden wird, müssen Sie Maven zu Ihrer hinzufügenPATH
.
Um Maven zu Ihrem hinzuzufügenPATH
, folgen Sie den Anweisungen für Ihr Gerät.
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.
Themen
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
Der 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 den JetBrains Proxyeinstellungen
Wenn Sie in Ihrem Proxyeinstellungen konfiguriert haben JetBrainsIDE, 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 Ihren IDE Proxyeinstellungen verursacht. Das von der SDK verwendete Java unterstützt Amazon Q Developer Agent for code transformation 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
Wie greife ich auf die Codetransformationsprotokolle zu?
Access meldet sich an JetBrains
Informationen zum Zugriff auf JetBrains Protokolldateien finden Sie in der JetBrains Dokumentation unter Suchen nach IDE Protokolldateien
Suchen Sie in den Protokollen nach der folgenden ZeichenfolgeJetBrains, um die vom Amazon Q Developer Agent for code transformation IN ausgegebenen IDE Protokolle zu finden:
software.aws.toolkits.jetbrains.services.codemodernizer
Codetransformationsprotokolle beginnen mit der vorhergehenden Zeichenfolge. Von generierte Protokolle 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
Gehen Sie wie folgt vorVS Code, um die vom Amazon Q Developer Agent for code transformation In ausgegebenen Protokolle zu finden:
-
Wählen Sie in der oberen Navigationsleiste „Ansicht“ und anschließend „Befehlspalette“.
-
Suchen Sie
Amazon Q: View Logs
in der angezeigten Befehlspalette. -
Die Protokolle werden in der geöffnetIDE. Verwenden Sie
CMD + F
oderCodeTransformation
, um in den Protokolldateien zu suchenControl + F
.
Logs zur Codetransformation VS Code haben das Präfix. CodeTransformation:
Im Folgenden finden Sie ein Beispiel VS Code für ein Protokoll, das aufgrund eines Fehlers beim Maven 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 Transformationsjob-ID?
Finden Sie Ihre Job-ID in JetBrains
Um eine Transformationsjob-ID in zu findenJetBrains, 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).