Condividi tramite


Guida introduttiva: Valutare ed eseguire la migrazione di un progetto Java usando la modernizzazione delle app Copilot di GitHub

Questa guida introduttiva illustra come usare la modernizzazione delle app Copilot di GitHub per valutare ed eseguire la migrazione di un progetto Java. In questa guida introduttiva si installa e si configura l'estensione, quindi si valuta ed esegue la migrazione di un progetto di esempio. Ad esempio, si usa un'attività predefinita per aggiornare una connessione al database SQL di Azure per usare l'identità gestita di Azure anziché un nome utente e una password.

Il video seguente illustra come la modernizzazione delle app Copilot di GitHub usa AppCAT per valutare un progetto Java per la migrazione ad Azure:


Prerequisites

Annotazioni

Se si usa Gradle, è supportato solo il wrapper Gradle versione 5+. Il linguaggio DSL (Domain Specific Language) di Kotlin non è supportato.

La funzione My Tasks non è ancora supportata per IntelliJ IDEA.

Aggiornare JDK e le versioni delle dipendenze

Esistono due modi per aggiornare la versione di JDK. Entrambe le modalità usano il riquadro della modernizzazione delle app di GitHub Copilot in Visual Studio Code, accessibile dalla barra laterale.

Un modo per aggiornare la versione di JDK consiste nel selezionare Aggiorna runtime e framework nella sezione Avvio rapido . Un altro modo consiste nell'eseguire l'attività Runtime Java aggiornata nella sezione ATTIVITÀ - Attività di aggiornamento . Per altre informazioni, vedere Guida introduttiva: aggiornare un progetto Java con la modernizzazione delle app Copilot di GitHub.

Screenshot di Visual Studio Code che mostra il riquadro di modernizzazione dell'app GitHub Copilot con le opzioni di aggiornamento evidenziate.

Per aggiornare Spring Framework o una dipendenza di terze parti, eseguire l'attività Aggiorna Java Framework nella sezione ATTIVITÀ - Attività di aggiornamento . Per altre informazioni, vedere Aggiornare un framework Java o una dipendenza di terze parti usando la modernizzazione delle app Copilot di GitHub.

Screenshot di Visual Studio Code che mostra il riquadro di modernizzazione della app GitHub Copilot con l'attività di aggiornamento del framework Java evidenziata.

Valutare l'idoneità al cloud

Usare la procedura seguente per avviare il processo di migrazione con la valutazione della soluzione. Questa valutazione consente di comprendere quali sono le sfide di idoneità per il cloud e il loro impatto. Fornisce anche soluzioni consigliate. Una raccomandazione per la soluzione include riferimenti per configurare le risorse di Azure, aggiungere configurazioni e apportare modifiche al codice.

  1. Clonare il repository di esempi di copilot per la migrazione Java e quindi eseguire il check-out nel ramo di origine .

  2. In Visual Studio Code aprire la cartella del progetto mi-sql-public-demo nel repository degli esempi.

  3. Nella barra laterale selezionare il riquadro di modernizzazione dell'app GitHub Copilot , in cui è possibile selezionare Esegui migrazione ad Azure o Esegui valutazione nella sezione ASSESSMENT .

    Screenshot di Visual Studio Code che mostra il riquadro di modernizzazione dell'app GitHub Copilot con i pulsanti Migrate to Azure and Run Assessment evidenziati.

  4. Viene aperta la finestra di chat di GitHub Copilot con la modalità agente per chiamare il valutatore di modernizzazione per eseguire la valutazione della modernizzazione delle app. Selezionare Continua per confermare.

  5. Il valutatore di modernizzazione apre ora appcat.log. Questo file mostra i log per l'esecuzione di AppCAT, che esegue la valutazione dell'app. Selezionare Continua per confermare di nuovo.

  6. Il valutatore di modernizzazione verifica prima l'ambiente locale. Se AppCAT e le relative dipendenze non sono installati, l'agente consente di installarli. Dopo l'installazione, l'agente chiama AppCAT per valutare il progetto corrente. Il completamento di questo passaggio potrebbe richiedere alcuni minuti.

  7. Al termine dell'analisi, il valutatore di modernizzazione produce una visualizzazione categorizzata dei problemi di idoneità al cloud in un report di valutazione aperto.

    Screenshot del riquadro di Visual Studio Code che mostra il report di valutazione.

  8. Quando si esamina il report di riepilogo, è possibile selezionare Esegui la migrazione al database SQL di Azure (Spring) dall'elenco delle soluzioni nell'elenco relativo alla migrazione del database (Microsoft SQL). Selezionare quindi Esegui attività per passare alla fase di correzione del codice.

    Screenshot del riquadro Problemi di Visual Studio Code che mostra l'opzione Esegui migrazione al database SQL di Azure con il pulsante Esegui attività evidenziato.

