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

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

Prerequisiti

  • Una sottoscrizione a GitHub Copilot: gratuito, Pro, Pro+, Business o Enterprise. Consulta Copilot plans.
  • GitHub cli: installare l'interfaccia della riga di comando di GitHub (gh) per l'autenticazione, versione v2.45.0 o 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:

Scaricare ed eseguire l'ultimo MSI 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:

○ What would you like to do?

  > Assess        Analyze your source application and generate an assessment report
    Plan          Create a modernization plan based on assessment findings
    Execute       Run tasks defined in your modernization plan
  ──────────────
    Upgrade       Upgrade your runtime and frameworks to the latest versions

Passaggio 1: Valutare l'applicazione

  1. Selezionare Valuta dal menu principale.
  2. Scegliere come specificare i repository di destinazione. È possibile selezionare Cartella corrente per usare la directory corrente, Input manuale per immettere percorsi locali o URL Git remoti, oppure caricare da un file di configurazione per importare repository da un file di configurazione JSON. Per questa guida introduttiva selezionare Cartella corrente.
  3. Scegliere la modalità di esecuzione. Selezionare Valuta in locale per eseguire la valutazione nel computer o Delega agli agenti cloud per consentire agli agenti cloud di eseguire la valutazione in parallelo. Per questa guida introduttiva selezionare Valuta localmente.
  4. Selezionare i domini di valutazione, ad esempio Java upgrade e Cloud Readiness e premere Invio.
  5. Esaminare le opzioni di configurazione della valutazione, ad esempio Copertura dell'analisi e Ambiente di runtime di destinazione. Premere INVIO su Continua per accettare le impostazioni predefinite consigliate o regolare le singole impostazioni in base alle esigenze.
  6. Accettare il percorso di output predefinito o immetterne uno personalizzato, quindi premere INVIO per avviare la valutazione.
  7. 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

L'input è importante. 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 GitHub Copilot.

  • Last updated on