Condividi tramite

Guida introduttiva: Installare e usare l'agente di modernizzazione di GitHub Copilot

Questa guida introduttiva illustra come installare l'agente di modernizzazione di GitHub Copilot e usarlo per modernizzare un'applicazione di esempio.

Prerequisiti

  • Sottoscrizione di GitHub Copilot: piano Gratuito, Pro, Pro+, Business o Enterprise. Vedere Piani di Copilot.
  • Interfaccia della riga di comando di GitHub: installare l'interfaccia della riga di comando di GitHub (gh) per l'autenticazione v2.45.0 o versione successiva. Vedere Installazione di gh.

Requisiti di piattaforma

  • Windows: x64 o ARM64.
  • Linux: x64 o ARM64 con glibc 2.27 o versione successiva (Ubuntu 18.04 o versione successiva, Debian 10 o versione successiva, Fedora 29 o versione successiva, Azure Linux 2.0 o versione successiva).
  • macOS: Apple Silicon o Intel.

Installare l'agente di modernizzazione

Usare i comandi seguenti per installare l'agente di modernizzazione o eseguire l'aggiornamento alla versione più recente.

Usare una delle opzioni seguenti:

Opzione 1 - Winget (scelta consigliata):

winget install GitHub.Copilot.modernization.agent

Per l'installazione invisibile all'utente senza richieste:

winget install GitHub.Copilot.modernization.agent --silent

Opzione 2 - PowerShell one-liner:

iex (irm 'https://raw.githubusercontent.com/microsoft/modernize-cli/main/scripts/install.ps1')

Opzione 3 - Programma di installazione MSI:

Scarica ed esegui l'MSI più recente dalla pagina delle versioni di GitHub.

Annotazioni

Dopo l'installazione, aprire un nuovo terminale affinché il modernize comando sia disponibile nel percorso. Questi comandi funzionano sia per l'installazione iniziale che per l'aggiornamento alla versione più recente. Un comando di aggiornamento della versione dedicato sarà disponibile in una versione futura.

Verificare l'installazione:

modernize --version

Ottenere un'applicazione di esempio

Per questa guida introduttiva, usare un'applicazione di esempio. Scegliere Java o .NET:

git clone https://github.com/Azure-Samples/PhotoAlbum-Java.git
cd PhotoAlbum-Java
git checkout -b modernize

Usare la modalità interattiva

Il modo più semplice per iniziare consiste nell'usare la modalità interattiva. Prima di tutto, eseguire l'autenticazione usando l'interfaccia della riga di comando di GitHub:

gh auth login

Quindi, eseguire l'agente di modernizzazione:

modernize

Viene visualizzato il menu principale:

○ How would you like to modernize your Java app?

  > 1. Assess application
       Analyze the project and identify modernization opportunities
    2. Create modernization plan
       Generate a structured plan to guide the agent
    3. Execute modernization plan
       Run the tasks defined in the modernization plan

Passaggio 1: Valutare l'applicazione

  1. Selezionare 1. Valutare l'applicazione.
  2. Seguire le istruzioni per configurare le opzioni di valutazione oppure premere INVIO per usare le impostazioni predefinite.
  3. Esaminare le selezioni e premere INVIO per avviare la valutazione.
  4. Attendere il completamento della valutazione.

I risultati della valutazione vengono salvati .github\modernize\assessment\ nella directory del progetto. L'agente analizza il codice, le dipendenze e la configurazione per identificare:

  • Versioni obsolete del framework
  • API deprecate
  • Problemi di compatibilità del cloud
  • Opportunità di migrazione

Passaggio 2: Creare un piano di modernizzazione

Al termine della valutazione, l'agente chiede di creare un piano di modernizzazione in base ai problemi identificati:

○ How would you like to continue?

  > 1. Create modernization plan
       Generate a plan.md file according to the identified issues
    2. Return to main menu
  1. Selezionare 1. Creare un piano di modernizzazione.
  2. Immettere un nome di piano o premere INVIO per usare il nome predefinito.
  3. Immettere l'obiettivo di modernizzazione come richiesta. Per impostazione predefinita, il prompt è References the assessment summary and creates plan per creare un piano basato sui risultati della valutazione. È possibile sostituirlo con qualsiasi altra richiesta di migrazione, ad esempio:
    • migrate the database to Azure PostgreSQL
    • upgrade to Spring Boot 3
    • deploy to Azure Container Apps
  4. Premere INVIO per generare il piano.

L'agente analizza la codebase e genera:

  • File di piano (.github/modernize/{plan-name}/plan.md): strategia e approccio dettagliati.
  • Elenco attività (.github/modernize/{plan-name}/tasks.json): suddivisione dei passaggi eseguibili.

Suggerimento

È possibile modificare plan.md manualmente per aggiungere chiarimenti o modificare i dettagli. È anche possibile aggiornare tasks.json per modificare, riordinare, aggiungere o rimuovere attività prima di eseguire il piano.

Passaggio 3: Eseguire il piano di modernizzazione

Dopo aver verificato il piano, verificare di voler eseguire il piano.

○ How would you like to continue?

  > 1. Execute modernization plan
       Run the tasks defined in the modernization plan
    2. Return to main menu
  1. Selezionare 1. Eseguire il piano di modernizzazione.
  2. Premere INVIO per eseguire il piano.
  3. Monitorare lo stato di avanzamento quando l'agente applica le modifiche.

L'agente esegue ogni attività in ordine:

  • Apporta modifiche al codice in base al piano.
  • Convalida le compilazioni dopo ogni modifica.
  • Analizza e risolve i CVE.
  • Esegue il commit delle modifiche.

Passaggio 4: Esaminare i risultati

Al termine dell'esecuzione, è possibile esaminare tutte le modifiche apportate dall'agente prima di unirle:

  1. Rivedere le modifiche: controllare le modifiche nel ramo corrente.

    git status
git diff main

  2. Creare un pull request: se sei soddisfatto delle modifiche, crea un pull request per la revisione del team.

    gh pr create \
    --title "Modernization: migrate the app to azure" \
    --body "Automated modernization by GitHub Copilot agent"

Passaggi successivi

Inviare commenti

Valiamo l'input! Se si hanno commenti e suggerimenti sull'agente di modernizzazione, creare un problema nel repository github-copilot-appmod o usare il modulo di feedback sulla modernizzazione di GitHub Copilot.

  • Last updated on