Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Risoluzione dei problemi relativi alle trasformazioni Java
Le seguenti informazioni possono aiutarti a risolvere i problemi più comuni durante la trasformazione di applicazioni Java con Amazon Q Developer.
Argomenti
- Perché Amazon Q non può caricare il mio progetto?
- Perché sono i miei Maven comandi non riusciti?
- Come faccio ad aggiungere Maven al mio? PATH
- Perché Amazon Q non può creare il mio codice?
- Perché la mia trasformazione non è riuscita dopo 55 minuti?
- Perché non riesco a scaricare il mio codice trasformato?
- Come posso accedere ai log di trasformazione del codice?
- Come posso trovare l'ID del mio lavoro di trasformazione?
Perché Amazon Q non può caricare il mio progetto?
Se il caricamento del progetto non riesce, probabilmente è dovuto a uno dei seguenti problemi. Consulta l'argomento corrispondente all'errore visualizzato in Amazon Q.
Argomenti
Riduci le dimensioni del progetto
Per trasformare il codice, Amazon Q genera un elemento del progetto, che include il codice sorgente, le dipendenze del progetto e i log di compilazione. La dimensione massima degli artefatti del progetto per un processo di trasformazione è di 2 GB. Se viene visualizzato un errore relativo alla dimensione degli artefatti del progetto, è necessario ridurre le dimensioni del progetto o provare a trasformare un progetto più piccolo. È possibile visualizzare la dimensione del file degli artefatti del progetto nei registri di trasformazione del codice. Per ulteriori informazioni, consulta Come posso accedere ai log di trasformazione del codice?
Configura le impostazioni del proxy nel tuo IDE
Per trasformare il codice, Amazon Q carica l'elemento del progetto in un bucket Amazon S3 di proprietà del servizio. Parte del processo di caricamento prevede l'utilizzo TLS dei SSL nostri certificati per stabilire la comunicazione tra Amazon S3 e il tuo. IDE Se utilizzi un server proxy, i SSL TLS certificati utilizzati dal server proxy devono essere considerati affidabili, altrimenti Amazon Q non sarà in grado di caricare il tuo progetto.
Se ricevi un errore relativo al proxy o ai certificati, probabilmente dovrai configurare il tuo sistema operativo in modo che IDE consideri attendibili i certificati o aggiornare altre impostazioni del proxy.
Nota
Potresti inoltre riscontrare problemi non correlati ai certificati se utilizzi il server proxy o il firewall della tua organizzazione. Se completi le seguenti procedure per configurare i tuoi certificati e hai ancora problemi, contatta l'amministratore di rete per assicurarti di poter comunicare con Amazon S3 dal tuo. IDE Per ulteriori informazioni, consulta Consenti l'accesso ad Amazon S3.
Configura i certificati in JetBrains
Per configurare il tuo JetBrains IDEJava Runtime Environment (JRE) per considerare attendibili i TLS certificati SSL or utilizzati dal server proxy, è necessario importare i TLS certificati SSL or nel cacerts
file contenuto inJRE. Il cacerts
file è un file che contiene certificati root affidabili per connessioni sicure, come HTTPS eSSL, e fa parte delle impostazioni di sicurezza JRE del file. Per importare un certificato, completare la procedura seguente.
Nota
Si consiglia di eseguire un backup del cacerts
file prima di modificarlo, poiché eventuali errori possono causare problemi con le connessioni sicure.
-
Determina il percorso del
cacerts
file nel tuoJRE. Il percorso delcacerts
file interno JRE fornito con il tuo JetBrains IDEdipende dal sistema operativo e dalla versione di JetBrains IDEstai usando.Di seguito sono riportati alcuni esempi di percorsi del
cacerts
file nei sistemi operativi più comuni. Scegli il tuo sistema operativo per vedere degli esempi.Nota
<JetBrains Installation Folder>
si riferisce alla directory in cui JetBrains i prodotti sono installati. Questa directory viene in genere scelta durante il processo di installazione.La
jbr
cartella rappresenta il JRE pacchetto con JetBrains IDEs, che è una versione specifica del programma JRE su misura per l'uso con JetBrains IDEs. -
Determina il certificato da importare nel
cacerts
file. Il file del certificato ha in genere un'.der
estensione.cer
.crt
, o. Se non sei sicuro dei certificati da aggiungere, contatta l'amministratore di rete. -
Importa il certificato nel
cacerts
keystore. È possibile farlo con ilkeytool
comando Java.-
Aprire un prompt dei comandi e immettere il seguente comando:
keytool -import -alias <alias> -file <certificate_file> -keystore <path_to_cacerts>
-
È
<alias>
infatti possibile aggiungere un nome per il certificato che si sta importando per utilizzarlo in un secondo momento. Questa opzione è facoltativa. -
Per
<certificate_file>
, specifica il percorso del certificato che stai importando. Dovrebbe essere il percorso del.cer
.crt
, o il.der
file contenente il certificato. -
Per
<path_to_cacerts>
, specifica il percorso del filecacerts
keystore salvato nel passaggio 1. Questo è il file in cui stai importando il certificato.
Ad esempio, se desideri importare un certificato denominato
my_certificate.cer
nelcacerts
keystore del pacchetto JRE IntelliJ IDEA su Windows e desideri assegnare l'aliasmyalias
al certificato, il comando potrebbe essere:keytool -import -alias myalias -file my_certificate.cer -keystore "C:\Program Files\JetBrains\IntelliJ IDEA 2022.3.2\jbr\bin\cacerts"
-
-
Durante il processo di importazione, ti verrà richiesto di inserire la password del keystore. La password predefinita per il
cacerts
keystore è.changeit
-
Dopo aver eseguito il comando, ti verrà chiesto di considerare attendibile il certificato. Per confermare che il certificato è attendibile e completare l'importazione, inserisci
yes
. -
Potrebbe inoltre essere necessario aggiungere i certificati allo IDE stesso, oltre aJRE. Per ulteriori informazioni, consulta Certificati server
nel JetBrains documentazione.
Configurare i certificati in Visual Studio Code
Per configurare Visual Studio Code per considerare attendibili i TLS certificati SSL or utilizzati dal server proxy, assicurati di aver configurato le seguenti impostazioni proxy per il tuo sistema operativo.
Configura le seguenti impostazioni proxy per Visual Studio Code su macOS.
Aggiungi certificati al tuo portachiavi macOS
Se non l'hai già fatto, devi aggiungere i certificati utilizzati dal tuo server proxy al tuo macOS portachiavi. Per informazioni sull'aggiunta di certificati al portachiavi, consulta Aggiungere certificati a un portachiavi utilizzando Keychain Access su Mac nella Guida per l'utente di Keychain Access
Installa l'estensione Mac CA VSCode
L'VSCodeestensione Mac CA
Per installare l'estensione:
-
Cerca
mac-ca-vscode
in VS Code riquadro delle estensioni e scegli Installa. -
Restart (Riavvia) VS Code.
Aggiorna le impostazioni del proxy in VS Code su macOS
Aggiorna le seguenti impostazioni per assicurarti VS Code è configurato correttamente per il tuo proxy.
-
Apri le impostazioni in VS Code.
-
Inserire
proxy
nella barra di ricerca. -
Nel campo Http: Proxy, aggiungi il tuo proxyURL.
-
Deseleziona Http: Proxy Strict SSL.
-
Nell'elenco a discesa Http: Proxy Support, scegli attivo.
-
Nella barra di ricerca delle impostazioni, inserisci
http.experimental.systemCertificatesV2
. Seleziona Http › Experimental: System Certificates V2.
Configurare le seguenti impostazioni proxy per Visual Studio Code su Windows.
Aggiungi il certificato come certificato root attendibile su Windows
Se non l'hai già fatto, devi aggiungere i certificati utilizzati dal tuo server proxy all'archivio Trusted Root Certification Authorities in Windows. Per aggiungere un certificato, completare la procedura seguente:
-
Aprire lo strumento di ricerca o la finestra di comando Esegui.
-
Inserisci quanto segue per aprire lo strumento Certificate Manager:
certmgr.msc
-
Scegli l'archivio Trusted Root Certification Authorities.
-
Fai clic con il pulsante destro del mouse su Certificati, scegli Tutte le attività, quindi scegli Importa... .
-
Segui le istruzioni fornite per importare il tuo certificato proxy.
-
Dopo aver importato il certificato, conferma che il certificato è stato aggiunto.
Nell'archivio Trusted Root Certification Authorities, fai doppio clic su Certificati. Fai clic con il pulsante destro del mouse sul certificato aggiunto e scegli Proprietà. In Scopi del certificato, deve essere selezionata l'opzione Abilita tutti gli scopi per questo certificato.
Installa l'estensione Win-CA VSCode
L'VSCodeestensione Win-CA
Per installare l'estensione:
-
Cerca
win-ca
in VS Code riquadro delle impostazioni. -
Nell'elenco a discesa Inject, scegli aggiungi.
Aggiorna le impostazioni del proxy in VS Code su Windows
Aggiorna le seguenti impostazioni per assicurarti VS Code è configurato correttamente per il tuo proxy.
-
Apri le impostazioni in VS Code.
-
Inserire
proxy
nella barra di ricerca. -
Nel campo Http: Proxy, aggiungi il tuo proxyURL.
-
Deseleziona Http: Proxy Strict SSL.
-
Nell'elenco a discesa Http: Proxy Support, scegli attivo.
-
Nella barra di ricerca delle impostazioni, inserisci
http.experimental.systemCertificatesV2
. Seleziona Http › Experimental: System Certificates V2. -
Restart (Riavvia) VS Code.
Consenti l'accesso ad Amazon S3
Durante una trasformazione, Amazon Q carica il codice in un bucket Amazon S3 di proprietà del servizio. Se la tua rete o organizzazione non ha configurato l'accesso ad Amazon S3, Amazon Q non è in grado di caricare il tuo progetto.
Per garantire che Amazon Q possa caricare il tuo progetto, assicurati che la configurazione del proxy e gli altri componenti di rete, come le politiche di Data Lost Prevention (DLP), siano configurati per consentire l'accesso ad Amazon S3. Potrebbe inoltre essere necessario inserire nell'elenco delle autorizzazioni il bucket Amazon S3 in cui Amazon Q carica il progetto. Per ulteriori informazioni, consulta Perimetri di dati per le risorse Amazon Q.
Se trasformi un progetto di grandi dimensioni, DLP le policy o altri componenti di rete potrebbero causare ritardi e impedire il corretto caricamento se non sono configurati per inserire nella lista consentita il bucket Amazon S3. Se scegli di non inserire il bucket nella lista consentita, potresti dover trasformare un progetto più piccolo in modo che Amazon Q possa caricarlo.
Perché sono i miei Maven comandi non riusciti?
Di seguito sono Maven problemi di configurazione che potresti riscontrare in JetBrains e Visual Studio Code IDEs. Se risolvi i problemi e continui a vedere Maven errori, potrebbe esserci un problema con il tuo progetto. Utilizza le informazioni contenute nei log degli errori per risolvere eventuali problemi relativi al progetto, quindi prova a trasformare nuovamente il progetto.
Aggiornamento Maven configurazione in JetBrains
Se una trasformazione fallisce JetBrains a causa di Maven problemi relativi ai comandi, i log degli errori vengono visualizzati nella scheda Esegui. Utilizza le informazioni nei log per risolvere il problema. Di seguito sono riportati alcuni problemi che potresti dover risolvere:
-
Assicurati che il tuo Maven il percorso principale è impostato su Bundled. Vai a Impostazioni, quindi espandi la sezione Build, Execution, Deployment. Espandi la sezione Build Tools, quindi espandi Maven. Nell'elenco a discesa del percorso principale di Maven, scegli Bundled.
-
Assicurati che Java runtime environment (JRE) sta usando il tuo progettoJDK. Vai su Impostazioni, quindi espandi la sezione Build, Execution, Deployment. Espandi Mavene scegli Runner. Nell'elenco a JREdiscesa, scegli Usa progetto. JDK
-
Assicurati che Maven è abilitato. Vai su Impostazioni e scegli Plugin. Cerca Maven e scegli il Maven . Se vedi un pulsante Abilita, sceglilo per abilitarlo Maven.
Aggiornamento Maven configurazione in Visual Studio Code
Se una trasformazione fallisce VS Code a causa di Maven problemi di comando, un file di testo che contiene i log degli errori si apre in una nuova scheda. Utilizza le informazioni contenute nei log per risolvere il problema.
Assicurati di aver configurato una delle seguenti opzioni:
-
Il progetto contiene un Maven wrapper nella cartella principale del progetto
-
Una versione di Maven supportato da Amazon Q è disponibile sul tuo
PATH
Per ulteriori informazioni, consulta Come faccio ad aggiungere Maven al mio? PATH
Come faccio ad aggiungere Maven al mio? PATH
Per trasformare il tuo codice in VS Code senza usare un Maven wrapper, è necessario installare Maven e aggiungilo alla tua PATH
variabile.
Per verificare se lo hai Maven già installato correttamente, eseguilo mvn -v
in un nuovo terminale del sistema operativo esterno a Visual Studio Code. Dovresti vedere un output con il tuo Maven versione.
Se ottieni un output nel tuo Visual Studio Code terminale ma non nel terminale del sistema operativo, o se il comando non viene trovato, è necessario aggiungere Maven al tuoPATH
.
Per aggiungere Maven al tuoPATH
, segui le istruzioni relative alla tua macchina.
Perché Amazon Q non può creare il mio codice?
Se la trasformazione fallisce durante la creazione del codice da parte di Amazon Q, il progetto potrebbe non essere configurato correttamente per l'ambiente in cui Amazon Q crea il codice. Potrebbe essere necessario aggiornare la configurazione della build o l'implementazione del codice.
Esamina l'output del log di compilazione fornito da Amazon Q per determinare se ci sono modifiche che puoi apportare al tuo progetto. Di seguito sono riportati alcuni problemi comuni che potrebbero impedire ad Amazon Q di creare il codice.
Rimuovi i percorsi assoluti in pom.xml
Se hai un percorso assoluto nel tuo file pom.xml, Amazon Q non sarà in grado di trovare i file pertinenti e, di conseguenza, potrebbe non essere in grado di creare il tuo codice.
Di seguito è riportato un esempio di percorso assoluto che potresti avere nel tuo pom.xml
file:
<toolspath> <path>/Library/Java/JavaVirtualMachines/jdk-11.0.11.jdk/Contents/Home/lib/tools.jar</path> </toolspath>
Invece di utilizzare un percorso assoluto, potete creare un percorso relativo utilizzando un puntatore. Di seguito è riportato un esempio di come è possibile sostituire il percorso assoluto precedente con un percorso relativo:
<toolspath> <path>${java.home}/../lib/tools.jar</path> </toolspath>
Rimuovi i database locali o esterni nei test unitari
Amazon Q esegue tutti i test unitari del tuo progetto quando crea il codice. Se un test unitario richiama un database locale o esterno, Amazon Q non avrà accesso al database, causando il fallimento della compilazione. Per evitare che la compilazione fallisca, devi rimuovere la chiamata al database dallo unit test o rimuovere lo unit test prima di inviare la trasformazione.
Perché la mia trasformazione non è riuscita dopo 55 minuti?
Se il processo di trasformazione del codice fallisce dopo 55 minuti, è probabile che il tempo di compilazione del codice superi il limite di compilazione. Attualmente esiste un limite di tempo di 55 minuti per la creazione del codice.
Se il tempo di compilazione locale richiede 55 minuti o più, riduci il tempo di compilazione del progetto per trasformare il codice. Se la compilazione locale è più veloce di quella con Code Transformation, controlla se nel progetto sono presenti attività che potrebbero non riuscire o richiedere più tempo in un ambiente diverso. Prendi in considerazione la possibilità di disabilitare i casi di test di lunga durata. Valuta anche la possibilità di utilizzare dei timeout per i tentativi di accesso a risorse che potrebbero non essere disponibili IDE nell'ambiente sicuro o in Internet.
Perché non riesco a scaricare il mio codice trasformato?
Se non riesci a scaricare il codice una volta completata la trasformazione, probabilmente è dovuto a uno dei seguenti problemi. Consulta l'argomento corrispondente all'errore visualizzato in Amazon Q.
Argomenti
Riduci le dimensioni del progetto
Una volta completata la trasformazione, Amazon Q genera un elemento di output che contiene una differenza con il codice aggiornato e un riepilogo della trasformazione con informazioni sulle modifiche apportate. L'elemento di output deve essere pari o inferiore a 1 GB per poterlo scaricare. IDE
Se l'artefatto di output supera il limite, non sarà possibile scaricare il codice aggiornato o il riepilogo della trasformazione. Prova a trasformare un progetto più piccolo per evitare un artefatto di output di grandi dimensioni. Se il problema persiste, contatta. Support Per informazioni su come contattare Support Amazon Q, consultaUtilizzo di Amazon Q Developer per chattare con Support.
Scarica il codice diff entro 24 ore
Il file code diff con il codice aggiornato è disponibile solo per 24 ore dopo il completamento della trasformazione. Se sono trascorse più di 24 ore dal completamento della trasformazione, riavvia la trasformazione per scaricare il file diff.
Configura le impostazioni proxy nel tuo IDE
Amazon Q scarica il codice aggiornato da un bucket Amazon S3 di proprietà del servizio. Parte del processo di download prevede l'utilizzo TLS dei SSL nostri certificati per stabilire una comunicazione tra Amazon S3 e il tuo. IDE Se utilizzi un server proxy, i SSL TLS certificati utilizzati dal server proxy devono essere considerati affidabili, altrimenti Amazon Q non sarà in grado di caricare il tuo progetto.
Per scaricare il codice, potrebbe essere necessario configurare i certificati IDE di attendibilità o aggiornare altre impostazioni proxy. Per ulteriori informazioni sull'aggiornamento delle impostazioni del proxy, consultaConfigura le impostazioni del proxy nel tuo IDE.
Rimuovi i caratteri jolly in JetBrains impostazioni proxy
Se hai configurato le impostazioni proxy nel JetBrains IDE, potresti visualizzare il seguente errore durante il download del codice aggiornato:
software.amazon.awssdk.core.exception.SdkClientException: Unable to execute HTTP request: Dangling meta character '*' near index 0
Ciò è probabilmente causato dalla presenza di un carattere jolly (*) nel campo Nessun proxy for delle impostazioni proxy IDE dell'utente. Il codice Java SDK utilizzato da Amazon Q non supporta le voci con caratteri jolly in questo campo.
Per scaricare il codice, rimuovi eventuali caratteri jolly dal campo Nessun proxy for, quindi riavvia il file. IDE Se devi specificare gli host che devono ignorare il proxy, usa un'espressione regolare anziché un jolly. Per aggiornare le impostazioni del proxy nel tuo computer JetBrains IDE, consulta HTTPProxy
Come posso accedere ai log di trasformazione del codice?
Accedi ai log in JetBrains
Per informazioni su come accedere JetBrains file di registro, vedere Individuazione dei file di IDE registro
Per trovare i log emessi da Amazon Q in JetBrains, cerca nei IDE log la seguente stringa:
software.aws.toolkits.jetbrains.services.codemodernizer
I log di trasformazione del codice iniziano con la stringa precedente. Registri generati da Maven vengono visualizzati nella scheda Esegui e hanno la stringa precedente prima e dopo la voce del registro.
Accedi ai log in Visual Studio Code
Per trovare i log emessi da Amazon Q in VS Code, completa i seguenti passaggi:
-
Scegli Visualizza nella barra di navigazione in alto, quindi scegli Command Palette.
-
Cerca
Amazon Q: View Logs
nella palette dei comandi che appare. -
I registri si aprono in. IDE Per cercare nei file di registro
CodeTransformation
, usaCMD + F
oControl + F
.
La trasformazione del codice effettua l'accesso VS Code hanno il prefisso. CodeTransformation:
Di seguito è riportato un esempio di registro generato in VS Code per un Maven errore di copia delle dipendenze:
2024-02-12 11:29:16 [ERROR]: CodeTransformation: Error in running Maven copy-dependencies command mvn = /bin/sh: mvn: command not found
Come posso trovare l'ID del mio lavoro di trasformazione?
Trova il tuo ID di lavoro in JetBrains
Per trovare un ID del lavoro di trasformazione in JetBrains, vai alla scheda Dettagli della trasformazione in Transformation Hub e scegli l'icona Mostra stato del lavoro (orologio).
Trova il tuo ID di lavoro in Visual Studio Code
Per trovare un ID del lavoro di trasformazione in VS Code, vai al Transformation Hub e scegli l'icona Mostra stato del lavoro (orologio).