Compilación de variables de entorno para Java en Azure Container Apps (versión preliminar)

Artículo
03/10/2024

Azure Container Apps usa Buildpacks para crear automáticamente una imagen de contenedor que le permite implementar desde el código fuente directamente en la nube. Para controlar la configuración de compilación, puede usar variables de entorno para personalizar partes de la compilación como JDK, Maven y Tomcat. En el siguiente artículo se muestra cómo configurar variables de entorno para ayudarle a tomar el control de las compilaciones que crean automáticamente un contenedor.

Variables de entorno de compilación Java admitidas

Configuración de JDK

Container Apps usa Microsoft Build de OpenJDK para compilar código fuente y como entorno de runtime. Se admiten cuatro versiones JDK de LTS: 8, 11, 17 y 21.

Para la compilación de código fuente, la versión predeterminada es JDK 17.
Para una compilación de archivo JAR, la versión de JDK se lee desde la ubicación del archivo META-INF\MANIFEST.MF en el archivo JAR, pero usa la versión predeterminada JDK 17 si la versión especificada no está disponible.

Esta es una lista de las variables de entorno que se usan para configurar JDK:

Variable de entorno	Descripción	Valor predeterminado
`BP_JVM_VERSION`	Controla la versión de JVM.	`17`

Configuración de Maven

Container Apps admite la creación de aplicaciones basadas en Maven desde el origen.

Esta es una lista de las variables de entorno que se usan para configurar Maven:

Compilar variable de entorno	Descripción	Valor predeterminado
`BP_MAVEN_VERSION`	Establece la versión principal de Maven. Dado que Buildpacks solo incluye una sola versión de cada línea compatible, las actualizaciones del paquete de compilación pueden cambiar la versión exacta de Maven instalada. Si necesita una versión secundaria o de revisión específica de Maven, use el contenedor de Maven en su lugar.	`3`
`BP_MAVEN_BUILD_ARGUMENTS`	Define los argumentos pasados a Maven. `--batch-mode` se antepone a la lista de argumentos en entornos sin TTY.	`-Dmaven.test.skip=true --no-transfer-progress package`
`BP_MAVEN_ADDITIONAL_BUILD_ARGUMENTS`	Define argumentos adicionales usados (por ejemplo, `-DskipJavadoc` anexado a `BP_MAVEN_BUILD_ARGUMENTS`) para pasar a Maven.
`BP_MAVEN_ACTIVE_PROFILES`	Lista separada por comas de perfiles activos pasados a Maven.
`BP_MAVEN_BUILT_MODULE`	Designa el artefacto de aplicación que contiene el módulo. De manera predeterminada, la compilación busca en el módulo raíz.
`BP_MAVEN_BUILT_ARTIFACT`	Ubicación del artefacto de aplicación compilado. Este valor reemplaza a la variable `BP_MAVEN_BUILT_MODULE`. Puede coincidir con un único archivo, varios archivos o un directorio a través de uno o varios patrones separados por espacios.	`target/*.[ejw]ar`
`BP_MAVEN_POM_FILE`	Especifica una ubicación personalizada en el archivo pom.xml del proyecto. Este valor es relativo a la raíz del proyecto (por ejemplo, /workspace).	`pom.xml`
`BP_MAVEN_DAEMON_ENABLED`	Desencadena la instalación y configuración de `maven-mvnd` de Apache en lugar de Maven. Establezca este valor en `true` si desea el demonio de Maven.	`false`
`BP_MAVEN_SETTINGS_PATH`	Especifica una ubicación personalizada en el archivo settings.xml de Maven.
`BP_INCLUDE_FILES`	Lista separada por dos puntos de patrones globales para buscar coincidencias con los archivos de origen. Cualquier archivo coincidente se conserva en la imagen final.
`BP_EXCLUDE_FILES`	Lista separada por dos puntos de patrones globales para buscar coincidencias con los archivos de origen. Cualquier archivo coincidente se quita de la imagen final. Los patrones de inclusión se aplican primero y puede usar "excluir patrones" para reducir los archivos incluidos en la compilación.
`BP_JAVA_INSTALL_NODE`	Controle si un paquete de compilación independiente instala Yarn y Node.js. Si se establece en `true`, el paquete de compilación comprueba la raíz de la aplicación o la ruta de acceso establecida por `BP_NODE_PROJECT_PATH`. La ruta de acceso del proyecto busca un archivo yarn.lock, que requiere la instalación de Yarn y Node.js. Si hay un archivo package.json, la compilación solo requiere Node.js.	`false`
`BP_NODE_PROJECT_PATH`	Dirija el subdirectorio del proyecto para buscar archivos package.json y yarn.lock.