Applicare un'attività predefinita

Per la migrazione, Copilot fornisce attività predefinite per scenari di migrazione comuni che possono verificarsi durante la migrazione ad Azure. Ad esempio, con l'esempio mi-sql-public-demo , l'attività Migrazione del database (Microsoft SQL) modifica la connessione al database SQL di Azure per usare l'identità gestita di Azure anziché un nome utente e una password.

Per applicare un'attività predefinita, seguire questa procedura:

  1. Nel report di valutazione selezionare Esegui attività. Viene visualizzata la finestra della chat di Copilot con l'opzione Modalità agente selezionata.

  2. L'agente Copilot usa vari strumenti per la modernizzazione delle app e ogni strumento potrebbe richiedere conferma per continuare. plan.md e progress.md vengono generati per primi ed è possibile esaminare plan.md e apportare modifiche, se necessario.

  3. Inserisci manualmente continue per confermare e avviare il processo di migrazione.

  4. Prima di apportare modifiche al codice, l'agente controlla lo stato del sistema di controllo della versione e crea un nuovo ramo per la migrazione.

  5. Selezionare ripetutamente o immettere Continua per confermare l'uso di strumenti o comandi e attendere il completamento delle modifiche al codice.

Iterazione di convalida

Al termine delle modifiche al codice, inserisci manualmente continue per procedere con la convalida e per correggere il ciclo di iterazione. Questo ciclo include le cinque parti seguenti:

  • Applicare lo Validate-CVEs strumento. Questo strumento tenta di rilevare vulnerabilità ed esposizioni comuni nelle dipendenze correnti e le corregge.
  • Applicare lo Build-Project strumento. Questo strumento tenta di risolvere eventuali errori di compilazione.
  • Applicare lo Consistency-Validation strumento. Questo strumento analizza i codici per la coerenza funzionale.
  • Applicare lo Run-Test strumento. Questo strumento analizza il progetto per individuare gli errori di unit test e genera automaticamente un piano per correggerli. Lo Run-Test strumento esegue in modo iterativo unit test e corregge eventuali errori.
  • Applicare lo Completeness-Validation strumento. Questo strumento rileva gli elementi di migrazione mancanti nella migrazione del codice iniziale e li corregge.

Al termine di tutti i processi, l'input continua a generare il riepilogo della migrazione come passaggio finale. Esaminare le modifiche al codice e confermarle selezionando Mantieni.

Generare casi di test unitari

Per generare unit test case, seguire questa procedura:

  1. Nella barra laterale selezionare il riquadro di modernizzazione dell'app GitHub Copilot .

  2. Nella sezione ATTIVITÀ aprire Attività di qualità e sicurezza e quindi selezionare Genera unit test case.

L'agente genera unit test e crea un oggetto TestReport per visualizzare i risultati dei test prima e dopo la generazione. Per altre informazioni, vedere Avvio rapido: Generare unit test con la modernizzazione delle app Copilot di GitHub.

Passaggi successivi