O que é a modernização do GitHub Copilot?

Modernização do GitHub Copilot é um agente do GitHub Copilot que ajuda você a atualizar projetos para versões mais recentes do .NET e migrar aplicativos .NET para o Azure de forma rápida e segura. Ele orienta você por meio de avaliação, recomendações de solução, correções de código e validação em Visual Studio, Visual Studio Code, GitHub Copilot CLI e GitHub.com.

Use este agente para:

• Atualize para uma versão mais recente do .NET.
• Migre tecnologias e implante no Azure.
• Modernize seu aplicativo .NET, especialmente durante a atualização do .NET Framework.
• Avalie o código, a configuração e as dependências do aplicativo.
• Planeje e configure o recurso de Azure correto.
• Corrija problemas e aplique as práticas recomendadas para migração na nuvem.
• Valide se o aplicativo compila e testa com êxito.

Cenários

O agente fornece vários fluxos de trabalho de modernização de ponta a ponta chamados cenários. Cada cenário é um fluxo de trabalho gerenciado que orienta você por meio de um tipo específico de atualização ou migração:

Para obter uma referência completa de todos os cenários e mais de 30 competências de migração embutidas, consulte Cenários e referência de competências.

Fornecer comentários

Microsoft valoriza seus comentários e o usa para melhorar o agente. Deixe comentários usando uma destas opções:

• Em Visual Studio, use as opções Suggest a feature e Reportar um problema.

• Registre um problema no repositório GitHub @modernize-dotnet.

Pré-requisitos

Configure a modernização do GitHub Copilot em seu ambiente de desenvolvimento antes de utilizá-lo. Para obter as etapas de instalação, consulte Modernização do GitHub Copilot.

Atualizar projetos de .NET

O agente de modernização dá suporte à atualização de projetos C# e Visual Basic dos seguintes tipos:

• ASP.NET Core (e tecnologias relacionadas, como MVC, Razor Pages e API Web)
• Blazor
• Azure Functions
• Windows Presentation Foundation (WPF)
• Windows Forms
• WinUI
• .NET MAUI e Xamarin
• Bibliotecas de classes
• Aplicativos de console
• Projetos de teste (MSTest, NUnit e xUnit)

Para iniciar uma atualização, consulte atualizar um aplicativo .NET com a modernização do GitHub Copilot.

Caminhos de atualização com suporte

O agente dá suporte aos seguintes caminhos de atualização:

Migrar projetos .NET para Azure

O agente de modernização simplifica as migrações de Azure por meio de análise automatizada, correção de código orientada por IA, verificações de build e vulnerabilidade e automação de implantação:

• Análise e recomendações inteligentes.

  Avalie a prontidão do seu aplicativo para migração para o Azure e receba diretrizes personalizadas baseadas nas dependências e nos problemas identificados.

• Correção de código com inteligência artificial.

  Aplique padrões de código predefinidos de melhor prática para acelerar a modernização com esforço manual mínimo.

• Compilação automática e a resolução de CVEs.

  Crie seu aplicativo e resolva erros e vulnerabilidades de compilação, simplificando o desenvolvimento.

• Implantação perfeita.

  Implante no Azure, levando seu código do desenvolvimento à produção de forma mais rápida.

Tarefas predefinidas para migração

A modernização do GitHub Copilot para .NET oferece tarefas predefinidas que adotam as melhores práticas do setor e abrangem cenários comuns de migração.

• Migrar para banco de dados baseado em Identidade Gerenciada no Azure, incluindo SQL do Azure DB, SQL do Azure MI e Azure PostgreSQL

  Modernize sua camada de dados migrando de bancos de dados locais ou herdados (como DB2, Oracle DB ou SQL Server) para SQL do Azure BD, Instância Gerenciada de SQL do Azure ou Azure PostgreSQL. Use a autenticação de identidade gerenciada segura.

• Migrar para o Armazenamento de Arquivos do Azure

  Mova as operações de E/S de arquivos do sistema de arquivos local para o Armazenamento de Arquivos do Azure para gerenciamento de arquivos escalável baseado em nuvem.

• Migre para o Armazenamento de Blobs do Azure

  Substitua o armazenamento de objetos no local ou entre nuvens, ou a E/S de arquivos do sistema de arquivos local, pelo Armazenamento de Blobs do Azure para dados não estruturados.

• Migre para Microsoft Entra ID

  Fazer a transição de autenticação e autorização de Windows Active Directory para Microsoft Entra ID (anteriormente Azure AD) para o gerenciamento de identidade moderno.

• Igrate para credenciais protegidas usando Identidade Gerenciada e Azure Key Vault

  Substitua as credenciais de texto sem formatação na configuração ou código por identidades gerenciadas e seguras e Azure Key Vault para gerenciamento de segredos.

• Migre para Barramento de Serviço do Azure

  Mova de filas de mensagens herdadas ou de terceiros (como MSMQ ou RabbitMQ) ou Amazon SQS (Serviço de Fila Simples do AWS) para Barramento de Serviço do Azure para mensagens confiáveis baseadas em nuvem.

• Migre para o serviço de email do Azure Communication Service

  Substitua o envio direto de email SMTP por Azure Serviço de Comunicação para entrega de email escalonável e segura.

• Igrate to Confluent Cloud/Azure Event Hub for Apache Kafka

  Transição do Kafka local ou on-premises para o streaming de eventos gerenciados com o Confluent Cloud ou Hubs de Eventos do Azure.

• Migrar para o OpenTelemetry no Azure

  Transição de estruturas de log locais, como log4net, Serilog e log de eventos do Windows para OpenTelemetry no Azure.

