Evalúa las aplicaciones de Java para su modernización

En esta página, se muestra cómo usar Google Cloud Modernization Hub en la consola deGoogle Cloud para evaluar las aplicaciones empresariales de Java para la creación de contenedores y la modernización de Linux en versiones de asistencia a largo plazo (LTS) de Java multiplataforma (como Java 17 o Java 21) en Google Cloud.

Muchas aplicaciones empresariales de Java dependen de las APIs de Java EE heredadas, de las configuraciones propietarias del servidor de aplicaciones (como WebLogic, WebSphere o JBoss) o de bibliotecas de terceros obsoletas que impiden la implementación directa en contenedores de Linux. Una evaluación automatizada en Modernization Hub analiza tu código fuente, identifica los bloqueadores de la migración, evalúa la compatibilidad de las dependencias de Maven o Gradle y recomienda rutas de refactorización para Cloud Run o Google Kubernetes Engine.

Para ejecutar evaluaciones desde tu computadora local o personalizar las secciones de informes con la CLI de codmod independiente, consulta Crea una evaluación de modernización de apps.

Cuándo usar una evaluación de aplicaciones de Java

Ejecuta una evaluación de la aplicación de Java cuando planees realizar alguna de las siguientes acciones:

  • Cambio de plataforma a contenedores de Linux: Identifica las dependencias específicas del entorno (como el acceso al sistema de archivos local, las bibliotecas de JNI o las APIs de servidores de aplicaciones de propiedad) antes de alojar en contenedores las aplicaciones para Cloud Run o GKE.
  • Actualiza las versiones del entorno de ejecución de Java: Evalúa el esfuerzo y las brechas de compatibilidad cuando migres de Java 8 o Java 11 a versiones modernas de Java LTS (Java 17 o Java 21), o cuando realices la transición de Java EE (javax.*) a Jakarta EE (jakarta.*).
  • Desvincula arquitecturas monolíticas: Descubre componentes de EJB con acoplamiento alto, agentes de mensajes de JMS o implementaciones de WAR y EAR monolíticas que requieren refactorización en microservicios nativos de la nube o aplicaciones de Spring Boot.

Antes de comenzar

Antes de iniciar un trabajo de evaluación de Java en la consola, habilita las APIs necesarias, verifica los permisos de Identity and Access Management (IAM) de tu proyecto, registra un bucket de configuración del espacio de trabajo y sube el archivo de código fuente a Cloud Storage.

Habilita las APIs obligatorias

Para usar Modernization Hub, habilita las APIs de servicio de Google Cloud necesarias en tu proyecto:

gcloud services enable \
    aiplatform.googleapis.com \
    artifactregistry.googleapis.com \
    cloudbuild.googleapis.com \
    cloudresourcemanager.googleapis.com \
    compute.googleapis.com \
    logging.googleapis.com \
    storage.googleapis.com \
    --project=PROJECT_ID

Reemplaza PROJECT_ID por el ID del proyecto de Google Cloud .

Roles obligatorios

Para ejecutar una evaluación, se requieren permisos de IAM distintos para dos identidades que usan Cloud Build y Gemini Enterprise Agent Platform:

  • Usuario de la consola autenticado (que inicia el trabajo y accede a los buckets):
    • Administrador de almacenamiento (roles/storage.admin)
    • Usuario de la cuenta de servicio (roles/iam.serviceAccountUser)
    • Editor de Cloud Build (roles/cloudbuild.builds.editor)
  • Cuenta de servicio dedicada (que ejecuta el contenedor de evaluación):
    • Usuario de Agent Platform (roles/aiplatform.user)
    • Usuario de objetos de almacenamiento (roles/storage.objectUser) o Administrador de almacenamiento (roles/storage.admin)

Para obtener los permisos que necesitas para iniciar una evaluación y ejecutar el contenedor de análisis, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

  • Usuario: Administra los archivos de origen y las configuraciones de bucket: Administrador de almacenamiento (roles/storage.admin)
  • Usuario: Adjunta la cuenta de servicio dedicada al trabajo: Usuario de la cuenta de servicio (roles/iam.serviceAccountUser)
  • Usuario: Envía trabajos de evaluación (cloudbuild.builds.create) y consulta los registros: Editor de Cloud Build (roles/cloudbuild.builds.editor)
  • Cuenta de servicio: Ejecuta el contenedor codmod: Usuario de Agent Platform (roles/aiplatform.user)
  • Cuenta de servicio: Lee archivos de origen y escribe informes de evaluación: Usuario de objetos de almacenamiento (roles/storage.objectUser) o Administrador de almacenamiento (roles/storage.admin)

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para iniciar una evaluación y ejecutar el contenedor de análisis. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para iniciar una evaluación y ejecutar el contenedor de análisis:

  • Usuario (Cloud Storage, Cloud Build y IAM):
    • storage.objects.get (para descargar o leer archivos)
    • storage.objects.list (para enumerar los archivos dentro del bucket)
    • storage.objects.create (para subir o crear archivos nuevos)
    • storage.objects.update (para modificar los metadatos de los archivos existentes)
    • storage.objects.delete (para borrar o reemplazar archivos)
    • storage.buckets.get (Ver la configuración a nivel del bucket)
    • cloudbuild.builds.create (para enviar trabajos de evaluación)
    • iam.serviceAccounts.actAs (para adjuntar la cuenta de servicio al trabajo)
  • Cuenta de servicio (Agent Platform y Cloud Storage):
    • aiplatform.endpoints.predict (para ejecutar el análisis de código asistido por IA)
    • storage.objects.get (para leer o descargar archivos de origen)
    • storage.objects.list (para enumerar los archivos de la carpeta de entrada)
    • storage.objects.create (para escribir informes de evaluación)
    • storage.objects.delete (para borrar archivos temporales)

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Configura un bucket de configuración del espacio de trabajo

