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.

winget install GitHub.Copilot.modernization.agent

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

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

brew tap microsoft/modernize https://github.com/microsoft/modernize-cli
brew install modernize

curl -fsSL https://raw.githubusercontent.com/microsoft/modernize-cli/main/scripts/install.sh | bash

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

git clone https://github.com/Azure-Samples/PhotoAlbum.git
cd PhotoAlbum
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 app?

  > Assess
    Analyze modernization readiness across one or multiple applications
    Plan
    Generate a structured plan to guide the agent
    Execute
    Run the tasks defined in the modernization plan

  Or select a quick-start scenario:

    Upgrade
    Upgrade runtimes and frameworks across one or multiple applications

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. Selezionare i domini di valutazione, ad esempio Java upgrade e Cloud Readiness e premere Invio.
4. 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.
5. 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.
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. Selezionare 1. Mantieni il piano in locale per generare il piano sul computer oppure scegliere 2. Invia a Cloud Agent per fare in modo che un agente cloud lo generi. L'opzione 2 è sperimentale.
3. Il report di valutazione appena creato è selezionato per impostazione predefinita per generare il piano. Selezionare 1. Nessun report se si desidera descrivere invece i requisiti specifici.
4. Immettere un nome di piano o premere INVIO per usare il nome predefinito.
5. Immettere l'obiettivo di modernizzazione come richiesta. Per impostazione predefinita, il prompt è Based on the assessment report, upgrade the project and migrate to Azure 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
6. Premere INVIO per generare il piano.
7. L'agente analizza la codebase e chiede di chiarire la richiesta. È possibile selezionare una risposta suggerita o digitare una risposta personalizzata.

L'agente aggrega tutte le informazioni e genera:

• File di piano (.github/modernize/{plan-name}/plan.md): strategia e approccio dettagliati.

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

• Scopri di più sulla CLI
• Valutazione batch: valutare più applicazioni
• Aggiornamento batch: aggiornare più applicazioni
• Creare competenze personalizzate per l'organizzazione

Inviare commenti

Il feedback consente di migliorare l'agente di modernizzazione. Per inviare commenti e suggerimenti da Modernize TUI, premere F.

GitHub Copilot modernization v1.0.0
GitHub Copilot modernization is AI-powered and may not always be accurate.

GitHub account: <username>
Copilot CLI version: 1.0.0
Model: Claude Sonnet 4.5 (1x) · M Select model · F Feedback

È anche possibile creare un problema nel repository github-copilot-appmod o usare il modulo di feedback sulla modernizzazione GitHub Copilot.