Compartilhar via

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

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

Pré-requisitos

  • Uma assinatura do GitHub Copilot: plano Gratuito, Pro, Pro+, Business ou Enterprise. Consulte os planos do Copilot.
  • CLI do GitHub: instale a CLI do GitHub (gh) para autenticação v2.45.0 ou superior. 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.

Use uma das seguintes opções:

Opção 1 – Winget (recomendado):

winget install GitHub.Copilot.modernization.agent

Para instalação silenciosa sem prompts:

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

Opção 2 – One-liner do PowerShell:

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

Opção 3 – instalador MSI:

Baixe e execute a MSI mais recente na página de versões do GitHub.

Observação

Após a instalação, abra um novo terminal para que o modernize comando esteja disponível em seu PATH. Esses comandos funcionam para instalação inicial e atualização para a versão mais recente. Um comando de atualização de versão dedicado estará disponível em uma versão futura.

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

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 Java app?

  > 1. Assess application
       Analyze the project and identify modernization opportunities
    2. Create modernization plan
       Generate a structured plan to guide the agent
    3. Execute modernization plan
       Run the tasks defined in the modernization plan

Etapa 1: Avaliar o aplicativo

  1. Selecione 1. Avaliar o aplicativo.
  2. Siga os prompts para configurar as opções de avaliação (ou pressione Enter para usar padrões).
  3. Examine suas seleções e pressione Enter para iniciar a avaliação.
  4. 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. Insira um nome de plano ou pressione Enter para usar o nome padrão.
  3. Insira sua meta de modernização como uma instrução. Por padrão, o prompt é References the assessment summary and creates plan 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
  4. Pressione Enter para gerar o plano.

O agente analisa sua base de código e gera:

  • Arquivo de plano (.github/modernize/{plan-name}/plan.md): estratégia e abordagem detalhadas.
  • Lista de tarefas (.github/modernize/{plan-name}/tasks.json): detalhamento das etapas executáveis.

Dica

Você pode editar plan.md manualmente para adicionar esclarecimentos ou ajustar detalhes. Você também pode atualizar tasks.json para modificar, reordenar, adicionar ou remover tarefas antes de executar o plano.

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 

Fornecer comentários

Valorizamos sua entrada! Se você tiver algum comentário sobre o agente de modernização, crie um problema no repositório github-copilot-appmod ou use o formulário de comentários de modernização do GitHub Copilot.

  • Last updated on