Migrar aplicativos Java para Aplicativos de Contêiner do Azure usando a modernização do aplicativo GitHub Copilot

Neste artigo, você aprenderá a usar a modernização do aplicativo GitHub Copilot para avaliar, corrigir, colocar em contêiner e implantar aplicativos Java nos Aplicativos de Contêiner do Azure. A modernização do aplicativo GitHub Copilot é um assistente movido por IA que combina o GitHub Copilot com ferramentas de software livre, como OpenRewrite, para automatizar etapas complexas de atualização e migração.

A ferramenta dá suporte a projetos Maven e Gradle, direciona atualizações entre as versões 8, 11, 17 e 21 do Java e se concentra na modernização de aplicativos Spring Boot. Ele fornece tarefas predefinidas para cenários comuns de migração e incorpora práticas recomendadas para executar aplicativos em Aplicativos de Contêiner do Azure.

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Criar um gratuitamente.
• Uma conta GitHub com uma assinatura GitHub Copilot ativa em qualquer plano.
• Um dos seguintes editores:
  • A versão mais recente do Visual Studio Code. Deve ser a versão 1.106 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 GitHub dentro de 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.
• Java 21 ou posterior.
• Maven ou Gradle para criar projetos Java.
• Docker instalado e em execução (para contêinerização).
• CLI do Azure instalada e configurada.

Atualizar o JDK e as versões da estrutura

Antes de migrar para os Aplicativos de Contêiner do Azure, verifique se seu aplicativo Java é executado em uma versão do JDK suportada e atualizada. A atualização do JDK e dos frameworks primeiro garante que as etapas subsequentes de migração visem uma base de código moderna.

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

1. Selecione Atualizar Runtime &Frameworks na seção INÍCIO RÁPIDO .
2. Como alternativa, execute a tarefa Java Runtime atualizado na seção TAREFAS – Tarefas de Atualização.

Para atualizar o Spring Framework ou uma dependência que não seja da Microsoft, execute a tarefa Atualizar o Java Framework na seção TAREFAS – Tarefas de Atualização .

Avaliar a preparação da nuvem para aplicativos de contêiner do Azure

A avaliação identifica os desafios de preparação da nuvem em sua base de código e classifica seu impacto. Ele fornece recomendações específicas para Aplicativos de Contêiner do Azure.

Configurar a avaliação

Antes de executar a avaliação, configure-a selecionando Configurar Avaliação no painel avaliação de modernização do aplicativo GitHub Copilot.

Para aplicativos de contêiner do Azure, use a seguinte configuração:

appcat:
- target:
    - azure-container-apps
  os:
    - linux
  mode: source-only

Executar a avaliação

Use as seguintes etapas para executar a avaliação:

1. Na barra lateral, selecione o painel de modernização do aplicativo GitHub Copilot e selecione Migrar para o Azure ou Executar Avaliação na seção AVALIAÇÃO .

   

2. A janela de chat do GitHub Copilot com o modo de agente é aberta para chamar o assessor de modernização. Selecione Continuar para confirmar.

3. 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á-las. Após a instalação, o agente chama AppCAT para avaliar seu projeto. Essa etapa pode levar vários minutos para ser concluída.

4. Quando a avaliação é concluída, o assessor de modernização produz uma exibição categorizada dos problemas de preparação da nuvem no Relatório de Avaliação.

   

Interpretar o relatório de avaliação

O relatório de avaliação fornece resultados de análise abrangentes. O relatório consiste em várias seções principais:

• Informações do aplicativo: informações básicas, incluindo versão java, estruturas, ferramentas de build, estrutura de projeto e serviço do Azure de destino.
• Resumo do Problema: Visão geral dos problemas de migração categorizados pelo domínio com percentuais de criticidade.
• Análise Detalhada organizada em quatro abas:
  • Problemas: uma lista categorizada de problemas de preparação para a nuvem e atualização do Java que você precisa resolver.
  • Dependências: todas as dependências empacotadas em Java encontradas no aplicativo.
  • Tecnologias: tecnologias agrupadas por função encontradas no aplicativo analisado.
  • Insights: Detalhes do arquivo e informações para ajudá-lo a entender as tecnologias detectadas.

