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

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

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

Pré-requisitos

• Sistema Operacional Windows.

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

• Carga de trabalho de desenvolvimento de desktop em .NET com os seguintes componentes opcionais habilitados:

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

• Assinatura do GitHub Copilot (paga ou gratuita).

• Entrou no Visual Studio usando uma conta do GitHub com acesso copilot.

  Importante

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

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

Avaliar a preparação do aplicativo

A modernização do aplicativo 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 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 exemplos de migração do copilot do .NET para seu computador.

2. No Visual Studio, abra a solução da 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 do 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.

   

   Dica

   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 chat do 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 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 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 do aplicativo: 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; O GitHub Copilot marca itens à medida que conclui 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 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.

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

  • Gerenciar dependências
  • Aplicar alterações de configuração
  • Fazer alterações de código
  • Criar a solução, corrigir todos os erros de compilação e configuração e garantir um build bem-sucedido
  • Corrigir vulnerabilidades de segurança

Mensagens de chat padrão

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

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

• Executar a avaliação de modernização: inicia uma nova avaliação do aplicativo para identificar problemas de preparação para a 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 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