Guida introduttiva: Valutare ed eseguire la migrazione di un progetto .NET con la modernizzazione delle app Copilot di GitHub per .NET

Prerequisites

• Sistema operativo Windows.

• Visual Studio 2026 (o Visual Studio 2022 versione 17.14.17 e successive).

• Workload per lo sviluppo desktop .NET con i componenti facoltativi seguenti abilitati:

  • GitHub Copilot
  • Modernizzazione delle app Copilot di GitHub

• Sottoscrizione di GitHub Copilot (a pagamento o gratuita).

• Accesso effettuato a Visual Studio utilizzando un account GitHub con accesso Copilot.

  Importante

  Se si modificano le sottoscrizioni, è necessario riavviare Visual Studio.

• Il codice deve essere scritto in C#.

Valutare l'idoneità delle app

La modernizzazione delle app Copilot di GitHub per la valutazione .NET consente di trovare problemi di idoneità delle app, di apprendere il loro impatto e di visualizzare le attività di migrazione consigliate. Ogni attività di migrazione include riferimenti per configurare le risorse di Azure, aggiungere configurazioni e apportare modifiche al codice. Per avviare la migrazione, seguire questa procedura:

1. Clonare il repository di esempi di copilot di migrazione .NET nel computer.

2. In Visual Studio aprire la soluzione Contoso University dal repository degli esempi.

3. In Esplora soluzioni fare clic con il pulsante destro del mouse sul nodo della soluzione e scegliere Modernize (Modernizzare).

   

4. Viene visualizzata la finestra Chat di GitHub Copilot con un messaggio di benvenuto e opzioni predefinite. Selezionare Migrate to Azure (Esegui migrazione ad Azure ) dalle opzioni disponibili e inviarla a Copilot.

   

   Tip

   Anziché i passaggi 3 e 4, è possibile aprire direttamente GitHub Copilot Chat e inviare @Modernize Migrate to Azure per avviare il flusso di valutazione e migrazione.

5. Viene aperta una nuova sessione di chat copilot e viene visualizzato il messaggio di benvenuto. La valutazione viene avviata automaticamente e analizza il progetto per la preparazione della migrazione.

   

6. Al termine della valutazione, viene visualizzata una pagina completa dell'interfaccia utente del report di valutazione e un elenco delle attività di migrazione nella finestra della chat.

   

Migrazioni di app

La modernizzazione delle app Copilot di GitHub per .NET include attività predefinite per scenari di migrazione comuni e segue le procedure consigliate di Microsoft.

Avviare un'attività di migrazione

Avviare un'attività di migrazione in uno dei modi seguenti:

Opzione 1. Eseguire a partire dal report di valutazione

Selezionare il pulsante Esegui attività nel report di valutazione del passaggio precedente per avviare un'attività di migrazione.

Opzione 2. Inviare nella chat di Copilot

Inviare il numero di attività di migrazione (ad esempio, 1.1) o il relativo nome nella chat.

Pianificazione e generazione del tracciatore di progresso

• Quando si avvia la migrazione, GitHub Copilot avvia una sessione denominata "Modernizzazione delle app: eseguire la migrazione da <source technology> a <target technology>" in modalità agente con richieste predefinite.
• Lo strumento crea due file nella .appmod/.migration cartella :
  • plan.md: piano di migrazione complessivo.
  • progress.md: indicatore di stato aggiornato da GitHub Copilot durante il completamento delle attività.
• Modificare questi file per personalizzare la migrazione prima di continuare.

Avvio della correzione del codice

• Se si è soddisfatti del piano e dello strumento di monitoraggio dei progressi, inserire un prompt per avviare il processo di migrazione, ad esempio:

  The plan and progress tracker look good to me. Go ahead with the migration.
  

• GitHub Copilot avvia il processo di migrazione e potrebbe richiedere l'approvazione per l'uso degli strumenti della Knowledge Base nel server MCP (Model Context Protocol). Concedere l'autorizzazione quando richiesto.

• Copilot segue il piano e lo strumento di rilevamento dello stato per:

  • Gestire le dipendenze.
  • Applicare le modifiche di configurazione.
  • Apportare modifiche al codice.
  • Compilare la soluzione, correggere tutti gli errori di compilazione e configurazione e garantire una compilazione corretta.
  • Correggere le vulnerabilità di sicurezza.

Messaggi di chat predefiniti

La modernizzazione delle app Copilot di GitHub per .NET offre opzioni predefinite per i messaggi di chat per semplificare il flusso di lavoro.

Scegliere una delle opzioni predefinite e inviarla nella chat:

• Eseguire la valutazione della modernizzazione: avvia una nuova valutazione dell'applicazione per identificare i problemi di conformità della migrazione e i problemi di compatibilità di Azure.
• Visualizzare il report di valutazione: apre il report di valutazione precedente e mostra un riepilogo delle attività di migrazione in base ai risultati. Se non esiste alcuna valutazione precedente, esegue prima una nuova valutazione.
• Esplorare le attività di migrazione principali: mostra le attività di migrazione consigliate e gli scenari di modernizzazione comuni, indipendentemente dai risultati specifici della valutazione.

Passaggi successivi

• Lavorare con la valutazione
• Attività predefinite
• Domande frequenti

Prerequisites

• Un account GitHub con una sottoscrizione di GitHub Copilot attiva in qualsiasi piano.

