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 con le trasformazioni Java
Le seguenti informazioni possono aiutare a risolvere i problemi più comuni durante la trasformazione delle applicazioni Java con Amazon Q Developer.
Argomenti
Perché Amazon Q non riesce a caricare il mio progetto?
Se il progetto non viene caricato, è probabile che sia dovuto a uno dei seguenti problemi. Consulta l’argomento che corrisponde all’errore visualizzato in Amazon Q.
Argomenti
Riduci le dimensioni del progetto
Per trasformare il codice, Amazon Q genera un artefatto del progetto, che include il codice sorgente, le dipendenze del progetto e i log delle build. La dimensione massima degli artefatti del progetto per un processo di trasformazione è di 2 GB. Se viene visualizzato un errore relativo alla dimensione dell’artefatto del progetto, è necessario ridurre le dimensioni del progetto o provare a trasformare un progetto più piccolo. È possibile visualizzare la dimensione del file dell’artefatto del progetto nei log di trasformazione del codice. Per ulteriori informazioni, consulta Come si accede ai log di trasformazione del codice?
Configura le impostazioni del proxy nell’IDE
Per trasformare il codice, Amazon Q carica l’artefatto del progetto in un bucket Amazon S3 di proprietà del servizio. Parte del processo di caricamento prevede l’utilizzo di certificati SSL o TLS per stabilire la comunicazione tra Amazon S3 e il tuo IDE. Se utilizzi un server proxy, i certificati SSL o TLS utilizzati dal tuo server proxy devono essere attendibili, 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 l’IDE o il sistema operativo in modo che i certificati siano attendibili o che aggiorni 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 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 l’ambiente di runtime Java (JRE) dell’IDE di JetBrains in modo che consideri attendibili i certificati SSL o TLS utilizzati dal server proxy, è necessario importare i certificati SSL o TLS nel file cacerts in JRE. Il file cacerts che contiene certificati root attendibili per connessioni sicure come HTTPS e SSL e fa parte delle impostazioni di sicurezza di JRE. Per importare un certificato, completa la procedura seguente.
Nota
Si raccomanda di eseguire un backup del file cacerts prima di modificarlo, poiché eventuali errori possono causare problemi con le connessioni sicure.
-
Determina il percorso del file
cacertsin JRE. Il percorso del filecacertsnel JRE interno fornito con l’IDE di JetBrains dipende dal sistema operativo e dalla versione dell’IDE di JetBrains in uso.Di seguito sono riportati alcuni esempi di percorsi del file
cacertsnei sistemi operativi più comuni. Scegli il sistema operativo per vedere degli esempi.Nota
<JetBrains Installation Folder>si riferisce alla directory in cui sono installati i prodotti JetBrains. In genere, questa directory viene scelta durante il processo di installazione.La
jbrcartella rappresenta il pacchetto JRE fornito con JetBrains IDEs, che è una versione specifica di JRE personalizzata per l'uso con. JetBrains IDEs -
Determina il certificato da importare nel file
cacerts. Il file del certificato ha in genere un’estensione di file.cer,.crto.der. Se non sei sicuro dei certificati da aggiungere, contatta l’amministratore di rete. -
Importa il certificato firmato nel keystore
cacerts. È possibile farlo tramite il comandokeytooldi Java.-
Apri un prompt dei comandi e inserisci il comando seguente:
keytool -import -alias <alias> -file <certificate_file> -keystore <path_to_cacerts> -
Per
<alias>, puoi infatti aggiungere un nome per il certificato che stai 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 file.cer,.crto.dercontenente il certificato. -
Per
<path_to_cacerts>, specificare il percorso del file keystorecacertssalvato nella fase 1. Questo è il file in cui stai importando il certificato.
Ad esempio, se desideri importare un certificato denominato
my_certificate.cernel keystorecacertsdel pacchetto JRE incluso in IntelliJ IDEA su Windows e desideri assegnare l’aliasmyaliasal 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 keystore
cacertsè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 all’IDE stesso, oltre al JRE. Per ulteriori informazioni, consulta Certificati server
nella documentazione di JetBrains.
Configura i certificati in Visual Studio Code
Per configurare Visual Studio Code in funzione dell’attendibilità dei certificati SSL o TLS utilizzati dal server proxy, assicurati di aver configurato le seguenti impostazioni proxy per il sistema operativo.
Configura le seguenti impostazioni proxy per Visual Studio Code in macOS.
Aggiungi certificati al tuo portachiavi macOS
Se non l’hai già fatto, devi aggiungere i certificati utilizzati dal server proxy al tuo portachiavi macOS. Per informazioni sull’aggiunta di certificati al portachiavi, consulta Aggiungere certificati a un portachiavi utilizzando Accesso Portachiavi sul Mac
Installa l'estensione Mac CA VSCode
L' VSCode estensione Mac CA
Per installare l’estensione:
-
Cerca
mac-ca-vscodenel pannello delle estensioni di VS Code e scegli Installa. -
Riavviare VS Code.
Aggiorna le impostazioni del proxy in VS Code in macOS
Aggiorna le seguenti impostazioni per assicurarti che VS Code sia configurato correttamente per il proxy.
-
Apri le impostazioni in VS Code.
-
Inserire
proxynella barra di ricerca. -
Nel campo Http: Proxy, aggiungi l’URL del proxy.
-
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.
Configura 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 server proxy all’archivio Certificati delle autorità di certificazione radice attendibili in Windows. Per creare un certificato, completa la procedura seguente:
-
Apri lo strumento di ricerca o la finestra di comando Esegui.
-
Inserisci il comando seguente per aprire lo strumento Gestione certificati:
certmgr.msc -
Scegli l’archivio Certificati delle autorità di certificazione radice attendibili.
-
Fai clic con il pulsante destro del mouse su Certificati scegli Tutte le attività e quindi Importa.
-
Segui le istruzioni fornite per importare il certificato proxy.
-
Dopo aver importato il certificato, conferma che è stato aggiunto.
Nell’archivio Certificati delle autorità di certificazione radice attendibili 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' VSCode estensione Win-CA
Per installare l’estensione:
-
Cerca
win-canel pannello delle impostazioni di VS Code. -
Nell’elenco a discesa Inserisci, scegli aggiungi.
Aggiorna le impostazioni del proxy in Windows VS Code
Aggiorna le seguenti impostazioni per assicurarti che VS Code sia configurato correttamente per il proxy.
-
Apri le impostazioni in VS Code.
-
Inserire
proxynella barra di ricerca. -
Nel campo Http: Proxy, aggiungi l’URL del proxy.
-
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. -
Riavviare 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 progetto.
Per garantire che Amazon Q possa caricare il progetto, assicurati che la configurazione del proxy e gli altri componenti di rete, come le policy di prevenzione della perdita dei dati (DLP), siano configurati per consentire l’accesso ad Amazon S3. Potrebbe anche essere necessario creare un elenco dei bucket Amazon S3 consentiti in cui Amazon Q carica il progetto. Per ulteriori informazioni, consulta Bucket URLs Amazon S3 e elenco dei dati consentiti ARNs .
Se trasformi un progetto di grandi dimensioni, le policy DLP o altri componenti di rete potrebbero causare ritardi e impedire il corretto caricamento se non sono configurati per inserire nell’elenco degli elementi consentiti il bucket Amazon S3. Se scegli di non inserire il bucket nell’elenco degli elementi consentiti, potresti dover trasformare un progetto più piccolo in modo che Amazon Q possa caricarlo.
Perché i miei comandi Maven non riescono?
Di seguito sono riportati i problemi di Maven configurazione che potresti riscontrare nella JetBrains e. Visual Studio Code IDEs Se risolvi i problemi e riscontri ancora degli errori Maven, il problema potrebbe riguardare il progetto. Utilizza le informazioni contenute nei log degli errori per risolvere eventuali problemi relativi al progetto, quindi prova a trasformarlo nuovamente.
Aggiorna la configurazione di Maven in JetBrains
Se una trasformazione non riesce in JetBrains a causa di problemi con il comando Maven, 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 percorso Maven principale sia impostato su In bundle. Nella finestra di dialogo Impostazioni, espandi la sezione Creazione, esecuzione e implementazione. Espandi la sezione Strumenti di creazione, quindi espandi Maven. Nell’elenco a discesa del percorso principale di Maven, scegli In bundle.
-
Assicurati che l’ambiente di runtime Java (JRE) utilizzi il tuo progetto JDK. Nella finestra di dialogo Impostazioni, espandi la sezione Creazione, esecuzione e implementazione. Espandi Maven e scegli Runner. Nell’elenco a discesa JRE, scegli Usa progetto JDK.
-
Assicurati che Maven sia abilitato. Vai su Impostazioni e scegli Plugin. Cerca Maven e quindi seleziona il plugin Maven. Se vedi un pulsante Abilita, sceglilo per abilitare Maven.
Aggiorna la configurazione di Maven in Visual Studio Code
Se una trasformazione non riesce in VS Code a causa di problemi con il comando Maven, si apre un file di testo contenente i log degli errori in una nuova scheda. Utilizza le informazioni nei log per risolvere il problema.
Assicurati di configurare una delle seguenti opzioni:
-
Il progetto contiene un wrapper Maven nella cartella root del progetto
-
Una versione di Maven supportata da Amazon Q è disponibile su
PATH
Per ulteriori informazioni, consulta Come faccio ad aggiungere Maven al mio PATH?
Come faccio ad aggiungere Maven al mio PATH?
Per trasformare il codice in VS Code senza utilizzare un wrapper Maven, è necessario installare Maven e aggiungerlo alla variabile PATH.
Per verificare se l’installazione di Maven è già stata eseguita correttamente, esegui mvn -v in un nuovo terminale del sistema operativo esterno a Visual Studio Code. Dovresti vedere un output con la tua versione di Maven.
Se ottieni un output nel terminale di Visual Studio Code ma non nel terminale del sistema operativo, o se il comando non viene trovato, devi aggiungere Maven a PATH.
Per aggiungere Maven a PATH, segui le istruzioni del tuo computer.
Perché Amazon Q non riesce a creare il mio codice?
Se la trasformazione non riesce 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 della build fornita da Amazon Q per determinare se sono presenti delle modifiche che puoi apportare al 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 è presente 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 codice.
Di seguito è riportato un esempio di percorso assoluto che potresti ritrovare nel tuo file pom.xml:
<toolspath> <path>/Library/Java/JavaVirtualMachines/jdk-11.0.11.jdk/Contents/Home/lib/tools.jar</path> </toolspath>
Invece di utilizzare un percorso assoluto, puoi 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 di unità
Amazon Q esegue tutti i test di unità del tuo progetto quando crea il codice. Se un test di unità richiama un database locale o esterno, Amazon Q non avrà accesso al database, causando un errore di compilazione. Per evitare che la compilazione non riesca, devi rimuovere la chiamata al database dal test di unità o rimuovere il test di unità prima di inviare la trasformazione.
Perché la mia trasformazione non è riuscita dopo 55 minuti?
Se il processo di trasformazione del codice non riesce dopo 55 minuti, è probabile che il tempo di compilazione del codice superi il limite di compilazione. Attualmente è previsto 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 effettuata con Trasformazione del codice, 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 nell’ambiente IDE sicuro o su Internet.
Perché non riesco a scaricare il mio codice trasformato?
Se non riesci a scaricare il codice dopo il completamento della trasformazione, probabilmente si tratta di uno dei seguenti problemi. Consulta l’argomento che corrisponde all’errore visualizzato in Amazon Q.
Argomenti
Riduci le dimensioni del progetto
Una volta completata la trasformazione, Amazon Q genera un artefatto di output che contiene un diff con il codice aggiornato e un riepilogo della trasformazione con informazioni sulle modifiche apportate. L’artefatto di output deve essere pari o inferiore a 1 GB per consentire all’IDE di scaricarlo.
Se l’artefatto di output supera il limite, non sarai in grado di 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 Supporto. Per informazioni su come contattare Supporto Amazon Q, consultaUtilizzo di Amazon Q Developer per chattare con Supporto.
Scarica il codice diff entro 30 giorni
Il file code diff con il codice aggiornato è disponibile solo per 30 giorni dopo il completamento della trasformazione. Se sono trascorsi più di 30 giorni dal completamento della trasformazione, riavvia la trasformazione per scaricare il file diff.
Configura le impostazioni del proxy nell’IDE
Amazon Q scarica il codice aggiornato da un bucket Amazon S3 di proprietà del servizio. Parte del processo di download prevede l’utilizzo di certificati SSL o TLS per stabilire la comunicazione tra Amazon S3 e il tuo IDE. Se utilizzi un server proxy, i certificati SSL o TLS utilizzati dal tuo server proxy devono essere attendibili, altrimenti Amazon Q non sarà in grado di caricare il tuo progetto.
Per scaricare il codice, potrebbe essere necessario configurare l’IDE in modo che consideri attendibili i certificati o aggiornare altre impostazioni del proxy. Per ulteriori informazioni o per l’aggiornamento delle impostazioni del proxy, consulta Configura le impostazioni del proxy nell’IDE.
Rimuovi i caratteri jolly nelle impostazioni proxy di JetBrains
Se hai configurato le impostazioni proxy nell’IDE di JetBrains, 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 per delle impostazioni proxy dell’IDE. L’SDK Java 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 per, quindi riavvia l’IDE. Se devi specificare degli host che devono ignorare il proxy, usa un’espressione regolare anziché un jolly. Per aggiornare le impostazioni del proxy nel tuo JetBrains IDE, consulta Proxy HTTP
Come si accede ai log di trasformazione del codice?
Log di accesso in JetBrains
Per informazioni su come accedere ai file di log di JetBrains, consulta Locating IDE log files
Per trovare i log emessi da Amazon Q in JetBrains, cerca nei log IDE la seguente stringa:
software.aws.toolkits.jetbrains.services.codemodernizer
I log di trasformazione del codice iniziano con la stringa precedente. I log generati da Maven vengono visualizzati nella scheda Esegui e presentano la stringa precedente prima e dopo la voce di log.
Log di accesso in Visual Studio Code
Per trovare i log emessi da Amazon Q in VS Code, completa le fasi seguenti:
-
Scegli Visualizza nella barra di navigazione in alto, quindi scegli Tavolozza dei comandi.
-
Cerca
Amazon Q: View Logsnella tavolozza dei comandi che appare. -
I log si aprono nell’IDE. Per cercare i file di log in
CodeTransformation, usaCMD + FoControl + F.
I log della trasformazione del codice in VS Code hanno il prefisso CodeTransformation:. Di seguito è riportato un esempio di log generato in VS Code per un errore relativo alle dipendenze di copia di Maven:
2024-02-12 11:29:16 [ERROR]: CodeTransformation: Error in running Maven copy-dependencies command mvn = /bin/sh: mvn: command not found
Come trovo l’ID del processo di trasformazione?
Trova l’ID del processo in JetBrains
Per trovare un ID del processo di trasformazione in JetBrains, vai alla scheda Dettagli trasformazione nell’Hub trasformazione e scegli l’icona Mostra stato del processo (clock).
Trova l’ID del processo in Visual Studio Code
Per trovare un ID del processo di trasformazione in VS Code, vai all’Hub trasformazione e scegli l’icona Mostra stato del processo (clock).