在 Azure 容器应用中为 Java 生成环境变量（预览版）

项目
10/21/2024

Azure 容器应用使用 Buildpacks 自动创建容器映像，以便直接从你的源代码部署到云。若要控制你的生成配置，可以使用环境变量来自定义生成的各个部分，例如 JDK、Maven 和 Tomcat。以下文章介绍如何配置环境变量，以帮助控制自动为你创建容器的生成。

支持 Java 生成环境变量

配置 JDK

容器应用使用 Microsoft Build of OpenJDK 来生成源代码，并将其作为运行时环境。支持四个 LTS JDK 版本：8、11、17 和 21。

对于源代码生成，默认版本为 JDK 17。
对于 JAR 文件生成，JDK 版本是从 JAR 中的文件位置 META-INF\MANIFEST.MF 读取的，但如果指定的版本不可用，则使用默认的 JDK 版本 17。

下面是用于配置 JDK 的环境变量的列表：

环境变量	说明	默认
`BP_JVM_VERSION`	控制 JVM 版本。	`17`

配置 Maven

容器应用支持从源生成基于 Maven 的应用程序。

下面是用于配置 Maven 的环境变量的列表：

生成环境变量	说明	默认
`BP_MAVEN_VERSION`	设置主要的 Maven 版本。由于 Buildpack 只提供每个受支持行的单个版本，因此对 buildpack 的更新可能会更改安装的 Maven 的确切版本。如果需要 Maven 的特定次要/补丁版本，请改用 Maven 包装器。	`3`
`BP_MAVEN_BUILD_ARGUMENTS`	定义传递给 Maven 的参数。 `--batch-mode` 被预置到没有 TTY 的环境中的参数列表。	`-Dmaven.test.skip=true --no-transfer-progress package`
`BP_MAVEN_ADDITIONAL_BUILD_ARGUMENTS`	定义用于传递给 Maven 的额外参数（例如 `-DskipJavadoc` 被追加到 `BP_MAVEN_BUILD_ARGUMENTS`）。
`BP_MAVEN_ACTIVE_PROFILES`	传递给 Maven 的活动配置文件的逗号分隔列表。
`BP_MAVEN_BUILT_MODULE`	指定包含模块的应用程序工件。默认情况下，生成会在根模块中查找。
`BP_MAVEN_BUILT_ARTIFACT`	生成的应用程序工件的位置。此值取代 `BP_MAVEN_BUILT_MODULE` 变量。可以通过一个或多个空格分隔模式匹配单个文件、多个文件或目录。	`target/*.[ejw]ar`
`BP_MAVEN_POM_FILE`	指定项目的 pom.xml 文件的自定义位置。此值相对于项目的根目录（例如 /workspace）。	`pom.xml`
`BP_MAVEN_DAEMON_ENABLED`	触发 Apache `maven-mvnd` 的安装和配置，而不是 Maven。如果要使用 Maven 守护程序，请将此值设置为 `true`。	`false`
`BP_MAVEN_SETTINGS_PATH`	指定 Maven 的 settings.xml 文件的自定义位置。
`BP_INCLUDE_FILES`	用于匹配源文件的冒号分隔的 glob 模式列表。任何匹配的文件都保留在最终映像中。
`BP_EXCLUDE_FILES`	用于匹配源文件的冒号分隔的 glob 模式列表。任何匹配的文件会从最终映像中移除。首先应用任何包含模式，可以使用“排除模式”来减少生成中包含的文件。
`BP_JAVA_INSTALL_NODE`	控制单独的 Buildpack 是否安装 Yarn 和 Node.js。如果设置为 `true`，则 Buildpack 会检查 `BP_NODE_PROJECT_PATH` 设置的应用根或路径。项目路径会查找 yarn.lock 文件，这需要安装 Yarn 和 Node.js。如果有 package.json 文件，则生成只需要 Node.js。	`false`
`BP_NODE_PROJECT_PATH`	指示项目子目录查找 package.json 和 yarn.lock 文件。

配置 Tomcat

容器应用支持在 Tomcat 应用程序服务器中运行 war 文件。

下面是用于配置 Tomcat 的环境变量的列表：

生成环境变量	说明	默认
`BP_TOMCAT_CONTEXT_PATH`	装载应用程序的上下文路径。	默认为空 (`ROOT`)
`BP_TOMCAT_EXT_CONF_SHA256`	外部配置包的 SHA256 哈希。
`BP_TOMCAT_ENV_PROPERTY_SOURCE_DISABLED`	设置为 `true` 时，Buildpack 不配置 `org.apache.tomcat.util.digester.EnvironmentPropertySource`。添加此配置选项是为了支持从环境变量加载配置，并在 Tomcat 配置文件中引用它们。
`BP_TOMCAT_EXT_CONF_STRIP`	要从外部配置包中去除的目录级别数。	`0`
`BP_TOMCAT_EXT_CONF_URI`	外部配置包的下载 URI。
`BP_TOMCAT_EXT_CONF_VERSION`	外部配置包的版本。
`BP_TOMCAT_VERSION`	用于配置特定的 Tomcat 版本。支持的 Tomcat 版本包括 8、9 和 10。	`9.*`

配置云生成服务

下面是用于配置云生成服务的环境变量的列表：

生成环境变量	说明	默认
`ORYX_DISABLE_TELEMETRY`	控制是否禁用遥测收集。	`false`

如何配置 Java 生成环境变量

注意

若要运行以下 CLI 命令，请使用容器应用扩展版本 0.3.47 或更高版本。使用 az extension add --name containerapp --upgrade --allow-preview 命令安装最新版本。

可以通过 CLI 命令 az containerapp up、az containerapp create 或 az containerapp update 在部署 Java 应用程序源代码时配置 Java 生成环境变量：

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>

build-env-vars 参数是生成的环境变量列表，以 key=value 格式作为空格分隔的值出现。下面是可以作为变量传入的示例列表：

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

在 Azure 容器应用中使用 Azure CLI 设置 GitHub Actions 时，还可以配置 Java 生成环境变量。

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>

后续步骤

从存储库生成和部署

通过