Guia de início rápido: crie e aplique suas próprias tarefas para a modernização do aplicativo GitHub Copilot

Este guia de início rápido mostra como criar e aplicar suas próprias tarefas ao usar a modernização do aplicativo GitHub Copilot.

No desenvolvimento de código, as empresas geralmente têm processos e controles diferentes para aderir às suas políticas organizacionais e necessidades de negócios. É nesta área que entram em cena as Minhas Tarefas (Personalizadas). Sua própria tarefa é gerada pela análise de confirmações de código de código já migrado. Em seguida, a tarefa orienta o Copilot a corrigir o código, seguindo o padrão estabelecido pelo código já migrado.

O vídeo a seguir demonstra o uso da modernização do aplicativo GitHub Copilot para criar e aplicar sua própria tarefa personalizada para migrar um projeto Java para o Azure:

Prerequisites

• Uma conta no GitHub com uma subscrição ativa do GitHub Copilot em qualquer plano.
• Um dos seguintes IDEs:
  • A versão mais recente do Visual Studio Code. Deve ser a versão 1.101 ou posterior.
    • Copiloto do GitHub no Visual Studio Code. Para obter instruções de configuração, consulte Configurar o Copilot do GitHub no Visual Studio Code. Certifique-se de entrar em sua conta do GitHub no Visual Studio Code.
    • Modernização do aplicativo GitHub Copilot. Reinicie o Visual Studio Code após a instalação.
  • A última versão do IntelliJ IDEA. Deve ser a versão 2023.3 ou posterior.
    • Copiloto do GitHub. Deve ser versão 1.5.59 ou posterior. Para obter mais instruções, consulte Configurar o Copilot do GitHub no IntelliJ IDEA. Certifique-se de fazer login na sua conta do GitHub no IntelliJ IDEA.
    • Modernização do aplicativo GitHub Copilot. Reinicie o IntelliJ IDEA após a instalação. Se você não tiver o GitHub Copilot instalado, poderá instalar a modernização do aplicativo GitHub Copilot diretamente.
• Java 21 ou posterior.
• Maven ou Gradle para construir projetos Java.

Observação

Se você estiver usando o Gradle, somente o wrapper Gradle versão 5+ é suportado. O Kotlin Domain Specific Language (DSL) não é suportado.

A função My Tasks ainda não é suportada pelo IntelliJ IDEA.

Crie a sua própria tarefa

Agora suportamos três formas de adicionar referências: commits Git, links externos e ficheiros de texto. Pode usar um ou mais métodos de cada vez.

Utilizar commits do Git

Os passos seguintes fornecem um exemplo de criação da sua própria tarefa usando commits Git como referência:

1. Clone o repositório de amostras do copiloto de migração Java .

2. No Visual Studio Code, abre a rabbitmq-sender pasta do projeto a partir do repositório clonado. Depois, muda para o ramo de origem .

3. Na barra lateral de Atividade, abra o painel de extensão de modernização da aplicação GitHub Copilot, passe o rato sobre a secção TAREFAS e depois selecione Criar uma Tarefa Personalizada.

   

4. Abre-se um task.md ficheiro. No campo Nome da Tarefa, introduza Tarefa personalizada migrar RabbitMQ. No campo Prompt de Tarefa, insira Você é um assistente de programador Spring Boot, siga o commit para migrar do RabbitMQ para o Service Bus.

   

5. Selecione Adicionar Referências e depois selecione commits Git na caixa de diálogo pop-up.

   

6. Procure o commit que migra o RabbitMQ escrevendo migrar rabbitmq para service bus. Selecione a confirmação correspondente e, em seguida, selecione OK.

   

7. Selecione Guardar. A sua tarefa personalizada para migração rabbitmq aparece agora na secção TAREFAS - Minhas Tarefas .

   

Usar ligações externas e ficheiros de texto

Os passos seguintes mostram um exemplo de criação da sua própria tarefa usando links externos e ficheiros de texto como referências:

1. Abra o task.md ficheiro seguindo os passos pré-definidos na extensão de modernização da aplicação GitHub Copilot.

2. No ficheiro aberto task.md , introduza a seguinte informação:

   • Nome da Tarefa: Disponibilizar o endpoint de saúde através do Spring Boot Actuator.
   • Prompt de Tarefa: Você é um assistente de desenvolvedor Spring Boot, siga a documentação do Spring Boot Actuator para adicionar endpoints básicos de monitorização de saúde para o desdobramento no Azure Container Apps.

   

3. Selecione Adicionar Referências. Na janela pop-up, selecione Links externos, depois cole o seguinte URL: https://docs.spring.io/spring-boot/reference/actuator/endpoints.html e pressione Enter para confirmar.

   

4. Crie um ficheiro contendo o seguinte conteúdo:

   In this migration, only expose the health endpoints over web, use the following property:
   management.endpoints.web.exposure.include=health
   

5. Selecione novamente Adicionar Referências e, desta vez, selecione Ficheiros de Texto. Localiza o ficheiro que criaste e depois seleciona Selecionar Ficheiro.

6. Agora deverá ver duas referências adicionadas: um link externo e um ficheiro de texto. Seleciona Guardar para finalizar e cria a tarefa.

   

Partilhe a sua própria tarefa

Use os seguintes passos para partilhar a sua tarefa com os outros:

1. Copie a pasta localizada em .github/appmod/custom-tasks que contém a tarefa criada e partilhe-a com o destinatário pretendido.

   

2. Do lado do destinatário, cria um diretório .github/appmod/custom-tasks dentro do caminho de origem do projeto.

   

3. Cole a pasta de tarefas neste diretório e depois selecione Atualizar Tarefa no painel de extensão.

   

4. A tarefa aparece agora na secção TASKS - As Minhas Tarefas , pronta a ser usada.

   

Aplique a sua própria tarefa

Use as seguintes etapas para aplicar sua própria tarefa:

1. Selecione Executar no final do ficheiro. Ou encontre a sua própria tarefa na secção TASKS - Minhas Tarefas do painel de modernização da aplicação GitHub Copilot e execute a tarefa selecionando Executar Tarefa.

   

2. A janela de chat do Copilot abre-se no Modo Agente e executa automaticamente os seguintes passos:

   • Cria plan.md e progress.md.
   • Verifica o estado do controlo de versões e verifica uma nova ramificação de migração.
   • Realiza migração de código.
   • Executa validações: Build, Testes, CVE, Consistência e Completude.
   • Gera um ficheiro summary.md .

3. Se o agente parar enquanto espera pela sua confirmação ou for interrompido durante a execução, introduza Continuar para prosseguir.

4. Depois de todos os passos concluídos, revê as alterações ao código e depois seleciona Guardar para confirmar na janela do chat.

Atualize ou elimine a sua própria tarefa

Localize a migração de tarefas personalizadas rabbitmq na secção TASKS - Minhas Tarefas e depois clique com o botão direito para abrir o menu contextual e escolher uma das seguintes opções:

• Edit para atualizar a tarefa.
• Apagar para remover a tarefa.

Próximo passo

Tarefas predefinidas para a modernização do aplicativo GitHub Copilot