Avaliação de aplicação e código das Migrações para Azure para Java versão 7 (versão prévia)

Observação

Este artigo destina-se à próxima geração de avaliação de aplicação e código das Migrações para Azure para Java, versão 7.x. Essa versão está em versão prévia. Para a versão estável anterior, versão 6.x, consulte Avaliação de aplicação e código das Migrações para Azure para Java.

Este artigo mostra como usar a ferramenta de avaliação de aplicação e código das Migrações para Azure para Java para avaliar e alterar a plataforma de qualquer tipo de aplicativo Java. A ferramenta permite que você avalie a preparação do aplicativo para reformular e migrar para o Azure. Essa ferramenta é oferecida como uma CLI (interface de linha de comando) e avalia binários e códigos-fonte de aplicativos Java para identificar oportunidades de alteração de plataforma e migração para o Azure. Ajuda você a modernizar e reformular aplicativos Java em grande escala, identificando casos de uso e padrões de código comuns e propondo alterações recomendadas.

A ferramenta descobre o uso da tecnologia de aplicativo por meio da análise de código estático, fornece estimativa de esforço e acelera a reformulação do código. Essa avaliação ajuda você a priorizar e mover aplicativos Java para o Azure. Com um conjunto de mecanismos e regras, a ferramenta pode descobrir e avaliar diferentes tecnologias, como Java 11, Java 17, Jakarta EE, Spring, Hibernate, JMS (Java Message Service) e muito mais. A ferramenta ajuda você a alterar a plataforma do aplicativo Java para diferentes destinos do Azure (Serviço de Aplicativo do Azure, Serviço de Kubernetes do Azure e Aplicativos de Contêiner do Azure) com regras específicas de alteração de plataforma do Azure.

A ferramenta é baseada em um conjunto de componentes do Cloud Native Computing Foundation, no projeto Konveyor, criado e conduzido pela Red Hat.

Visão geral

A ferramenta foi projetada para ajudar as organizações a modernizar seus aplicativos Java de forma a reduzir custos e habilitar uma inovação mais rápida. A ferramenta usa técnicas avançadas de análise para entender a estrutura e as dependências dos aplicativos Java e fornece diretrizes sobre como refatorar e migrar os aplicativos para o Azure.

Com ela, você pode executar as seguintes tarefas:

Descubra o uso da tecnologia: veja rapidamente quais tecnologias um aplicativo usa. A descoberta é útil se você tiver aplicativos herdados com pouca documentação e quiser saber quais tecnologias eles usam.
Avalie o código para um destino específico: avalie um aplicativo para um destino específico do Azure. Verifique o esforço e as modificações que você precisa fazer para reformular seus aplicativos no Azure.

Destinos compatíveis

A ferramenta contém regras para ajudar você a reformular seus aplicativos para poder implantar e usar diferentes serviços do Azure.

As regras usadas pela avaliação de aplicação e código das Migrações para Azure são agrupadas com base em um destino. Um destino é onde ou como o aplicativo é executado, além de necessidades e expectativas gerais. Ao avaliar um aplicativo, você pode escolher vários destinos. A tabela a seguir descreve os destinos disponíveis:

Nome de destino	Descrição	Destino
Serviço de aplicativo do Azure	Melhores práticas para implantar um aplicativo no Serviço de Aplicativo do Azure.	`azure-appservice`
Serviço de Kubernetes do Azure	Melhores práticas para implantar um aplicativo no Serviço de Kubernetes do Azure.	`azure-aks`
Aplicativos de Contêiner do Azure	Melhores práticas para implantar um aplicativo nos Aplicativos de Contêiner do Azure.	`azure-container-apps`
Preparação da nuvem	Melhores práticas gerais para preparar uma nuvem de aplicativos (Azure).	`cloud-readiness`
Linux	Melhores práticas gerais para preparar um aplicativo Linux.	`linux`
OpenJDK 11	Melhores práticas gerais para executar um aplicativo Java 8 com o Java 11.	`openjdk11`
OpenJDK 17	Melhores práticas gerais para executar um aplicativo Java 11 com o Java 17.	`openjdk17`
OpenJDK 21	Melhores práticas gerais para executar um aplicativo Java 17 com o Java 21.	`openjdk21`

Quando a ferramenta avalia a preparação da nuvem e os serviços relacionados do Azure, ela também pode relatar informações úteis para o uso potencial de diferentes serviços do Azure. A lista a seguir mostra alguns dos serviços abordados:

Bancos de dados do Azure
Barramento de Serviço do Azure
Armazenamento do Azure
Rede de Distribuição de Conteúdo do Azure
Hubs de eventos do Azure
Cofre de Chave do Azure
Porta da frente do Azure

Fazer o download e instalar

