Evaluación de código y aplicación de Azure Migrate para Java versión 7 (versión preliminar)

Nota:

Este artículo es para la próxima generación de la herramienta de evaluación de aplicaciones y código de Azure Migrate para Java, versión 7.x. Se encuentra en versión preliminar. Para obtener la versión estable anterior, versión 6.x, consulte Evaluación de código y aplicación de Azure Migrate para Java.

En este artículo se muestra cómo usar la herramienta de evaluación de aplicaciones y códigos de Azure Migrate para Java a fin de evaluar y expandir cualquier tipo de aplicación Java. La herramienta le permite evaluar la preparación de la aplicación para la migración y la replanificación a Azure. Esta herramienta se ofrece como una interfaz de línea de comandos (CLI) y evalúa los archivos binarios de la aplicación Java y el código fuente a fin de identificar las oportunidades de migración y expansión para Azure. Le ayuda a modernizar y replanificar aplicaciones Java a gran escala mediante la identificación de casos de uso comunes y patrones de código y la propuesta de cambios recomendados.

La herramienta detecta el uso de la tecnología de la aplicación mediante el análisis estático de código, proporciona estimación de esfuerzo y acelera la expansión del código. Esta evaluación le ayuda a priorizar y mover aplicaciones Java a Azure. Con un conjunto de motores y reglas, la herramienta puede detectar y evaluar diferentes tecnologías como Java 11, Java 17, Jakarta EE, Spring, Hibernate, Java Message Service (JMS) y más. Después, la herramienta le ayuda a expandir la aplicación Java a diferentes destinos de Azure (Azure App Service, Azure Kubernetes Service y Azure Container Apps) con reglas específicas de expansión de Azure.

La herramienta se basa en un conjunto de componentes del proyecto Cloud Native Computing Foundation Konveyor, creado y dirigido por Red Hat.

Información general

La herramienta está diseñada para ayudar a las organizaciones a modernizar sus aplicaciones Java de forma que reduzca los costos y permita una innovación más rápida. La herramienta usa técnicas de análisis avanzadas para comprender la estructura y las dependencias de cualquier aplicación de Java y proporciona instrucciones sobre cómo refactorizar y migrar las aplicaciones a Azure.

Con ella, podrá realizar las siguientes tareas:

Detectar el uso de la tecnología: vea rápidamente qué tecnologías usa una aplicación. La detección es útil si tiene aplicaciones heredadas con poca documentación y quiere saber qué tecnologías usan.
Evaluar el código para un destino específico: evalúe una aplicación para un destino específico de Azure. Compruebe el esfuerzo y las modificaciones que debe realizar para cambiar la plataforma de sus aplicaciones a Azure.

Destinos admitidos

La herramienta contiene reglas que le ayudarán a cambiar la plataforma de sus aplicaciones para que pueda implementarlas y usar diferentes servicios de Azure.

Las reglas usadas por la aplicación y la evaluación de código de Azure Migrate se agrupan en función de un destino. Un destino es dónde o cómo se ejecuta la aplicación, y las necesidades y expectativas generales. Al evaluar una aplicación, puede elegir varios destinos. En la tabla siguiente se describen los destinos disponibles:

Nombre de destino	Descripción	Destino
Azure App Service	Procedimientos recomendados para implementar una aplicación en Azure App Service.	`azure-appservice`
Azure Kubernetes Service	Procedimientos recomendados para implementar una aplicación en Azure Kubernetes Service.	`azure-aks`
Azure Container Apps (Aplicaciones de Contenedores de Azure)	Procedimientos recomendados para implementar una aplicación en Azure Container Apps.	`azure-container-apps`
Preparación para la nube	Procedimientos recomendados generales para preparar una aplicación en la nube (Azure).	`cloud-readiness`
Linux	Procedimientos recomendados generales para preparar una aplicación para Linux.	`linux`
OpenJDK 11	Procedimientos recomendados generales para ejecutar una aplicación de Java 8 con Java 11.	`openjdk11`
OpenJDK 17	Procedimientos recomendados generales para ejecutar una aplicación de Java 11 con Java 17.	`openjdk17`
OpenJDK 21	Procedimientos recomendados generales para ejecutar una aplicación de Java 17 con Java 21.	`openjdk21`