Registra un bucket de Cloud Storage designado en la página Modernization Hub > Configuración (por ejemplo, gs://PROJECT_ID-modernization-hub) para almacenar los archivos de estado binario del espacio de trabajo (dotnet_jobs.pb, java_jobs.pb y mainframe_jobs.pb).

Revisa los límites de tamaño de la base de código

Para mantener un rendimiento óptimo, el motor de evaluación de codmod aplica los siguientes lineamientos de escalamiento y archivado:

  • Tamaño máximo de la base de código: aproximadamente seis millones de líneas de código (LOC) por trabajo de evaluación. Si tu repositorio supera los seis millones de LOC, divide la base de código en módulos o servicios más pequeños e independientes antes de subirla.
  • Estructura de archivo limpia: Excluye los objetos binarios compilados, las cachés de paquetes y los metadatos de control de versión (como target/, build/, bin/, node_modules/ y .git/) de tu archivo ZIP para que solo se analicen los archivos de origen y las opciones de configuración de compilación.

Prepara y sube tu archivo de código fuente de Java

Empaqueta tu base de código de Java como un archivo ZIP que excluya los resultados de la compilación y súbelo a un bucket de Cloud Storage en tu proyecto.

  1. En tu máquina local, crea un archivo ZIP de tu repositorio con uno de los siguientes métodos:

    • Con Git (recomendado):

      git archive --format=zip -o repository.zip HEAD
      
    • Con la CLI de zip:

      zip -r repository.zip . \
          -x "*.git*" "*/target/*" "*/build/*" "*/bin/*" "*/node_modules/*"
      
  2. Sube el archivo ZIP al bucket de Cloud Storage de destino con Google Cloud CLI:

    gcloud storage cp repository.zip \
        gs://INPUT_BUCKET/codebase/repository.zip
    

    Reemplaza INPUT_BUCKET por el nombre de tu bucket de Cloud Storage de destino.

Ejecuta una evaluación

Para iniciar un trabajo de evaluación en Modernization Hub, sigue estos pasos:

  1. En la consola, ve a la página Modernization Hub.

    Ir al Centro de modernización

  2. En la página de destino, busca la tarjeta Cargas de trabajo de Java y haz clic en Iniciar evaluación.

  3. En el campo Nombre del trabajo, ingresa un nombre único para tu trabajo de evaluación.

  4. En el campo Ubicación del código fuente, selecciona un bucket de Cloud Storage que contenga tu código fuente como archivo ZIP.

  5. En el campo Ubicación del informe, selecciona un bucket de Cloud Storage para guardar los informes de evaluación generados.

  6. En la lista Receta de modernización, selecciona una receta de modernización.

  7. En la lista Ubicación, selecciona una región para el trabajo de evaluación.

  8. En el campo Cuenta de servicio, selecciona una cuenta de servicio dedicada con los roles de IAM necesarios que se indican en la sección Roles necesarios. Cloud Build ejecuta el trabajo de evaluación con esta cuenta de servicio, que requiere permisos de usuario de Agent Platform y de Cloud Storage.

  9. Haz clic en Generar informe.

    La consola inicia un contenedor de evaluación en segundo plano que ejecuta el motor de codmod para analizar tu proyecto. El estado del trabajo aparece en la tabla Historial de evaluaciones.

Revisa el informe de evaluación

Según el tamaño de tu base de código, los trabajos de evaluación suelen completarse en unos minutos. El contenedor en segundo plano finaliza automáticamente después de que termina de procesarse.

Para acceder a los resultados de tu evaluación, sigue estos pasos:

  1. En la tabla Historial de evaluaciones de la página de Modernization Hub, busca tu trabajo de evaluación.
  2. Cuando la columna Estado cambie a Completado, haz clic en Descargar informe.
  3. Selecciona el formato de salida que prefieras:
    • Informe HTML: Es un resumen interactivo que te permite filtrar las APIs incompatibles, inspeccionar las listas de bloqueadores archivo por archivo y ver sugerencias de solución.
    • Informe de Markdown: Es un resumen ejecutivo con formato adecuado para compartirlo con las partes interesadas y las juntas de revisión de arquitectura.

Revisa el informe de evaluación

En el informe de evaluación generado, se clasifica la preparación para la migración de tu aplicación en varias áreas clave:

  • Puntuación de compatibilidad general: Es el porcentaje de líneas de origen y dependencias que se pueden migrar al entorno de ejecución de Java de destino sin modificaciones.
  • Desglose de bloqueadores: Dependencias de Java heredadas específicas o restricciones de entorno que requieren refactorización, como las siguientes:
    • Cambios en el espacio de nombres de Java EE (javax.*) a Jakarta EE (jakarta.*).
    • APIs internas del JDK quitadas o dadas de baja (como los paquetes sun.misc.* o los módulos CORBA)
    • Configuraciones o APIs de servidores de aplicaciones de propiedad (como los descriptores de implementación de WebLogic, WebSphere o JBoss)
  • Análisis de dependencias: Es un inventario detallado de las dependencias existentes de Maven o Gradle que indica si cada biblioteca admite la versión de entorno de ejecución de Java de destino o requiere una actualización.
  • Acciones recomendadas: Son transformaciones de código sugeridas, recetas de refactorización asistidas por IA y rutas de migración generadas por codmod para preparar tu aplicación para la creación de contenedores en Google Cloud.

¿Qué sigue?