O relatório categoriza os problemas pelos seguintes níveis de criticidade:

Você pode expandir cada problema relatado para ver uma lista de arquivos afetados e uma descrição detalhada, incluindo o problema, soluções conhecidas e documentação de suporte.

Gerenciar relatórios de avaliação

A extensão dá suporte à importação, exportação e exclusão de relatórios de avaliação para que você possa compartilhar descobertas com sua equipe ou manter seu workspace organizado.

• Importação: selecione Importar na seção de avaliação para importar relatórios dos resultados da CLI do AppCAT , um relatório exportado ou um arquivo de contexto do aplicativo.
• Exportar: clique com o botão direito do mouse no Relatório de Avaliação e selecione Exportar para compartilhar relatórios com outras pessoas.
• Excluir: clique com o botão direito do mouse no Relatório de Avaliação e selecione Excluir para remover um relatório.

Corrigir problemas de migração

Depois de concluir a avaliação, corrija os problemas identificados usando tarefas predefinidas ou personalizadas. A modernização do aplicativo GitHub Copilot fornece duas abordagens: tarefas predefinidas que abordam padrões comuns de migração e tarefas personalizadas que você define para as necessidades específicas da sua organização.

Selecione o agente AppModernization

O agente AppModernization fornece a melhor experiência para tarefas de migração e modernização de aplicativos Java. Para selecioná-lo:

1. Abra a janela de chat do Copilot selecionando o ícone de chat na Barra de Atividades.
2. Na janela de chat, localize o menu suspenso do seletor de agente na parte superior da caixa de entrada do chat e selecione AppModernization na lista.

Com o agente AppModernization selecionado, use prompts de linguagem simples e natural para executar tarefas de migração.

• Migração de banco de dados: migrate to Managed Identity for Azure SQL Database
• Migração de armazenamento: migrate from AWS S3 to Azure Storage Blob
• Migração de mensagens: migrate from RabbitMQ to Azure Service Bus
• Gerenciamento de segredos: migrate secrets to Azure Key Vault
• Migração de autenticação: migrate to Microsoft Entra ID authentication

Executar tarefas de migração predefinidas

O recurso de modernização do aplicativo GitHub Copilot dá suporte às seguintes tarefas predefinidas para migrações de Aplicativos de Contêiner do Azure:

Aplicar uma tarefa predefinida da avaliação

1. No Relatório de Avaliação, selecione a solução desejada em um problema detectado e selecione Executar Tarefa.
2. A janela de chat do Copilot é aberta com o Modo do Agente. O agente gera plan.md e progress.md, e você pode examinar o plano antes de prosseguir.
3. Insira continue manualmente 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 cria uma nova ramificação.
5. Selecione ou insira repetidamente Continuar confirmando o uso da ferramenta e aguarde a conclusão das alterações de código.

Examinar os resultados da validação

Depois de concluir as alterações de código, o agente executará um loop de validação automática que inclui as seguintes verificações:

1. Validate-CVEs: detecta vulnerabilidades e exposições comuns nas dependências atuais e as corrige.
2. Build-Project: tenta resolver erros de build.
3. Consistência-validação: analisa o código para consistência funcional.
4. Teste de execução: executa testes de unidade e gera automaticamente um plano para corrigir falhas.
5. Completeness-Validation: captura itens de migração perdidos na migração de código inicial e os corrige.

Depois que todas as verificações terminarem, insira continue para gerar o resumo da migração. Examine as alterações de código e confirme selecionando Manter.

Criar tarefas personalizadas

Além de tarefas predefinidas, você pode criar tarefas personalizadas com base nos padrões de migração específicos da sua organização. As tarefas personalizadas usam referências de confirmações do Git, links externos ou arquivos de texto para orientar o agente de migração.