Para usar a CLI appcat, você deve baixar o pacote específico para seu ambiente e ter as dependências necessárias em seu ambiente. A CLI appcat é executada em qualquer ambiente como Windows, Linux ou Mac, com hardware Intel, Arm ou Apple Silicon. Para o requisito de JDK, recomendamos que você use o Microsoft Build do OpenJDK.

SO	Arquitetura	Link de download	Outros arquivos
x64
Windows	x64	Baixar	sha256 / Sig
macOS	x64	Baixar	sha256 / Sig
Linux	x64	Baixar	sha256 / Sig
AArch64
Windows	AArch64/ARM64	Baixar	sha256 / Sig
macOS	Silício da Apple	Baixar	sha256 / Sig
Linux	AArch64/ARM64	Baixar	sha256 / Sig

Pré-requisitos

Baixe e instale o Microsoft Build do OpenJDK 17. Verifique se a variável de JAVA_HOME ambiente está definida.

Instalar o AppCAT

Para instalar appcat, baixe o arquivo zip adequado para sua plataforma. Depois de baixar o arquivo, dependendo do sistema operacional, você deverá encontrar um arquivo .tar.gz (Linux/macOS) ou .zip (Windows).

Extraia o binário do arquivo baixado. Você deverá ver a seguinte estrutura de pastas:

/azure-migrate-appcat-for-java-cli-<OS>-<architecture>-<release-version>-preview/
├── appcat.exe (Windows) / appcat (Linux/macOS)
├── samples/
├── fernflower.jar
├── LICENSE
├── NOTICE.txt
├── maven.default.index
├── jdtls/
├── static-report/
├── rulesets/
├── readme.md
└── readme.html

Executar AppCAT

Para executar appcat de qualquer local no terminal, extraia o arquivo para o local desejado. Em seguida, atualize a PATH variável de ambiente para incluir o diretório onde você extraiu o arquivo compactado.

Observação

Quando o appcat binário é chamado, ele procura primeiro suas dependências na pasta executável especificada na variável de PATH ambiente. Se as dependências não forem encontradas, ela retornará ao diretório base do usuário – ~/.appcat no Linux/Mac ou %USERPROFILE%\.appcat no Windows.

Uso

Subcomandos

AppCAT fornece dois subcomandos para uso:

analyze: executa a análise de código-fonte no código-fonte de entrada ou em um binário.
transform: converte regras XML de versões anteriores (6 ou mais) para o formato YAML usado por essa versão.

Observação

Para usuários do macOS: se você encontrar um erro informando Apple could not verify ao tentar executar o aplicativo, poderá resolver esse erro usando o seguinte comando:

xattr -d -r com.apple.quarantine /path/to/appcat_binary

Por exemplo:

xattr -d -r com.apple.quarantine $HOME/.appcat/appcat

Subcomando Analyze

O analyze subcomando permite executar o código-fonte e a análise binária.

Para analisar o código-fonte do aplicativo, use o seguinte comando:

Linux/macOS
Windows

./appcat analyze --input=<path-to-source-code> --output=<path-to-output-directory> --target=azure-appservice,cloud-readiness --overwrite

.\appcat.exe analyze --input=<path-to-source-code> --output=<path-to-output-directory> --target=azure-appservice,cloud-readiness --overwrite

O sinalizador --input deve apontar para um arquivo binário ou um diretório de código-fonte e --output deve apontar para um diretório para armazenar os resultados da análise.

Para obter mais informações sobre os sinalizadores de análise, use o seguinte comando:

Linux/macOS
Windows

./appcat analyze --help

.\appcat.exe analyze --help

Para verificar os destinos disponíveis para AppCAT, use o seguinte comando:

Linux/macOS
Windows

./appcat analyze --list-targets

.\appcat.exe analyze --list-targets

Esse comando gera a seguinte saída:

available target technologies:
azure-aks
azure-appservice
azure-container-apps
cloud-readiness
linux
openjdk11
openjdk17
openjdk21

Analisando vários aplicativos

O AppCAT dá suporte a várias análises de aplicativo por execução de comando. Você pode fornecer uma lista de caminhos de entrada separados por vírgulas para o --input flag analisar vários aplicativos em um único comando. O diretório de saída e o relatório estático incluem os resultados combinados de análise para todos os aplicativos.

Para analisar vários aplicativos, use o seguinte comando:

Linux/macOS
Windows

./appcat analyze --input=<path-to-source-A>,<path-to-source-B>,<path-to-source-C> --output=<path-to-output-ABC> --target=<target-name>

.\appcat.exe analyze --input=<path-to-source-A>,<path-to-source-B>,<path-to-source-C> --output=<path-to-output-ABC> --target=<target-name>

O AppCAT também permite que você use a opção --bulk para adicionar de forma incremental mais análises a um diretório de saída e a um relatório estático existentes. Ao usar a opção --bulk , você deve usá-la consistentemente em todas as execuções de comando que gravam na mesma saída.

