Guia de início rápido: avaliar e migrar um projeto Java usando a modernização do aplicativo GitHub Copilot

Este guia de 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 o Azure Managed Identity em vez de um nome de usuário e 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 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.

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

Há duas maneiras de atualizar sua versão do JDK. Ambas as 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 Upgrade Runtime & Frameworks na seção QUICKSTART . Outra maneira é executar a tarefa Upgrade Java Runtime na seção TASKS - Upgrade Tasks . Para obter mais informações, consulte Guia de início rápido: atualizar um projeto Java com a modernização do aplicativo GitHub Copilot.

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

Avalie a prontidão da nuvem

Use as etapas a seguir para iniciar seu 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 quão impactantes eles são. 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 amostras do copiloto de migração Java e, em seguida, faça check-out na ramificação de origem .

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

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

   

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

5. O assessor de modernização abre agora 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 avaliador de modernização verifica primeiro o 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 o AppCAT para avaliar o projeto atual. Esta etapa pode levar vários minutos para ser concluída.

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

   

8. Ao revisar o relatório de resumo, você pode selecionar Migrar para o Banco de Dados SQL do Azure (Spring) na lista de soluções sob o problema Migração de Banco de Dados (Microsoft SQL). Em seguida, selecione Executar tarefa para passar 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 de migração comuns 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 bate-papo 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 precisar de confirmação para prosseguir. plan.md e progress.md são gerados primeiro, e pode-se revisar 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 qualquer alteração de código, o agente verifica o estado do sistema de controle de versão e cria um novo ramo para migração.

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

Iteração de validação

Depois que as alterações de código forem concluídas, insira manualmente continue para avançar com a validação e o loop de iteração de correção. Este loop inclui as seguintes cinco partes:

• Aplique a Validate-CVEs ferramenta. Esta ferramenta tenta detetar vulnerabilidades e exposições comuns (CVEs) nas dependências atuais e as corrige.
• Aplique a Build-Project ferramenta. Esta ferramenta tenta resolver quaisquer erros de compilação.
• Aplique a Consistency-Validation ferramenta. Esta ferramenta analisa os códigos para consistência funcional.
• Aplique a Run-Test ferramenta. Esta ferramenta analisa o projeto em busca de 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 itens de migração perdidos na migração inicial de código e os corrige.

Após a conclusão de todos os processos, introduza continue para gerar o resumo da migração como etapa final. Revise as alterações de código e confirme-as selecionando Manter.

Gerar casos de teste unitários

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 Qualidade & Tarefas de Segurança e 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 Guia de início rápido: gerar testes de unidade com a modernização do aplicativo GitHub Copilot.

Próximos passos

• Trabalhar com avaliação
• Guia de início rápido: crie e aplique suas próprias tarefas