Criar uma tarefa personalizada com base em confirmações do Git

1. Na barra lateral atividade, abra o painel de extensão de modernização do aplicativo GitHub Copilot, passe o mouse sobre a seção TAREFAS e selecione Criar uma Tarefa Personalizada.

   

2. No arquivo aberto task.md , insira o nome da tarefa e o prompt de tarefa.

   

3. Selecione Adicionar Referências e selecione Confirmações do Git na caixa de diálogo pop-up.

   

4. Pesquise e selecione a confirmação relevante e selecione OK.

   

5. Clique em Salvar. Sua tarefa personalizada agora aparece na seção TAREFAS – Minhas Tarefas .

   

Criar uma tarefa personalizada com base em links externos e arquivos de texto

1. Abra o task.md arquivo e insira o nome da tarefa e o prompt. Por exemplo:

   • Nome da tarefa: Expose health endpoint via Spring Boot Actuator
   • Prompt de tarefa: You are a Spring Boot developer assistant, follow the Spring Boot Actuator documentation to add basic health endpoints for Azure Container Apps deployment.

   

2. Selecione Adicionar Referências, selecione Links externos e cole a referência de URL. Selecione Adicionar Referências novamente, selecione Arquivos de Texto e adicione um arquivo com instruções extras.

3. Selecione Salvar para criar a tarefa.

   

Compartilhar tarefas personalizadas

Você pode compartilhar tarefas personalizadas com outros membros da equipe compartilhando a pasta de tarefas.

Para compartilhar uma tarefa personalizada, copie a pasta .github/appmod/custom-tasks e compartilhe-a com o destinatário pretendido. O destinatário cola a pasta de tarefas no .github/appmod/custom-tasks diretório e seleciona Atualizar Tarefa no painel de extensão.

Executar uma tarefa personalizada

Selecione Executar na parte inferior do arquivo de tarefa ou localize sua tarefa na seção TAREFAS – Minhas Tarefas e selecione Executar Tarefa. A janela de chat do Copilot é aberta no Modo do Agente e executa automaticamente o fluxo de trabalho de migração.

Se o aplicativo usar um banco de dados Oracle, prossiga para a próxima seção. Caso contrário, pule para Contêinerizar seu aplicativo.

Migrar do Oracle para o PostgreSQL

A modernização de aplicativos do GitHub Copilot fornece uma tarefa de migração dedicada para o cenário de migração do Oracle para o Azure Database for PostgreSQL, que inclui:

• Ferramentas de migração de banco de dados habilitadas para IA: para obter mais informações, consulte O que é a extensão PostgreSQL para visualização do Visual Studio Code?.
• Conversão de SQL inteligente no código do aplicativo: funcionalidade de conversão de SQL interna na modernização do aplicativo GitHub Copilot, integrada perfeitamente como parte de um fluxo de trabalho de tarefa unificado.

Use a tarefa de migração Oracle para PostgreSQL

1. Execute a avaliação do aplicativo conforme descrito em Avaliar a preparação da nuvem para aplicativos de contêiner do Azure.

2. Após a conclusão da avaliação, examine o relatório. Se o aplicativo usar o Oracle, o relatório revelará um problema relacionado à Migração de Banco de Dados (Oracle) com a solução padrão Migrar do Oracle DB para o PostgreSQL.

   