Observação

Quando você fornece vários caminhos de entrada, --bulk é habilitado por padrão.

Para adicionar de forma incremental mais análise de aplicativo a um relatório estático existente, use o seguinte comando:

Linux/macOS
Windows

./appcat analyze --input=<path-to-source-A>,<path-to-source-B>,<path-to-source-C> --output=<path-to-output-ABC> --target=<target-name>
./appcat analyze --bulk --input=<path-to-source-D> --output=<path-to-output-ABC> --target=<target-name>
./appcat analyze --bulk --input=<path-to-source-E> --output=<path-to-output-ABC> --target=<target-name>

.\appcat.exe analyze --input=<path-to-source-A>,<path-to-source-B>,<path-to-source-C> --output=<path-to-output-ABC> --target=<target-name>
.\appcat.exe analyze --bulk --input=<path-to-source-D> --output=<path-to-output-ABC>
.\appcat.exe analyze --bulk --input=<path-to-source-E> --output=<path-to-output-ABC>

Subcomando de transformação

O transform subcomando permite converter as regras XML anteriores appcat usadas na versão 6.x no novo formato YAML usado por esta versão 7.x.

Para transformar regras, use o seguinte comando:

Linux/macOS
Windows

./appcat transform rules --input=<path-to-xml-rules> --output=<path-to-output-directory>

.\appcat.exe transform rules --input=<path-to-xml-rules> --output=<path-to-output-directory>

O sinalizador --input deve apontar para um arquivo ou diretório que contém regras XML e o sinalizador --output deve apontar para o diretório de saída para as regras YAML convertidas.

Amostras

Observação

Verifique se as permissões de arquivo para scripts na pasta extraída estão definidas para permitir a execução.

No diretório de exemplos, você pode encontrar os seguintes scripts para executar diferentes tipos de análise:

run-assessment: fornece um relatório com avaliação de código e etapas para migrar o Airsonic para o Serviço de Aplicativo do Azure no Tomcat.
run-assessment-transform-rules: converte regras XML do Windup em regras YAML compatíveis com analyzer-lsp.
run-assessment-custom-rules: fornece um relatório de avaliação de código usando regras personalizadas (transforma XML em YAML).
run-assessment-openjdk21: gera um relatório com avaliação de código e etapas para migrar o Airsonic para o OpenJDK 21.
run-assessment-package-only: produz um relatório avaliando pacotes específicos.

Esses scripts devem ser usados com o projeto de exemplo Airsonic-Advanced - um streamer de mídia baseado na Web baseado na comunidade que permite acessar e compartilhar sua coleção de músicas.

Você pode clonar o repositório de aplicativos manualmente usando o seguinte comando:

git clone https://github.com/airsonic-advanced/airsonic-advanced.git

Após a clonagem, forneça o caminho para a pasta clonada ao executar os scripts de avaliação. Dependendo do sistema operacional, execute o script apropriado, conforme mostrado no exemplo a seguir:

Observação

Verifique se você clonou o projeto Airsonic Advanced em um caminho local antes de executar os scripts.

Linux/macOS
Windows

./samples/run-assessment <path-to-airsonic-advanced>

.\samples\run-assessment.bat <path-to-airsonic-advanced>

Esses relatórios são gerados e iniciados automaticamente. Você pode encontrar os relatórios em ../samples/report-* (Linux/macOS) ou ..\samples\report-* (Windows).

Resumo da análise

A página inicial do relatório apresenta uma visão resumida de todos os aplicativos analisados. A partir daqui, você pode navegar até relatórios de aplicativos individuais para explorar descobertas detalhadas.

O botão Perguntar Copilot no canto superior direito redireciona você para a extensão Modernização do Aplicativo Copilot do GitHub para Java no Visual Studio Code. Essa extensão fornece a avaliação do aplicativo e a correção de código como seus principais recursos para migrar aplicativos Java para o Azure , alimentados pelos recursos de IA do AppCAT e do GitHub Copilot.

Relatório de avaliação

O relatório de avaliação fornece uma lista de problemas categorizada de vários aspectos da preparação do Azure, da nuvem nativa e da modernização do Java que você precisa abordar para migrar com êxito o aplicativo para o Azure.

Cada problema é categorizado por gravidade - obrigatório, opcional ou potencial - e inclui o número de linhas de código afetadas.

As Dependências e Tecnologias exibem as bibliotecas e tecnologias usadas neste aplicativo.

Informações detalhadas sobre um problema específico

Para cada problema, você pode obter mais informações (os detalhes do problema, o conteúdo da regra e assim por diante) apenas selecionando-o. Você também obtém a lista de todos os arquivos afetados por esse problema.

Em seguida, para cada arquivo ou classe afetada pelo problema, você pode entrar no código-fonte para realçar a linha de código que criou o problema.