• Versione più recente di Visual Studio Code. Deve essere la versione 1.101 o successiva.

  • GitHub Copilot in Visual Studio Code. Per istruzioni sulla configurazione, vedere Configurare GitHub Copilot in VisualStudio Code. Assicurarsi di accedere all'account GitHub in Visual Studio Code.
  • Modernizzazione delle app Copilot di GitHub. Riavviare Visual Studio Code dopo l'installazione.

• Ambiente di sviluppo .NET per compilare e testare il progetto.

Valutare l'idoneità delle app

La modernizzazione delle app Copilot di GitHub per la valutazione .NET consente di trovare problemi di idoneità delle app, di apprendere il loro impatto e di visualizzare le attività di migrazione consigliate. Ogni attività di migrazione include riferimenti per configurare le risorse di Azure, aggiungere configurazioni e apportare modifiche al codice. Per avviare la migrazione, seguire questa procedura:

1. Clonare il repository di esempi di copilot di migrazione .NET nel computer.

2. In Visual Studio Code, apri la soluzione Contoso University dal repository degli esempi.

3. Aprire l'estensione di modernizzazione delle app Copilot di GitHub .

4. Nella sezione Avvio rapido selezionare Avvia valutazione. Verrà visualizzata la pagina Report di valutazione .

5. Selezionare Esegui valutazione nell'angolo superiore destro della pagina.

   

6. La valutazione viene avviata automaticamente e analizza il progetto per la preparazione della migrazione.

   

7. Al termine della valutazione, viene visualizzata una pagina completa dell'interfaccia utente del report di valutazione e un elenco delle attività di migrazione nella finestra della chat.

   

Migrazioni di app

La modernizzazione delle app Copilot di GitHub per .NET include attività predefinite per scenari di migrazione comuni e segue le procedure consigliate di Microsoft.

Migrazione basata su chat (scelta consigliata)

La migrazione basata su chat è il modo consigliato per avviare una migrazione. L'agente AppModernization-DotNet personalizzato è ottimizzato per le attività di modernizzazione delle applicazioni. Questo agente consente di usare semplici richieste di linguaggio naturale per eseguire scenari di migrazione complessi.

Completare i passaggi seguenti per selezionare l'agente personalizzato e avviare la migrazione:

1. Assicurarsi di avere un progetto .NET aperto in Visual Studio Code.

2. Selezionare l'icona della chat nella barra attività per aprire la finestra chat di Copilot.

3. Nella finestra della chat individuare il menu a discesa del selettore agente nella parte superiore della casella di input della chat. Selezionare AppModernization-DotNet nell'elenco. Questo agente personalizzato è progettato per scenari di modernizzazione e migrazione di applicazioni .NET.

   

4. Immettere un prompt usando il formato migrate from <source> to <target> nella finestra della chat. Per esempio:

   migrate from rabbitmq to Azure service bus
   

5. L'agente analizza il codice, crea un piano di migrazione, apporta modifiche al codice, esegue convalide e genera un riepilogo. Selezionare Continua per continuare a eseguire ogni passaggio e Mantenere per accettare le modifiche.

Avviare un'attività di migrazione dall'interfaccia utente

È anche possibile avviare un'attività di migrazione dall'interfaccia utente:

Opzione 1. Eseguire a partire dal report di valutazione

Selezionare il pulsante Esegui attività nel report di valutazione del passaggio precedente per avviare un'attività di migrazione.

Opzione 2. Applicare un'attività predefinita

Eseguire l'attività specifica nella sezione TASKS - .NET . Ad esempio, l'attività Migrazione del Database verso Azure Database per PostgreSQL nelle Attività del database aggiorna la connessione del database, le configurazioni, le dipendenze e il codice di accesso ai dati per utilizzare Azure Database per PostgreSQL.

Pianificazione e generazione del tracciatore di progresso

Quando si avvia la migrazione, GitHub Copilot avvia una sessione in modalità agente.

Lo strumento crea due file nella .github/appmod/code-migration/<target-branch-name> cartella :

• plan.md: piano di migrazione complessivo.
• progress.md: indicatore di stato aggiornato da GitHub Copilot durante il completamento delle attività.

Modificare questi file per personalizzare la migrazione prima di continuare.

Avvio della correzione del codice

Quando si è soddisfatti del piano e del tracciatore di avanzamento, digitare continua per avviare la migrazione.

GitHub Copilot avvia il processo di migrazione e potrebbe richiedere l'approvazione per l'uso degli strumenti della Knowledge Base nel server MCP (Model Context Protocol). Concedere l'autorizzazione quando richiesto.

Copilot segue il piano e lo strumento di rilevamento dello stato per:

• Gestire le dipendenze.
• Applicare le modifiche di configurazione.
• Apportare modifiche al codice.
• Compilare il progetto, correggere tutti gli errori di compilazione e configurazione e assicurarsi che la compilazione sia riuscita.
• Correggere le vulnerabilità di sicurezza.

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, lo strumento di migrazione avvia una convalida e corregge il ciclo di iterazione. Questo ciclo include i cinque passaggi seguenti:

1. Rilevare vulnerabilità ed esposizioni comuni nelle dipendenze correnti e correggerle.
2. Compilare il progetto e risolvere eventuali errori di compilazione.
3. Analizzare il codice per verificare la coerenza funzionale.
4. Analizzare il progetto per individuare gli errori di unit test e generare automaticamente un piano per correggerli fino al superamento dei test.
5. Analizzare il codice per individuare gli elementi di migrazione mancanti nella migrazione del codice iniziale e correggerli.

Al termine di tutti i processi, lo strumento di migrazione genera un riepilogo. Esaminare le modifiche al codice e confermarle selezionando Mantieni.