Trasformazione di codice con Amazon Q Developer in GitHub
Nota
Amazon Q Developer per GitHub è disponibile nella versione di anteprima ed è soggetto a modifiche.
Con la funzionalità di trasformazione del codice, puoi aggiornare lo stack tecnologico, migliorare le prestazioni e garantire la compatibilità futura, preservando al contempo le funzionalità di base del codice esistente. Con Amazon Q Developer, puoi evitare il debito tecnico e creare applicazioni per la sostenibilità e la scalabilità a lungo termine.
Quando aggiungi l’etichetta di trasformazione del codice a un problema o utilizzi il comando slash /q transform, Amazon Q Developer trasforma il codice dalla versione Java 8 o 11 alla versione 17. Amazon Q Developer crea quindi una richiesta pull con le modifiche e il riepilogo delle modifiche che puoi unire alla tua linea principale.
Puoi fare in modo che Amazon Q Developer esegua una trasformazione del codice un numero limitato di volte al mese. Puoi aumentare l’utilizzo gratuito in qualsiasi momento registrando l’installazione dell’app Amazon Q Developer con il tuo account AWS. Per ulteriori informazioni, consulta Aumento dei limiti di utilizzo e dei dettagli di configurazione nella console Amazon Q Developer.
Prerequisiti
Prima di trasformare la tua codebase con Amazon Q Developer, considera i seguenti requisiti:
-
Assicurati che il tuo repository GitHub abbia GitHub Actions abilitato. Per ulteriori informazioni, consulta Understanding GitHub Actions
e Enabling a workflow nella documentazione di GitHub. -
Crea e configura il tuo file di flusso di lavoro nella directory
.github/workflows/per gestire le attività di trasformazione del codice. Per ulteriori informazioni, consulta Personalizzazione di un flusso di lavoro per la trasformazione di codice.
Dopo aver soddisfatto i prerequisiti, puoi applicare l’etichetta Agente di trasformazione Amazon Q e aggiornare la codebase nel tuo repository GitHub.
Importante
L’app Amazon Q Developer tenta di creare automaticamente le etichette Agente di sviluppo Amazon Q e Agente di trasformazione Amazon Q nei repository GitHub a cui hai autorizzato l’accesso. Se le etichette non vengono create automaticamente o se vengono eliminate involontariamente, puoi crearle manualmente in GitHub. Le etichette devono essere denominate come Agente di sviluppo Amazon Q e Agente di trasformazione Amazon Q per essere riconosciute ed elaborate come etichette di Amazon Q Developer. Per ulteriori informazioni, consulta Creating a label
Per aggiornare la tua codebase
-
Se necessario, accedi al tuo account GitHub
utilizzando le credenziali GitHub. -
Vai alla tua organizzazione GitHub, quindi vai al repository in cui desideri trasformare la tua codebase.
-
Scegli Problemi, quindi crea un nuovo problema. Per ulteriori informazioni, consulta Create an issue
nella documentazione di GitHub. -
Nel campo di immissione del testo Aggiungi un titolo, inserisci un titolo che fornisca un contesto ad Amazon Q Developer per la trasformazione del codice (esempio: “Aggiorna codebase”). È inoltre necessario includere la descrizione del problema in quanto fornisce anche un contesto.
-
Quando crei un problema o configuri un problema esistente, puoi applicare l’etichetta Amazon Q Developer per la trasformazione del codice o utilizzare il comando slash
/q transform. Esegui una di queste operazioni:-
Per applicare l’etichetta al problema, procedi in uno dei seguenti modi:
-
Scegli il menu a discesa Assegna ad Amazon Q fornito come estensione del browser, quindi scegli l’etichetta Amazon Q transform agent.
-
Nel menu a destra, scegli Etichette, quindi scegli l’etichetta Amazon Q transform agent.
-
-
Per utilizzare il comando slash
/q transformin un commento:-
All’interno del problema, vai su Aggiungi un commento e nel campo di immissione del testo del commento, inserisci
/q transform. -
Scegliere Comment (Commento).
-
-
-
Scegli Crea problema per completare la creazione del problema con i dettagli necessari ad Amazon Q Developer per trasformare il codice.
Quando Amazon Q Developer termina di generare le modifiche al codice per lo sviluppo delle funzionalità, commenta il problema e apre una richiesta pull.
-
Vai al commento lasciato da Amazon Q Developer (esempio: “
I finished upgrading your code and opened a pull request: Resolve Upgrade codebase.“), quindi scegli il link della richiesta pull.Puoi anche accedere alla scheda Richiesta pull e quindi scegliere la richiesta pull creata da Amazon Q Developer.
-
Scegli la scheda File modificati per visualizzare le modifiche.
-
Se le modifiche al codice suggerite ti soddisfano, puoi unire la richiesta pull. Per ulteriori informazioni, consulta Merge a pull request
.
Amazon Q Developer lascia un commento che fornisce un riepilogo della trasformazione con dettagli relativi ai file aggiornati. Puoi trovare il riepilogo nel file build_logs.txt fornito nel commento. Se Amazon Q Developer non è in grado di eseguire una trasformazione completa del codice, fornisce anche un riepilogo degli errori che hanno impedito la trasformazione completa.