Cuando la herramienta evalúa la preparación para la nube y los servicios de Azure relacionados, también puede notificar información útil para el posible uso de diferentes servicios de Azure. En la lista siguiente se muestran algunos de los servicios cubiertos:

Bases de datos de Azure
Azure Service Bus (bus de servicios de Azure)
Azure Storage
Azure Content Delivery Network
Azure Event Hubs
Azure Key Vault
Azure Front Door (portal de entrada de Azure)

Descargar e instalar

Para usar la CLI de appcat, debe descargar el paquete específico del entorno y tener las dependencias necesarias en el entorno. La CLI de appcat se ejecuta en cualquier entorno, como Windows, Linux o Mac, tanto para hardware Intel, Arm o Apple Silicon. Para el requisito de JDK, se recomienda usar Microsoft Build de OpenJDK.

SO	Arquitectura	Vínculo de descarga	Otros archivos
x64
Windows	x64	Descargar	sha256 / sig
macOS	x64	Descargar	sha256 / sig
Linux	x64	Descargar	sha256 / sig
AArch64
Windows	AArch64/ARM64	Descargar	sha256 / sig
macOS	Apple Silicon	Descargar	sha256 / sig
Linux	AArch64/ARM64	Descargar	sha256 / sig

Requisitos previos

Descargue e instale Microsoft Build de OpenJDK 17. Asegúrese de que la variable de JAVA_HOME entorno esté establecida.

Instalación de AppCAT

Para instalar appcat, descargue el archivo ZIP adecuado para la plataforma. Después de descargar el archivo, en función del sistema operativo, debería encontrar un archivo .tar.gz (Linux/macOS) o .zip (Windows).

Extraiga el binario del archivo descargado. Debería ver la siguiente estructura de carpetas:

/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

Ejecución de AppCAT

Para ejecutar appcat desde cualquier ubicación del terminal, extraiga el archivo en la ubicación deseada. A continuación, actualice la PATH variable de entorno para incluir el directorio donde extrajo el archivo.

Nota:

Cuando se llama al appcat archivo binario, primero busca sus dependencias en la carpeta ejecutable especificada en la PATH variable de entorno. Si no se encuentran las dependencias, vuelve al directorio principal del usuario: ~/.appcat en Linux/Mac o %USERPROFILE%\.appcat en Windows.

Uso

Subcomandos

AppCAT proporciona dos subcomandos para su uso:

analyze: ejecute el análisis de código fuente en el código fuente de entrada o en un binario.
transform: convierta reglas XML de versiones anteriores (6 y anteriores) al formato YAML usado por esta versión.

Nota:

Para los usuarios de macOS: si se produce un error que indica Apple could not verify al intentar ejecutar la aplicación, puede resolver este error mediante el comando siguiente:

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

Por ejemplo:

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

Subcomando Analyze

El analyze subcomando permite ejecutar código fuente y análisis binario.

Para analizar el código fuente de la aplicación, use el siguiente 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

La marca --input debe apuntar a un directorio de código fuente o a un archivo binario, y --output debe apuntar a un directorio para almacenar los resultados del análisis.

Para obtener más información sobre las marcas de análisis, use el siguiente comando:

Linux/macOS
Windows

./appcat analyze --help

.\appcat.exe analyze --help

Para comprobar los destinos disponibles para AppCAT, use el siguiente comando:

Linux/macOS
Windows

./appcat analyze --list-targets

.\appcat.exe analyze --list-targets

Este comando genera el siguiente resultado:

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

Análisis de varias aplicaciones

AppCAT admite varios análisis de aplicaciones en cada ejecución de comandos. Puede proporcionar una lista separada por comas de rutas de acceso de entrada para que la --input marca analice varias aplicaciones en un solo comando. El directorio de salida y el informe estático incluyen los resultados de análisis combinados para todas las aplicaciones.

