Início Rápido: avaliar e migrar um projeto Java usando a modernização do aplicativo GitHub Copilot

Este início rápido mostra como usar a modernização do aplicativo GitHub Copilot para avaliar e migrar um projeto Java. Neste início rápido, você instala e configura a extensão e, em seguida, avalia e migra um projeto de exemplo. Por exemplo, você usa uma tarefa predefinida para atualizar uma conexão de banco de dados SQL do Azure para usar a Identidade Gerenciada do Azure em vez de um nome de usuário e uma senha.

O vídeo a seguir demonstra como a modernização do aplicativo GitHub Copilot usa o AppCAT para ajudar a avaliar um projeto Java para migração para o Azure:

Prerequisites

• Uma conta do Azure com uma assinatura ativa. Crie um gratuitamente.

• Uma conta do GitHub com uma assinatura 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.
    • GitHub Copilot no Visual Studio Code. Para obter instruções de instalação, consulte Configurar o GitHub Copilot 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 versão mais recente do IntelliJ IDEA. Deve ser a versão 2023.3 ou posterior.
    • GitHub Copilot. Deve ser a versão 1.5.59 ou posterior. Para obter mais instruções, consulte Configurar o GitHub Copilot no IntelliJ IDEA. Certifique-se de entrar em 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 diretamente a modernização do aplicativo GitHub Copilot.
• Java 21 ou posterior.
• Maven ou Gradle para criar projetos Java.

Observação

Se você estiver usando o Gradle, somente o wrapper Gradle versão 5+ terá suporte. Não há suporte para a DSL (Linguagem Específica do Domínio Kotlin).

A função My Tasks ainda não tem suporte para IntelliJ IDEA.

Atualizar o JDK e as versões de dependência

Há duas maneiras de atualizar sua versão do JDK. As duas maneiras usam o painel de modernização do aplicativo GitHub Copilot no Visual Studio Code, que você pode acessar na barra lateral.

Uma maneira de atualizar sua versão do JDK é selecionar Atualizar Runtime &Frameworks na seção INÍCIO RÁPIDO . Outra maneira é executar a tarefa Runtime do Java Atualizado na seção TAREFAS – Tarefas de Upgrade. Para obter mais informações, consulte Início Rápido: atualizar um projeto Java com a modernização do aplicativo GitHub Copilot.

Para atualizar o Spring Framework ou uma dependência de terceiros, execute a tarefa Atualizar o Java Framework na seção TAREFAS – Tarefas de Atualização . Para obter mais informações, consulte Atualizar uma estrutura Java ou dependência de terceiros usando a modernização do aplicativo GitHub Copilot.

Avaliar a preparação da nuvem

Use as etapas a seguir para iniciar o processo de migração com a avaliação da solução. Essa avaliação ajuda você a entender quais são seus desafios de preparação para a nuvem e o quão impactantes eles são. Ele também fornece soluções recomendadas. Uma recomendação de solução inclui referências para configurar recursos do Azure, adicionar configurações e fazer alterações de código.

1. Clone o repositório de exemplos do copilot de migração Java e realize o check-out para o ramo source.

2. No Visual Studio Code, abra a pasta de projeto mi-sql-public-demo no repositório de exemplos.

3. Na barra lateral, selecione o painel de modernização do aplicativo GitHub Copilot , no qual você pode selecionar Migrar para o Azure ou Executar Avaliação na seção AVALIAÇÃO .

   

4. A janela de chat do GitHub Copilot com o modo de agente é aberta para chamar o assessor de modernização para executar a avaliação de modernização do aplicativo. Selecione Continuar para confirmar.

5. O assessor de modernização agora abre appcat.log. Esse arquivo mostra os logs para executar o AppCAT, que executa a avaliação do aplicativo. Selecione Continuar para confirmar novamente.

6. O assessor de modernização verifica primeiro seu ambiente local. Se o AppCAT e suas dependências não estiverem instalados, o agente ajudará você a instalá-los. Após a instalação, o agente chama AppCAT para avaliar o projeto atual. Essa etapa pode levar vários minutos para ser concluída.

7. Após a conclusão da análise, o assessor de modernização produz uma exibição categorizada dos problemas de preparação da nuvem em um Relatório de Avaliação aberto.

   

8. Ao revisar o relatório de resumo, você pode selecionar Migrar para Banco de Dados SQL do Azure (Spring) na lista de soluções sob a questão Migração de Banco de Dados (Microsoft SQL). Em seguida, selecione Executar Tarefa para ir para o estágio de correção de código.

   

Aplicar uma tarefa predefinida

Para migração, o Copilot fornece tarefas predefinidas para cenários comuns de migração que você pode enfrentar ao migrar para o Azure. Por exemplo, com o exemplo mi-sql-public-demo , a tarefa Migração de Banco de Dados (Microsoft SQL) altera a conexão do banco de dados SQL do Azure para usar a Identidade Gerenciada do Azure em vez de um nome de usuário e senha.

Para aplicar uma tarefa predefinida, use as seguintes etapas:

1. No Relatório de Avaliação, selecione Executar Tarefa. A janela de chat do Copilot é aberta com o Modo de Agente selecionado.

2. O agente copilot usa várias ferramentas para modernização do aplicativo e cada ferramenta pode exigir confirmação para continuar. plan.md e progress.md são gerados primeiro e você pode examinar plan.md e fazer alterações lá, se necessário.

3. Insira manualmente continue para confirmar e iniciar o processo de migração.

4. Antes de fazer alterações de código, o agente verifica o status do sistema de controle de versão e verifica um novo branch para migração.

5. Selecione ou insira repetidamente Continue a confirmar o uso de ferramentas ou comandos e aguarde a conclusão das alterações de código.

Iteração de validação

Após a conclusão das alterações de código, insira manualmente continue para prosseguir com o loop de validação e iteração de correção. Esse loop inclui as cinco partes a seguir:

• Aplique a Validate-CVEs ferramenta. Essa ferramenta tenta detectar CVEs (Vulnerabilidades e Exposições Comuns) nas dependências atuais e as corrige.
• Aplique a Build-Project ferramenta. Essa ferramenta tenta resolver erros de build.
• Aplique a Consistency-Validation ferramenta. Essa ferramenta analisa os códigos para consistência funcional.
• Aplique a Run-Test ferramenta. Essa ferramenta analisa o projeto para falhas de teste de unidade e gera automaticamente um plano para corrigi-las. A Run-Test ferramenta executa iterativamente testes de unidade e corrige quaisquer falhas.
• Aplique a Completeness-Validation ferramenta. Essa ferramenta captura os itens de migração perdidos na migração de código inicial e os corrige.

Depois que todos os processos forem concluídos, digite continue para gerar o resumo da migração como a etapa final. Examine as alterações de código e confirme-as selecionando Manter.

Gerar casos de teste de unidade

Para gerar casos de teste de unidade, use as seguintes etapas:

1. Na barra lateral, selecione o painel de modernização do aplicativo GitHub Copilot .

2. Na seção TAREFAS , abra As Tarefas de Qualidade e Segurança e, em seguida, selecione Gerar Casos de Teste de Unidade.

O agente gera testes de unidade e cria um TestReport para mostrar os resultados do teste antes e depois da geração. Para obter mais informações, consulte Início Rápido: gerar testes de unidade com a modernização do aplicativo GitHub Copilot.

Próximas etapas

• Trabalhando com a avaliação
• Início Rápido: criar e aplicar suas próprias tarefas