Partilhar via

Início rápido: Instale e use o agente de modernização do GitHub Copilot

Este quickstart guia-o na instalação do agente de modernização do GitHub Copilot e na sua utilização para modernizar uma aplicação de exemplo.

Pré-requisitos

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

Instale o agente de modernização

Use os seguintes comandos 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 indicações:

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

Opção 2 - Frase rápida do PowerShell:

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

Opção 3 - Instalador MSI:

Descarregue e execute a versão mais recente do MSI na página de lançamentos do GitHub.

Observação

Após a instalação, abra um novo terminal para que o modernize comando fique disponível no seu PATH. Estes comandos funcionam tanto para a instalação inicial como para a atualização para a versão mais recente. Um comando dedicado de atualização de versão estará disponível numa versão futura.

Verifique a instalação:

modernize --version

Obtenha uma aplicação de exemplo

Para este início rápido, use uma aplicação 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 forma mais fácil de começar é usando o modo interativo. Primeiro, autentique usando a CLI do GitHub:

gh auth login

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

modernize

O menu principal aparece:

○ 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

Passo 1: Avaliar a candidatura

  1. Selecione 1. Avaliar a candidatura.
  2. Siga as instruções para configurar as opções de avaliação (ou pressione Enter para usar os predefinidos).
  3. Revise as suas escolhas e pressione Enter para iniciar a avaliação.
  4. Espere que a avaliação termine.

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

  • Versões desatualizadas do framework
  • APIs obsoletas
  • Problemas de compatibilidade na cloud
  • Oportunidades de migração

Passo 2: Criar um plano de modernização

Após a avaliação terminar, o agente incentiva-o a criar 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. Crie um plano de modernização.
  2. Introduza o nome do plano ou pressione Enter para usar o nome padrão.
  3. Introduza o seu objetivo de modernização como um prompt. Por predefinição, o prompt é References the assessment summary and creates plan para criar um plano com base nos resultados da avaliação. Pode substituí-lo por qualquer outro pedido de migração, por exemplo:
    • migrate the database to Azure PostgreSQL
    • upgrade to Spring Boot 3
    • deploy to Azure Container Apps
  4. Carrega em Enter para gerar o plano.

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

  • Ficheiro do plano (.github/modernize/{plan-name}/plan.md): Estratégia e abordagem detalhadas.
  • Lista de tarefas (.github/modernize/{plan-name}/tasks.json): Análise dos passos executáveis.

Sugestão

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

Passo 3: Executar o plano de modernização

Depois de verificares o plano, confirma que queres executá-lo.

○ 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. Executar o plano de modernização.
  2. Carrega em Enter para executar o plano.
  3. Monitoriza o progresso à medida que o agente aplica alterações.

O agente executa cada tarefa por ordem:

  • Faz alterações ao código conforme o plano.
  • Valida as builds após cada alteração.
  • Analisa e corrige CVEs.
  • Confirma as alterações.

Passo 4: Rever os resultados

Depois de terminar a execução, pode rever todas as alterações que o agente fez antes de as fundir:

  1. Avaliar as alterações: Ver as modificações no ramo atual.

    git status
git diff main

  2. Crie um pull request: Se estiver satisfeito com as alterações, crie um PR para revisão da equipa.

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

Passos seguintes

Fornecer comentários

Valorizamos a sua opinião! Se tiveres algum feedback sobre o agente de modernização, cria um problema no repositório github-copilot-appmod ou usa o formulário de feedback de modernização do GitHub Copilot.

  • Last updated on