Compartir vía

Solución de problemas comunes de compilación en Azure Spring Apps

  • Artículo

Nota:

Los planes Básico, Estándar y Enterprise quedarán en desuso a partir de mediados de marzo de 2025, con un período de jubilación de 3 años. Se recomienda realizar la transición a Azure Container Apps. Para obtener más información, consulte el anuncio de retirada de Azure Spring Apps.

El plan de consumo estándar y dedicado quedará obsoleto a partir del 30 de septiembre de 2024, con un cierre completo al cabo de seis meses. Se recomienda realizar la transición a Azure Container Apps. Para más información, consulte Migrar el consumo estándar y el plan dedicado de Azure Spring Apps a Azure Container Apps.

Este artículo se aplica a:❌ Básico o Estándar ✔️ Enterprise

En este artículo se describe cómo solucionar problemas de compilación con la implementación de Azure Spring Apps.

Códigos de salida de compilación

El plan Enterprise de Azure Spring Apps usa Tanzu Buildpacks para transformar el código fuente de la aplicación en imágenes. Para más información, consulte Módulos de compilación de Tanzu.

Al implementar la aplicación en Azure Spring Apps mediante la CLI de Azure, verá un registro de compilación en la consola de la CLI de Azure. Si se produce un error en la compilación, Azure Spring Apps muestra un código de salida y un mensaje de error en la consola de la CLI que indica por qué se produjo un error en la ejecución del módulo de compilación durante distintas fases del ciclo de vida del módulo de compilación.

La lista siguiente describe algunos códigos de salida comunes:

  • 20: No se han detectado todos los grupos de módulos de compilación.

    Tenga en cuenta las siguientes causas posibles de un código de salida de 20:

    • El generador que está usando no admite el lenguaje que usó el proyecto.

      Si usa el generador predeterminado, compruebe el idioma que admite el generador predeterminado. Para obtener más información, consulte la sección Tipos de APM admitidos de Cómo configurar la integración de APM y los certificados CA.

      Si usa el generador personalizado, compruebe si el módulo de compilación del generador personalizado admite el lenguaje que usó el proyecto.

    • Está realizando la ejecución con la ruta equivocada; por ejemplo, el archivo pom.xml del proyecto de Maven no está en la ruta de acceso raíz.

      Establezca BP_MAVEN_POM_FILE para especificar la ubicación del archivo pom.xml del proyecto.

    • Hay algún problema con la aplicación; por ejemplo, el archivo .jar no tiene un archivo /META-INF/MANIFEST.MF que contiene una entrada Main-Class.

  • 51 : Error de compilación del módulo de compilación.

    Tenga en cuenta las siguientes causas posibles de un código de salida de 51:

    • Si Azure Spring Apps muestra el mensaje de error Build failed in stage build with reason OOMKilled en la consola de la CLI de Azure, se produjo un error en la compilación debido a una memoria insuficiente.

      Use el siguiente comando para aumentar la memoria mediante la variable de entorno build-memory:

      az spring app deploy \
    --resource-group <your-resource-group-name> \
    --service <your-Azure-Spring-Apps-name> \
    --name <your-app-name> \
    --build-memory 3Gi

    • Error en la compilación debido a un error de código fuente de la aplicación; por ejemplo, hay un error de compilación en el código fuente.

      Compruebe el registro de compilación para encontrar la causa principal.

    • Error en la compilación debido a un error de dependencia de descarga; por ejemplo, un problema de red hizo que se produjese un error en la descarga de dependencias de Maven.

    • Error en la compilación debido a una versión de JDK no admitida. Por ejemplo, el archivo JAR se ha compilado mediante versiones LTS de Java que no son compatibles con el paquete de compilación. Para obtener información sobre las versiones compatibles, consulte la sección Implementación de Aplicaciones Java de Cómo implementar aplicaciones políglotas en el plan Enterprise de Azure Spring Apps.

  • 62: No se pudo escribir la imagen en Azure Container Registry.

    Tenga en cuenta las siguientes causas posibles de un código de salida de 62:

    • Si Azure Spring Apps muestra el mensaje de error Failed to write image to the following tags en el registro de compilación, se produjo un error en la compilación debido a un problema de red.

      Vuelva a intentarlo corregir el problema.

Si la aplicación es un archivo estático o una aplicación de front-end dinámica atendida por un servidor web, consulte la sección sobre los errores comunes de compilación e implementación de Implementación del artículo sobre la implementación de archivos estáticos web.

Pasos siguientes