• Igrate para Cache do Azure para Redis usando a Identidade Gerenciada

  Substitua implementações de cache redis locais ou na memória por Cache do Azure para Redis para alta disponibilidade, escalabilidade e segurança de nível empresarial.

Como funciona

Para iniciar um processo de atualização ou migração, consulte:

1. Abra seu .NET projeto ou solução em seu ambiente de desenvolvimento.

2. Inicie o agente usando um destes métodos:

   • Visual Studio: clique com o botão direito do mouse na solução ou projeto em Gerenciador de Soluções e selecione Modernize. Ou abra a janela GitHub Copilot Chat e digite @Modernize.
   • Visual Studio Code: abra o painel do GitHub Copilot Chat e digite @modernize-dotnet.
   • GitHub Copilot CLI: digite @modernize-dotnet seguido de sua solicitação de atualização ou migração.
   • GitHub.com: use o agente de codificação modernize-dotnet em seu repositório.

3. Diga ao agente o que deve ser atualizado ou migrado.

Quando você solicita ao agente de modernização para atualizar seu aplicativo, Copilot primeiro solicitará que você crie um novo branch se estiver trabalhando em um repositório Git. Em seguida, Copilot avalia seu projeto e executa um fluxo de trabalho de três estágios. Cada estágio produz arquivos Markdown dentro de .github/upgrades/{scenarioId} no seu repositório para que você possa examinar o que vem a seguir antes de continuar. Se .github/upgrades/{scenarioId} já existir de uma tentativa anterior, Copilot perguntará se deseja continuar ou iniciar novamente.

Copilot começa examinando a estrutura do projeto, as dependências e os padrões de código para criar uma avaliação abrangente. O assessment.md arquivo lista mudanças significativas, problemas de compatibilidade de API, padrões preteridos e o escopo de atualização.

Após a avaliação, Copilot executa os três estágios a seguir:

1. Assessment: Copilot examina a estrutura do projeto, as dependências e os padrões de código e, em seguida, apresenta decisões de estratégia para sua revisão, como a estratégia de atualização (de baixo para cima, de cima para baixo ou tudo ao mesmo tempo), abordagem de migração de projeto, opções de modernização de tecnologia e tratamento de compatibilidade. Copilot armazena as decisões confirmadas no destino upgrade-options.md.

2. Planning: Copilot converte a avaliação e suas opções confirmadas em uma especificação detalhada. O arquivo plan.md documenta estratégias de atualização, abordagens de refatoração, caminhos de dependência e mitigações de risco.

3. Execution: Copilot divide o plano em tarefas sequenciais e concretas com critérios de validação em tasks.md. Cada tarefa descreve uma única alteração e como Copilot confirma que ela foi bem-sucedida.

Edite qualquer um dos arquivos .github/upgrades/{scenarioId} markdown para ajustar as etapas de atualização ou adicionar contexto antes de avançar.

Atualizar Estratégias

Durante o estágio de avaliação, o agente avalia sua solução e recomenda uma destas estratégias:

Modos de fluxo

O agente suporta dois modos de fluxo que controlam quanto tempo ele pausa para receber sua entrada.

• Automático: O agente trabalha em todos os estágios sem pausar, parando apenas em bloqueadores genuínos. Melhor para usuários experientes e atualizações simples.
• Guiado: O agente pausa em cada limite de estágio para que você possa examinar a avaliação, o plano e as tarefas antes de prosseguir. Melhor para usuários iniciantes e soluções complexas.

Alterne entre os modos a qualquer momento dizendo "pausar" (para entrar no modo guiado) ou "continuar" (para entrar no modo automático).

Gerenciamento de estado

O agente armazena todo o estado de atualização em .github/upgrades/{scenarioId}/. A pasta contém:

Como todo o estado reside nessa pasta, você pode fechar o IDE, alternar entre sessões ou até mesmo alternar entre ambientes de desenvolvimento (por exemplo, iniciar no VS Code e continuar no Visual Studio). O agente continua de onde parou.

Realizar a atualização

Após a conclusão de cada estágio, examine e modifique os arquivos gerados conforme necessário e, em seguida, diga a Copilot para continuar para o próximo estágio.

Quando chegar ao estágio Execution, diga ao Copilot para iniciar a atualização. Se Copilot encontrar um problema, ele tentará identificar a causa e aplicar uma correção. Se Copilot não puder corrigir o problema, ele pedirá sua ajuda. Quando você intervém, Copilot aprende com as alterações feitas e tenta aplicá-las automaticamente se o problema aparecer novamente.

Resultados da atualização

À medida que Copilot executa cada tarefa, ela atualiza o arquivo tasks.md em .github/upgrades/{scenarioId} com o status de cada etapa. Monitore o progresso examinando este arquivo. Copilot cria uma confirmação do Git para cada parte do processo, para que você possa reverter as alterações ou examinar o que foi alterado.

Quando a atualização for concluída, Copilot exibirá as próximas etapas na resposta do chat.

Telemetria

A ferramenta coleta dados sobre tipos de projeto, intenção de atualização e duração da atualização. O ambiente de desenvolvimento coleta e agrega os dados e não contém informações identificáveis pelo usuário. Para obter mais informações sobre a política de privacidade do Microsoft, consulte Visual Studio Customer Experience Improvement Program.

Conteúdo relacionado

• Instalar a modernização do GitHub Copilot
• Atualize um aplicativo .NET com a modernização pelo GitHub Copilot
• Conceitos básicos
• Referência de cenários e habilidades
• Práticas recomendadas
• Solucionar problemas da modernização do GitHub Copilot
• Quickstart: Migrar um projeto de .NET
• Perguntas frequentes sobre a modernização do GitHub Copilot