Plano de lote com o agente de modernização do GitHub Copilot

O plano em lote permite que você gere planos de modernização para vários repositórios usando um fluxo de trabalho e uma meta de modernização compartilhada. Este artigo mostra como criar planos consistentes em vários aplicativos antes de iniciar a execução.

Usando o plano em lote, você pode:

• Crie planos para vários aplicativos em um fluxo de trabalho guiado.
• Aplique uma meta de modernização consistente entre repositórios.
• Use os resultados da avaliação como contexto para melhorar a qualidade do plano.
• Examine os planos antes da execução e decida quais repositórios modernizar primeiro.

O plano em lote fornece os seguintes benefícios:

• Consistência e controle:

  • Objetivo compartilhado: comece com um único prompt de modernização em todos os repositórios.
  • Resultados comparáveis: analise os planos lado a lado antes de executá-los.
  • Refinamento flexível: edite cada plano gerado para refletir as necessidades específicas do repositório.

• Planejamento em escala:

  • Visibilidade do portfólio: entenda como a mesma solicitação se aplica entre aplicativos.
  • Preparação reutilizável: reutilize a mesma lista de repositórios e as saídas de avaliação de estágios anteriores.
  • Tomada de decisão mais rápida: gere planos primeiro e execute apenas os repositórios aprovados.

Pré-requisitos

• Modernizar a CLI.
• Acesso a todos os repositórios que você deseja incluir no planejamento.
• Autenticação do GitHub configurada (gh auth login).
• Uma avaliação em lote concluída (recomendada) se você quiser que o agente use as conclusões da avaliação como contexto de planejamento.

Configurar repositórios

O agente de modernização dá suporte a várias maneiras de especificar os repositórios que você deseja planejar:

• Pasta atual: crie um plano para o projeto no diretório de trabalho atual.
• Entrada manual: insira caminhos de diretório local ou URLs remotas do Git diretamente.
• Arquivo de configuração do repositório: use um arquivo de configuração JSON que lista todos os repositórios.

Arquivo de configuração do repositório

Para operações em lotes em vários repositórios, crie um arquivo de configuração JSON para listar todos os repositórios. Por exemplo, crie-o em .github/modernize/repos.json seu diretório de trabalho ou forneça um caminho personalizado.

Formato (matriz de repositórios):

[
    {
        "name": "PhotoAlbum-Java",
        "url": "https://github.com/Azure-Samples/PhotoAlbum-Java.git"
    },
    {
        "name": "PhotoAlbum",
        "url": "https://github.com/Azure-Samples/NewsFeedSite.git"
    }
]

Cada entrada de repositório dá suporte aos seguintes campos:

O agente de modernização detecta automaticamente o arquivo repos.json em .github/modernize/repos.json quando você seleciona De um arquivo de configuração no modo interativo. Você também pode fornecer um caminho personalizado.

Como funciona o plano em lote

O fluxo de trabalho de planejamento em lote:

1. Seleção do repositório: escolha os repositórios que você deseja incluir.
2. Seleção de contexto: opcionalmente, use relatórios de avaliação disponíveis como entrada.
3. Definição de prompt: Descreva seu objetivo de modernização uma vez e aplique-o em todos os repositórios.
4. Esclarecimento: responda a todas as perguntas de acompanhamento do agente.
5. Geração de planos: o agente cria um plano para cada repositório selecionado.

Cada plano gerado é salvo no repositório de destino e pode ser revisado ou editado antes da execução.

Executar plano em lote

Depois de configurar seus repositórios, inicie o fluxo de trabalho de planejamento em lote.

Modo interativo

1. Execute o agente de modernização:

   modernize
   

2. Selecione Planejar no menu principal.

   ○ 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
   

3. Escolha como especificar seus repositórios de destino. Selecione De um arquivo de configuração para usar um repos.json arquivo.

   ○ Choose target repositories
   
       1. Current folder
         /Users/username/project
       2. Manual input
         Enter local path or remote URL
     > 3. From a config file
         /path/to/.github/modernize/repos.json
   

   Dica

   Você também pode selecionar entrada manual para inserir caminhos locais ou URLs remotas do Git diretamente ou pasta atual para planejar o projeto em seu diretório atual.

4. Se o repos.json arquivo for detectado no local padrão, o agente o preencherá automaticamente. Caso contrário, insira o caminho para o arquivo de configuração e pressione Enter.

5. Todos os repositórios são selecionados por padrão. Desmarque todos os repositórios que você deseja ignorar e pressione Enter para confirmar sua seleção.

   • Use teclas de direção para navegar e pressionar Espaço para alternar repositórios individuais.

6. Selecione 1. Mantenha o plano local para gerar planos em seu computador ou escolha 2. Envie ao Agente de Nuvem para que um agente de nuvem os gere. A opção 2 é experimental.

7. Insira um nome de plano ou pressione Enter para usar o padrão.

8. Insira sua meta de modernização como uma instrução. Por exemplo:

   • upgrade to Spring Boot 3 and prepare for Azure deployment
   • migrate the database to Azure PostgreSQL
   • containerize the application and deploy to Azure Container Apps

9. Pressione Enter para gerar os planos.

10. O agente automaticamente:

    • Clona cada repositório selecionado ou envia um trabalho para um agente de nuvem para cada repositório.
    • Gera um plano para cada repositório localmente ou uma PR com o plano em cada repositório.

Próximas Etapas 

Depois de concluir o plano em lote, examine os planos e execute-os usando o execute comando:

• Saiba mais sobre os comandos da CLI.
• Crie habilidades personalizadas para padrões específicos da organização.

Fornecer comentários

Se você tiver feedback sobre o plano em lote ou o agente de modernização, abra uma issue no repositório github-copilot-appmod ou use o formulário de feedback sobre modernização do GitHub Copilot.