Azure Migrate aplicativo e avaliação de código para Java versão 7 (visualização)

Nota

Este artigo destina-se à próxima geração de aplicação Azure Migrate e avaliação de código para Java, versão 7.x. Esta versão está em prévia. Para a versão estável anterior, versão 6.x, consulte Azure Migrate application and code assessment for Java.

Este artigo mostra como usar o aplicativo Azure Migrate e a ferramenta de avaliação de código para Java para avaliar e reformular qualquer tipo de aplicativo Java. A ferramenta permite avaliar a preparação do aplicativo para replataforma e migração para o Azure. Essa ferramenta é oferecida como uma interface de linha de comando (CLI) e avalia binários de aplicativos Java e código-fonte para identificar oportunidades de replataforma e migração para o Azure. Ele ajuda a modernizar e reformular aplicativos Java de grande escala, identificando casos de uso comuns e padrões de código e propondo alterações recomendadas.

A ferramenta descobre o uso da tecnologia de aplicações por meio da análise estática de código, fornece estimativa de esforço e acelera a replataformaçã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, Java Message Service (JMS) e muito mais. Em seguida, a ferramenta ajuda você a reformular o aplicativo Java para diferentes destinos do Azure - Serviço de Aplicativo do Azure, Serviço Kubernetes do Azure e Aplicativos de Contêiner do Azure - com regras específicas de replataforma do Azure.

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

Descrição geral

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

Com ele, 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.
Avaliar 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 para o Azure.

Alvos suportados

A ferramenta contém regras para ajudá-lo a reformular seus aplicativos para que você possa implantar e usar diferentes serviços do Azure.

As regras usadas pelo aplicativo Azure Migrate e pela avaliação de código são agrupadas com base em um destino. Um destino é onde ou como a aplicação é executada, bem como as suas necessidades e expectativas gerais. Ao avaliar um aplicativo, você pode escolher vários destinos. A tabela a seguir descreve os destinos disponíveis:

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

Quando a ferramenta avalia a Preparação para a Nuvem e os serviços relacionados do Azure, também pode relatar informações úteis para o uso potencial de diferentes serviços do Azure. A lista seguinte mostra alguns dos serviços abrangidos:

Bases de Dados do Azure
Azure Service Bus (uma solução de mensageria na nuvem da Microsoft)
Armazenamento do Azure
Rede de Entrega de Conteúdos do Azure
Hubs de Eventos do Azure
Azure Key Vault
Azure Front Door (porta de entrada do Azure)

Transferir e instalar

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

SO	Arquitetura	Link para Download	Outros ficheiros
x64
Mac OS	x64	Baixar	SHA256 / sig
macOS	x64	Baixar	SHA256 / sig
Aplicações Linux	x64	Baixar	SHA256 / sig
AArch64
Mac OS	AArch64 / ARM64	Baixar	SHA256 / sig
macOS	Silício da Apple	Baixar	SHA256 / sig
Aplicações Linux	AArch64 / ARM64	Baixar	SHA256 / sig

Pré-requisitos

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

Instalar o AppCAT

Para instalar o appcat, descarregue o ficheiro zip apropriado para a sua plataforma. Depois de baixar o arquivo, dependendo do seu sistema operacional, você deve encontrar um arquivo .tar.gz (Linux/macOS) ou .zip (Windows).

Extraia o binário do arquivo baixado. Você deve 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 a partir de qualquer local no seu 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.

Nota

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

Utilização

Subcomandos

AppCAT fornece dois subcomandos para uso:

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

Nota

Para usuários do macOS: Se você encontrar um erro informando Apple could not verify ao tentar executar o aplicativo, você pode 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

Analisar subcomando

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
Mac OS

./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 --input sinalizador deve apontar para um diretório de código-fonte ou um arquivo binário 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
Mac OS

./appcat analyze --help

.\appcat.exe analyze --help

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

Linux / macOS
Mac OS

./appcat analyze --list-targets

.\appcat.exe analyze --list-targets

Este comando produz 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 suporta análise de vários aplicativos na execução por comando. Você pode fornecer uma lista separada por vírgulas de caminhos de entrada para que o sinalizador analise --input vários aplicativos em um único comando. O diretório de saída e o relatório estático incluem os resultados da análise combinada para todos os aplicativos.

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

Linux / macOS
Mac OS

./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 --bulk a opção para adicionar incrementalmente mais análise de aplicativo a um diretório de saída existente e relatório estático. Ao usar a --bulk opção, você deve usá-la consistentemente em todas as execuções de comando que gravam na mesma saída.

Nota

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

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

Linux / macOS
Mac OS

./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 Transformar

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
Mac OS

./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 --input sinalizador deve apontar para um arquivo ou diretório contendo regras XML, e o --output sinalizador deve apontar para o diretório de saída para as regras YAML convertidas.

Exemplos

Nota

Certifique-se de que 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 de 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 (transformar 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 através da avaliação de pacotes específicos.

Estes scripts destinam-se a ser utilizados com o projeto de exemplo Airsonic-Advanced - um streamer multimédia baseado na Web orientado pela comunidade que lhe permite aceder e partilhar a sua coleção de música.

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 seu sistema operacional, execute o script apropriado, conforme mostrado no exemplo a seguir:

Nota

Certifique-se de ter clonado o projeto Airsonic Advanced para um caminho local antes de executar os scripts.

Linux / macOS
Mac OS

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

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

Os relatórios são gerados e lançados automaticamente. Pode encontrar os relatórios em .. /samples/report-* (Linux/macOS) ou .. \samples\report-* (Windows).

Resumo da análise

A página de destino 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 Ask Copilot no canto superior direito redireciona você para a extensão GitHub Copilot App Modernization for Java no Visual Studio Code. Essa extensão fornece avaliação de aplicativos e correção de código como seus principais recursos para migrar aplicativos Java para o Azure - alimentado 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 aspetos da prontidão do Azure, nativo da nuvem e modernização 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 guias Dependências e Tecnologias exibem as bibliotecas e tecnologias usadas no aplicativo.

Informações pormenorizadas sobre uma questão específica

Para cada problema, você pode obter mais informações (o detalhe 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 ir para o código-fonte para destacar a linha de código que criou o problema.