Início Rápido: Avaliar e migrar um projeto do .NET com a modernização do GitHub Copilot para .NET

Pré-requisitos

• Windows sistema operacional.

• Visual Studio 2026 (ou Visual Studio versão 17.14.17 de 2022 e mais recente).

• Pacote de desenvolvimento para área de trabalho em .NET com os seguintes componentes opcionais habilitados:

  • GitHub Copilot
  • Agente de atualização do GitHub Copilot

• GitHub Copilot Assinatura (paga ou gratuita).

• Conectado ao Visual Studio usando uma conta do GitHub com acesso ao Copilot.

  Importante

  Se você alterar as assinaturas, deverá reiniciar Visual Studio.

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

Avaliar a preparação do aplicativo

A modernização do GitHub Copilot para avaliação do .NET ajuda você a encontrar desafios de preparação do aplicativo, aprender seu impacto e ver as tarefas de migração recomendadas. Cada tarefa de migração inclui referências para configurar Azure recursos, 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 copilot de migração .NET para seu computador.

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

3. Em Solution Explorer, clique com o botão direito do mouse no nó da solução e selecione Modernize.

   

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

   

   Dica

   Em vez das etapas 3 e 4, você pode abrir 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 chat Copilot é aberta e mostra a mensagem de boas-vindas. A avaliação é iniciada automaticamente e analisa seu projeto para preparação para a migração.

   

6. Quando a avaliação for concluída, você verá uma página abrangente da interface do usuário do relatório de avaliação e uma lista de tarefas de migração na janela de chat.

   

Migrações de aplicativo

A modernização do 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 no 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 no Chat do Copilot

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

Planejamento e geração de rastreador de progresso

• Quando você inicia a migração, o GitHub Copilot inicia uma sessão chamada "Modernização: migrar de <source technology> para <target technology>" no modo de agente com prompts predefinidos.
• A ferramenta cria dois arquivos na .appmod/.migration pasta:
  • plan.md: o plano de migração geral.
  • progress.md: um rastreador de progresso que o GitHub Copilot atualiza conforme 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 o processo de migração, como:

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

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

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

  • Gerenciar dependências.
  • Aplicar alterações de configuração.
  • Realize alterações de código.
  • Crie a solução, corrija todos os erros de compilação e configuração e garanta um build bem-sucedido.
  • Corrija vulnerabilidades de segurança.

Mensagens de chat padrão

A modernização do GitHub Copilot para .NET fornece opções de mensagem de chat padrão para simplificar seu fluxo de trabalho.

Escolha uma das opções predefinidas e envie-a no chat:

• Executar avaliação de modernização: inicia uma nova avaliação do seu aplicativo para identificar problemas de prontidão para migração e desafios de compatibilidade com o 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 nenhuma avaliação anterior existir, ela executará uma nova avaliação primeiro.
• Navegue pelas principais tarefas de migração: mostra as tarefas de migração recomendadas e os cenários comuns de modernização, independentemente de resultados específicos da avaliação.

Próximas etapas

• Trabalhando com a avaliação
• Tarefas predefinidas
• Perguntas frequentes

Pré-requisitos

• Uma conta GitHub com uma assinatura GitHub Copilot ativa em qualquer plano.

• A versão mais recente do Visual Studio Code. Deve ser a versão 1.101 ou posterior.

  • GitHub Copilot no Visual Studio Code. Para obter instruções de instalação, consulte Configurar o GitHub Copilot no Visual Studio Code. Certifique-se de entrar em sua conta GitHub dentro de Visual Studio Code.
  • Modernização do GitHub Copilot. Reinicie o Visual Studio Code após a instalação.

• Um ambiente de desenvolvimento .NET para criar e testar o projeto.

Avaliar a preparação do aplicativo

A modernização do GitHub Copilot para avaliação do .NET ajuda você a encontrar desafios de preparação do aplicativo, aprender seu impacto e ver as tarefas de migração recomendadas. Cada tarefa de migração inclui referências para configurar Azure recursos, 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 copilot de migração .NET para seu computador.

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

