Início Rápido: Instalar e usar o agente de modernização do GitHub Copilot

Este guia de início rápido orienta você na instalação do agente de modernização do GitHub Copilot e no uso dele para modernizar um aplicativo de exemplo.

Pré-requisitos

• A assinatura GitHub Copilot: plano Gratuito, Pro, Pro+, Business ou Enterprise. Consulte planos do Copilot.
• GitHub CLI: instale a CLI do GitHub (gh) para autenticação, versão v2.45.0 ou posterior. Consulte Instalando gh.

Requisitos de plataforma

• Windows: x64 ou ARM64.
• Linux: x64 ou ARM64 com glibc 2.27 ou posterior (Ubuntu 18.04 ou posterior, Debian 10 ou posterior, Fedora 29 ou posterior, Azure Linux 2.0 ou posterior).
• macOS: Apple Silicon ou Intel.

Instalar o agente de modernização

Use os comandos a seguir para instalar o agente de modernização ou atualizar para a versão mais recente.

winget install GitHub.Copilot.modernization.agent

winget install GitHub.Copilot.modernization.agent --silent

iex (irm 'https://raw.githubusercontent.com/microsoft/modernize-cli/main/scripts/install.ps1')

brew tap microsoft/modernize https://github.com/microsoft/modernize-cli
brew install modernize

curl -fsSL https://raw.githubusercontent.com/microsoft/modernize-cli/main/scripts/install.sh | bash

Verifique a instalação:

modernize --version

Obter um aplicativo de exemplo

Para este início rápido, use um aplicativo de exemplo. Escolha Java ou .NET:

git clone https://github.com/Azure-Samples/PhotoAlbum-Java.git
cd PhotoAlbum-Java
git checkout -b modernize

git clone https://github.com/Azure-Samples/PhotoAlbum.git
cd PhotoAlbum
git checkout -b modernize

Usar o modo interativo

A maneira mais fácil de começar é usando o modo interativo. Primeiro, autentique-se usando a CLI do GitHub:

gh auth login

Em seguida, execute o agente de modernização:

modernize

O menu principal é exibido:

○ How would you like to modernize your app?

  > Assess
    Analyze modernization readiness across one or multiple applications
    Plan
    Generate a structured plan to guide the agent
    Execute
    Run the tasks defined in the modernization plan

  Or select a quick-start scenario:

    Upgrade
    Upgrade runtimes and frameworks across one or multiple applications

Etapa 1: Avaliar o aplicativo

1. Selecione Avaliar no menu principal.
2. Escolha como especificar seus repositórios de destino. Você pode selecionar pasta atual para usar seu diretório atual, entrada manual para inserir caminhos locais ou URLs remotas do Git, ou de um arquivo de configuração para carregar repositórios de um arquivo de configuração JSON. Para este início rápido, selecione a pasta Atual.
3. Selecione domínios de avaliação, como Java upgrade e Cloud Readiness e pressione Enter.
4. Revise as opções de configuração de avaliação, como Cobertura de Análise e Tempo de Execução Alvo. Pressione Enter on Continue para aceitar os padrões recomendados ou ajuste as configurações individuais conforme necessário.
5. Escolha o modo de execução. Selecione Avaliar localmente para executar a avaliação em seu computador ou Delegar aos Agentes de Nuvem para permitir que os agentes de nuvem executem a avaliação em paralelo. Para este início rápido, selecione Avaliar localmente.
6. Aceite o caminho de saída padrão ou insira um personalizado e pressione Enter para iniciar a avaliação.
7. Aguarde a conclusão da avaliação.

Os resultados da avaliação são salvos .github\modernize\assessment\ no diretório do projeto. O agente analisa seu código, dependências e configuração para identificar:

• Versões de estrutura desatualizadas
• APIs obsoletas
• Problemas de compatibilidade na nuvem
• Oportunidades de migração

Etapa 2: Criar um plano de modernização

Após a conclusão da avaliação, o agente solicitará que você crie um plano de modernização com base nos problemas identificados:

○ How would you like to continue?

  > 1. Create modernization plan
       Generate a plan.md file according to the identified issues
    2. Return to main menu

1. Selecione 1. Criar um plano de modernização.
2. Selecione 1. Mantenha o plano local para gerar o plano em seu computador ou escolha 2. Envie ao Agente de Nuvem para que um agente de nuvem o gere. A opção 2 é experimental.
3. O relatório de avaliação recém-criado é selecionado por padrão para gerar o plano. Selecione 1. Nenhum relatório se você quiser descrever seus requisitos específicos.
4. Insira um nome de plano ou pressione Enter para usar o nome padrão.
5. Insira sua meta de modernização como uma instrução. Por padrão, o prompt é Based on the assessment report, upgrade the project and migrate to Azure para criar um plano baseado nos resultados da avaliação. Você pode substituí-la por qualquer outra solicitação de migração, por exemplo:
   • migrate the database to Azure PostgreSQL
   • upgrade to Spring Boot 3
   • deploy to Azure Container Apps
6. Pressione Enter para gerar o plano.
7. O agente analisa sua base de código e pede que você esclareça a solicitação. Você pode selecionar uma resposta sugerida ou digitar sua própria.

O agente agrega todas as informações e gera:

• Arquivo de plano (.github/modernize/{plan-name}/plan.md): estratégia e abordagem detalhadas.

Etapa 3: Executar o plano de modernização

Depois de verificar o plano, confirme se deseja executar o plano.

○ How would you like to continue?

  > 1. Execute modernization plan
       Run the tasks defined in the modernization plan
    2. Return to main menu

1. Selecione 1. Execute o plano de modernização.
2. Pressione Enter para executar o plano.
3. Monitore o progresso à medida que o agente aplica alterações.

O agente executa cada tarefa na ordem:

• Faz alterações de código de acordo com o plano.
• Valida as compilações após cada alteração.
• Examina e aborda CVEs.
• Confirma alterações.

Etapa 4: Examinar os resultados

Após a conclusão da execução, você pode examinar todas as alterações feitas pelo agente antes de mesclá-las:

1. Verifique as modificações: Confira as modificações no branch atual.

   git status
   git diff main
   

2. Crie uma solicitação de pull: se você estiver satisfeito com as alterações, crie uma PR para revisão de equipe.

   gh pr create \
       --title "Modernization: migrate the app to azure" \
       --body "Automated modernization by GitHub Copilot agent"
   

Próximas Etapas 

• Saiba mais sobre a CLI
• Avaliação de lote: avaliação de múltiplos aplicativos
• Atualização em lote: Atualizar vários aplicativos
• Criar habilidades personalizadas para sua organização

Fornecer comentários

Seus comentários ajudam a melhorar o agente de modernização. Para enviar feedback pelo Modernize TUI, pressione F.

GitHub Copilot modernization v1.0.0
GitHub Copilot modernization is AI-powered and may not always be accurate.

GitHub account: <username>
Copilot CLI version: 1.0.0
Model: Claude Sonnet 4.5 (1x) · M Select model · F Feedback

Você também pode criar um problema no repositório github-copilot-appmod ou usar o formulário de comentários de modernização GitHub Copilot.