Configuración de Tomcat

Container Apps admite la ejecución de archivos war en el servidor de aplicaciones de Tomcat.

Esta es una lista de las variables de entorno que se usan para configurar Tomcat:

Compilar variable de entorno	Descripción	Valor predeterminado
`BP_TOMCAT_CONTEXT_PATH`	Ruta de acceso de contexto donde se monta la aplicación.	El valor predeterminado es vacío (`ROOT`)
`BP_TOMCAT_EXT_CONF_SHA256`	Hash SHA256 del paquete de configuración externo.
`BP_TOMCAT_ENV_PROPERTY_SOURCE_DISABLED`	Cuando se establece en `true`, el paquete de compilación no configura `org.apache.tomcat.util.digester.EnvironmentPropertySource`. Esta opción de configuración se agrega para admitir la carga de la configuración desde las variables de entorno y hacer referencia a ellas en los archivos de configuración de Tomcat.
`BP_TOMCAT_EXT_CONF_STRIP`	Número de niveles de directorio que se van a quitar del paquete de configuración externo.	`0`
`BP_TOMCAT_EXT_CONF_URI`	Identificador URI de descarga del paquete de configuración externo.
`BP_TOMCAT_EXT_CONF_VERSION`	Versión del paquete de configuración externo.
`BP_TOMCAT_VERSION`	Se usa para configurar una versión específica de Tomcat. Las versiones compatibles de Tomcat incluyen 8, 9 y 10.	`9.*`

Configuración del servicio de compilación en la nube

Esta es una lista de las variables de entorno que se usan para configurar un servicio de compilación en la nube:

Compilar variable de entorno	Descripción	Valor predeterminado
`ORYX_DISABLE_TELEMETRY`	Controla si se va a deshabilitar la recopilación de telemetría.	`false`

Configuración de variables de entorno de compilación de Java

Nota:

Para ejecutar los siguientes comandos de la CLI, use la versión 0.3.47 de la extensión de Container Apps o una versión posterior. Use el comando az extension add --name containerapp --upgrade --allow-preview para instalar la versión más reciente.

Puede configurar variables de entorno de compilación de Java al implementar el código fuente de la aplicación Java mediante el comando de la CLI az containerapp up, az containerapp create o az containerapp update:

az containerapp up \
  --name <CONTAINER_APP_NAME> \
  --source <SOURCE_DIRECTORY> \
  --build-env-vars <NAME=VALUE NAME=VALUE> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --environment <ENVIRONMENT_NAME>

El argumento build-env-vars es una lista de variables de entorno para los valores separados por espacios de compilación en formato key=value. Esta es una lista de ejemplo que puede pasar como variables:

BP_JVM_VERSION=21 BP_MAVEN_VERSION=4 "BP_MAVEN_BUILD_ARGUMENTS=-Dmaven.test.skip=true --no-transfer-progress package"

También puede configurar las variables de entorno de compilación de Java al configurar Acciones de GitHub con la CLI de Azure en Azure Container Apps.

az containerapp github-action add \
  --repo-url "https://github.com/<OWNER>/<REPOSITORY_NAME>" \
  --build-env-vars <NAME=VALUE NAME=VALUE> \
  --branch <BRANCH_NAME> \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --registry-url <URL_TO_CONTAINER_REGISTRY> \
  --registry-username <REGISTRY_USER_NAME> \
  --registry-password <REGISTRY_PASSWORD> \
  --service-principal-client-id <appId> \
  --service-principal-client-secret <password> \
  --service-principal-tenant-id <tenant> \
  --token <YOUR_GITHUB_PERSONAL_ACCESS_TOKEN>

Pasos siguientes

Compilación e implementación desde un repositorio

Compartir vía