3. Abra a extensão de atualização do GitHub Copilot.

4. Na seção INÍCIO RÁPIDO , selecione Iniciar Avaliação. A página Relatórios de Avaliação é aberta.

5. Selecione Executar Avaliação no canto superior direito da página.

   

6. A avaliação é iniciada automaticamente e analisa seu projeto para preparação para a migração.

   

7. Quando a avaliação for concluída, você verá uma página abrangente da interface do usuário do relatório de avaliação e uma lista de tarefas de migração na janela de chat.

   

Migrações de aplicativo

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

Migração baseada em chat (recomendado)

A migração baseada em chat é a maneira recomendada de iniciar uma migração. O AppModernization-DotNet agente personalizado é otimizado para tarefas de modernização do aplicativo. Esse agente permite que você use prompts de linguagem simples e naturais para executar cenários de migração complexos.

Conclua as seguintes etapas para selecionar o agente personalizado e iniciar a migração:

1. Verifique se você tem um projeto de .NET aberto no Visual Studio Code.

2. Selecione o ícone de chat no Activity Bar para abrir a janela de chat Copilot.

3. Na janela de chat, localize o menu suspenso do seletor de agente na parte superior da caixa de entrada do chat. Selecione AppModernization-DotNet na lista. Esse agente personalizado foi projetado para .NET cenários de modernização e migração de aplicativos.

   

4. Insira um prompt usando o formato migrate from <source> to <target> na janela de chat. Por exemplo:

   migrate from rabbitmq to Azure service bus
   

5. O agente analisa seu código, cria um plano de migração, faz alterações de código, executa validações e gera um resumo. Selecione Continuar para prosseguir em cada etapa e Manter para aceitar as alterações.

Iniciar uma tarefa de migração da interface do usuário

Você também pode iniciar uma tarefa de migração da interface do usuário:

Opção 1. Executar no 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. Aplicar uma tarefa predefinida

Execute a tarefa específica na seção TASKS – .NET. Por exemplo, a tarefa Migrate Database to Azure Database for PostgreSQL em Database Tasks atualiza sua conexão de banco de dados, configurações, dependências e código de acesso a dados para usar Azure Database for PostgreSQL.

Planejamento e geração de rastreador de progresso

Quando você inicia a migração, GitHub Copilot inicia uma sessão no modo de agente.

A ferramenta cria dois arquivos na .github/appmod/code-migration/<target-branch-name> pasta:

• plan.md: o plano de migração geral.
• progress.md: um rastreador de progresso que o GitHub Copilot atualiza conforme conclui as tarefas.

Edite esses arquivos para personalizar sua migração antes de continuar.

Iniciar correção de código

Quando estiver satisfeito com o plano e o rastreador de progresso, insira continuar a iniciar a migração.

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

Copilot segue o plano e o rastreador de progresso para:

• Gerenciar dependências.
• Aplicar alterações de configuração.
• Realize alterações de código.
• Crie o projeto, corrija todos os erros de compilação e configuração e garanta um build bem-sucedido.
• Corrija vulnerabilidades de segurança.

Selecione ou insira Continuar repetidamente para confirmar o uso de ferramentas ou comandos e espere a conclusão das alterações de código.

Iteração de validação

Após a conclusão das alterações de código, a ferramenta de migração inicia um loop iterativo de validação e correção. Esse loop inclui as cinco etapas a seguir:

1. Detecte CVEs (Vulnerabilidades e Exposições Comuns) nas dependências atuais e corrija-as.
2. Crie o projeto e resolva os erros de build.
3. Analise o código para obter consistência funcional.
4. Analise o projeto em busca de falhas nos testes de unidade e gere automaticamente um plano para corrigir as falhas até que os testes sejam bem-sucedidos.
5. Analise o código para itens de migração perdidos na migração de código inicial e corrija-os.

Depois que todos os processos forem concluídos, a ferramenta de migração gerará um resumo. Examine as alterações de código e confirme-as selecionando Manter.