3. Opcionalmente, verifique se coding_notes.md está presente na .github/postgre-migrations/*/results/application_guidance/ pasta. Se estiver presente, a modernização do aplicativo referencia essas notas para a conversão de SQL de maior qualidade. Caso contrário, entre em contato com sua equipe de banco de dados para gerá-los usando a extensão do Visual Studio Code do PostgreSQL.

4. Selecione Executar Tarefa para executar a migração.

   

Colocar seu aplicativo em contêiner

Depois de concluir a migração de código, conteinerize seu aplicativo Java para prepará-lo para implantação nos Aplicativos de Contêiner do Azure.

1. Verifique se você tem o Docker instalado e em execução.

2. No Visual Studio Code, abra o projeto migrado.

3. Na barra lateral de Atividade, abra o painel de extensão de modernização do aplicativos GitHub Copilot.

4. Na seção Tarefas , abra o Java e, em seguida, abra Tarefas de Contêiner e selecione Containerize Application.

   

5. Confirme cada ação de ferramenta selecionando Continuar quando solicitado.

6. Copilot passa pelas seguintes etapas:

   • Verifica se o Docker está instalado e em execução.
   • Verifica se o código do aplicativo está pronto para ser executado em um contêiner.
   • Cria um Dockerfile para cada projeto.
   • Cria imagens do Docker para cada projeto.
   • Cria um resumo dos resultados da contêinerização.

Para obter mais informações sobre as ferramentas de contêinerização, consulte o repositório de assistência de contêineres no GitHub.

Implantar nos Aplicativos de Contêiner do Azure

Depois de colocar seu aplicativo em contêiner, implante-o nos Aplicativos de Contêiner do Azure.

1. No Visual Studio Code, abra o projeto migrado.

2. Na barra lateral de Atividade, abra o painel da extensão de modernização do aplicativo GitHub Copilot.

3. Na seção Tarefas , abra Java, abra Tarefas de Implantação e selecione uma das seguintes opções de implantação:

   • Implantar na infraestrutura existente do Azure: o Copilot solicita seu grupo de recursos existente e implanta nos recursos correspondentes.
   • Provisionar infraestrutura e implantar no Azure: o Copilot cria novos recursos do Azure e implanta seu projeto.

   

4. Confirme cada ação de ferramenta selecionando Continuar quando solicitado e forneça as informações necessárias, como assinatura e grupo de recursos.

5. Copilot passa pelas seguintes etapas:

   • Gera um arquivo markdown de plano de implantação com a meta de implantação, as informações do projeto, a arquitetura de recursos do Azure, os recursos do Azure e as etapas de execução.
   • Siga as etapas previstas de execução no plano.
   • Corrige os erros de implantação.
   • Gera um arquivo de resumo que explica os resultados da implantação.

Melhores práticas pós-migração

Depois de migrar seu aplicativo Java para os Aplicativos de Contêiner do Azure, considere as seguintes práticas recomendadas:

• Configurar as investigações de integridade: configure as investigações de integridade para permitir que os Aplicativos de Contêiner do Azure monitorem a integridade do aplicativo.
• Configurar o registro de logs: configure o log baseado em console para se integrar ao Azure Monitor para agregação e análise centralizadas de logs.
• Configurar regras de dimensionamento: configureregras de dimensionamento com base no tráfego HTTP, CPU, memória ou métricas personalizadas para lidar com cargas de trabalho variadas.
• Gerenciar segredos: use o gerenciamento de segredos dos Aplicativos de Contêiner do Azure ou o Azure Key Vault para armazenar e acessar com segurança valores de configuração confidenciais.
• Configurar os pipelines de CI/CD: automatize sua pipeline de implantação utilizando o GitHub Actions ou o Azure Pipelines para integração e entrega contínuas.
• Habilitar as implantações azul-verde: use as revisões e a divisão de tráfego para implementar implantações sem tempo de inatividade.
• Configurar domínios personalizados: configurar domínios e certificados personalizados para tráfego de produção.
• Monitorar com métricas e alertas: proativamente, use as métricas e os alertas para monitorar a integridade e o desempenho do aplicativo.
• Habilitar redundância de zona: configure a redundância de zona para alta disponibilidade entre zonas de disponibilidade.

Conteúdo relacionado

• Documentação de modernização de aplicativos do GitHub Copilot
• Modernização do aplicativo GitHub Copilot para desenvolvedores Java
• Tarefas predefinidas para a modernização do aplicativo GitHub Copilot
• Visão geral dos Aplicativos de Contêiner do Azure
• Início Rápido: Implantar seu primeiro aplicativo de contêiner