Guia de início rápido: avaliar e migrar um projeto .NET com a modernização do aplicativo GitHub Copilot para .NET

Neste guia de início rápido, você avalia e migra um projeto .NET usando a modernização do aplicativo GitHub Copilot para .NET. Conclua as seguintes tarefas:

• Avaliar um projeto de exemplo (Universidade Contoso)
• Iniciar o processo de migração

Prerequisites

• Sistema operativo Windows.

• Visual Studio 2026 (ou Visual Studio 2022 versão 17.14.17 e posteriores).

• Trabalho de desenvolvimento desktop .NET com os seguintes componentes opcionais ativados:

  • GitHub Copilot
  • Modernização do aplicativo GitHub Copilot

• Subscrição do GitHub Copilot (paga ou gratuita).

• Iniciei sessão no Visual Studio usando uma conta GitHub com acesso ao Copilot.

  Importante

  Se você alterar assinaturas, você deve reiniciar o Visual Studio.

• O código deve ser escrito em C#.

Avalie a prontidão do aplicativo

A modernização do aplicativo GitHub Copilot para avaliação .NET ajuda você a encontrar desafios de preparação de aplicativos, aprender seu impacto e ver as tarefas de migração recomendadas. Cada tarefa de migração inclui referências para configurar recursos do Azure, adicionar configurações e fazer alterações de código. Siga estas etapas para iniciar a migração:

1. Clone o repositório de amostras do copiloto de migração do .NET em seu computador.

2. No Visual Studio, abra a solução Contoso University no repositório de exemplos.

3. No Gerenciador de Soluções, clique com o botão direito do mouse no nó da solução e selecione Modernizar.

   

4. A janela GitHub Copilot Chat é aberta com uma mensagem de boas-vindas e opções predefinidas. Selecione Migrar para o Azure nas opções disponíveis e envie-o para o Copilot.

   

   Tip

   Em vez das etapas 3 e 4, você pode abrir o GitHub Copilot Chat diretamente e enviar @Modernize Migrate to Azure para iniciar o fluxo de avaliação e migração.

5. Uma nova sessão de bate-papo do Copilot é aberta e mostra a mensagem de boas-vindas. A avaliação começa automaticamente e analisa o seu projeto quanto à prontidão da migração.

   

6. Quando a avaliação terminar, o utilizador verá uma página de interface do relatório de avaliação abrangente e uma lista de tarefas de migração na janela de bate-papo.

   

Migrações de aplicativos

A modernização do aplicativo GitHub Copilot para .NET inclui tarefas predefinidas para cenários comuns de migração e segue as práticas recomendadas da Microsoft.

Iniciar uma tarefa de migração

Inicie uma tarefa de migração de uma das seguintes maneiras:

Opção 1. Executar a partir do Relatório de Avaliação

Selecione o botão Executar tarefa no Relatório de avaliação da etapa anterior para iniciar uma tarefa de migração.

Opção 2. Enviar na conversa do Copilot

Envie o número da tarefa de migração (por exemplo, 1.1) ou seu nome no chat.

Planeamento e geração de rastreadores de progresso

• Quando inicias a migração, o GitHub Copilot começa uma sessão chamada "Modernização da Aplicação: migrar de <source technology> para <target technology>" em modo de agente com prompts predefinidos.
• A ferramenta cria dois arquivos na .appmod/.migration pasta:
  • plan.md - o plano global de migração
  • progress.md - um rastreador de progresso; O Copilot do GitHub marca os itens à medida que conclui as tarefas
• Edite esses arquivos para personalizar sua migração antes de continuar.

Iniciar correção de código

• Se você estiver satisfeito com o plano e o rastreador de progresso, insira um prompt para iniciar a migração, como:

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

• O Copilot do GitHub inicia o processo de migração e pode solicitar sua aprovação para usar ferramentas da base de dados de conhecimento no servidor MCP (Model Context Protocol). Conceda permissão quando solicitado.

• O Copilot segue o plano e o rastreador de progresso para:

  • Gerenciar dependências
  • Aplicar alterações de configuração
  • Fazer alterações no código
  • Crie a solução, corrija todos os erros de compilação e configuração e garanta uma compilação bem-sucedida
  • Corrigir vulnerabilidades de segurança

Mensagens de chat padrão

A modernização do aplicativo GitHub Copilot para .NET oferece opções padrão de mensagens de bate-papo para simplificar seu fluxo de trabalho.

Você pode escolher uma das opções predefinidas e enviá-lo no chat:

• Executar a avaliação de modernização: inicia uma nova avaliação do seu aplicativo para identificar problemas de preparação para migração e desafios de compatibilidade do Azure.
• Exibir relatório de avaliação: abre o relatório de avaliação anterior e mostra um resumo das tarefas de migração com base nos resultados. Se não existir uma avaliação prévia, procede-se primeiro a uma nova avaliação.
• Procurar as principais tarefas de migração: mostra as tarefas de migração recomendadas e os cenários comuns de modernização, independentemente de quaisquer resultados de avaliação específicos.

Próximas Etapas

• Trabalhar com avaliação
• Tarefas predefinidas
• Perguntas Mais Frequentes