Para analizar varias aplicaciones, use el siguiente 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>

AppCAT también permite usar --bulk la opción para agregar de forma incremental más análisis de aplicaciones a un directorio de salida y un informe estático existentes. Al usar la opción --bulk, debe utilizarla de forma coherente en todas las ejecuciones de los comandos que generan la misma salida.

Nota:

Cuando se proporcionan varias rutas de acceso de entrada, --bulk está habilitada de forma predeterminada.

Para agregar incrementalmente más análisis de aplicaciones a un informe estático existente, use el siguiente 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>

Transformación del subcomando

El transform subcomando permite convertir las reglas XML anteriores appcat usadas en la versión 6.x en el nuevo formato YAML usado por esta versión 7.x.

Para transformar reglas, use el siguiente 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>

La marca --input debe apuntar a un archivo o directorio que contenga reglas XML y la marca --output debe apuntar al directorio de salida para las reglas YAML convertidas.

Ejemplos

Nota:

Asegúrese de que los permisos de archivo de los scripts de la carpeta extraída estén establecidos para permitir la ejecución.

En el directorio de ejemplos , puede encontrar los siguientes scripts para ejecutar diferentes tipos de análisis:

run-assessment: proporciona un informe con la evaluación de código y los pasos para migrar Airsonic a Azure App Service en Tomcat.
run-assessment-transform-rules: convierte las reglas XML de Windup en reglas YAML compatibles con analyzer-lsp.
run-assessment-custom-rules: proporciona un informe de evaluación de código mediante reglas personalizadas (transformar XML en YAML).
run-assessment-openjdk21: genera un informe con evaluación de código y pasos para migrar Airsonic a OpenJDK 21.
run-assessment-package-only: genera un informe mediante la evaluación de paquetes específicos.

Estos scripts están diseñados para usarse con el proyecto de ejemplo Airsonic-Advanced : un streamer multimedia basado en la comunidad basado en web que le permite acceder a la colección de música y compartirla.

Puede clonar el repositorio de aplicaciones manualmente mediante el siguiente comando:

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

Después de la clonación, proporcione la ruta de acceso a la carpeta clonada al ejecutar los scripts de evaluación. En función del sistema operativo, ejecute el script adecuado, como se muestra en el ejemplo siguiente:

Nota:

Asegúrese de que ha clonado el proyecto Airsonic Advanced en una ruta de acceso local antes de ejecutar los scripts.

Linux/macOS
Windows

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

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

Los informes se generan e inician de manera automática. Puede encontrar los informes en .. /samples/report-* (Linux/macOS) o .. \samples\report-* (Windows).

Resumen del análisis

La página de aterrizaje del informe presenta una vista de resumen de todas las aplicaciones analizadas. Desde aquí, puede ir a informes de aplicaciones individuales para explorar conclusiones detalladas.

El botón Ask Copilot (Preguntar copilot ) de la esquina superior derecha le redirige a la extensión GitHub Copilot App Modernization for Java en Visual Studio Code. Esta extensión proporciona tanto la evaluación de aplicaciones como la corrección de código como sus funcionalidades clave para migrar aplicaciones Java a Azure, con tecnología de AppCAT y las funcionalidades de IA de GitHub Copilot.

Informe de evaluación

El informe de evaluación proporciona una lista de problemas clasificados de diversos aspectos de la preparación de Azure, la preparación de la nube y la modernización de Java que debe abordar para migrar correctamente la aplicación a Azure.

Cada problema se clasifica por gravedad ( obligatorio, opcional o potencial ) e incluye el número de líneas de código afectadas.

Las pestañas Dependencias y Tecnologías muestran las bibliotecas y tecnologías que se usan en la aplicación.

Información detallada de un problema específico

Para cada problema, puede obtener más información (el detalle del problema, el contenido de la regla, etc.) simplemente seleccionándolo. También obtendrá la lista de todos los archivos afectados por este problema.

A continuación, para cada archivo o clase afectado por el problema, puede saltar al código fuente para resaltar la línea de código que creó el problema.