Docker化Java应用中如何注入ADO流水线环境变量至代码？

这个问题我之前帮团队排查过类似的情况，核心原因是Docker容器的隔离性：ADO流水线的环境变量只存在于流水线的代理机器环境中，不会自动传递到Docker容器内部，所以你在entrypoint.sh里写的$(Build.DefinitionName)这类变量，容器里的bash会把它当成自己的本地变量（而这个变量在容器里根本没定义），自然无法替换成实际值。

下面给你两种可行的解决方案，你可以根据自己的场景选择：

方案一：在Docker构建时传递环境变量到容器内部 #

这种方法是把ADO的流水线变量通过Docker的构建参数传递到镜像里，然后让entrypoint脚本读取这些变量来替换pom.xml的内容。

步骤1：在ADO流水线的Docker Build任务中传递构建参数 #

修改你的ADO流水线YAML，在Docker build命令里加上--build-arg参数，把需要的变量传进去：

- task: Docker@2
  inputs:
    containerRegistry: '你的容器注册表'
    repository: '你的应用镜像名'
    command: 'build'
    Dockerfile: '**/Dockerfile'
    arguments: >
      --build-arg BUILD_DEFINITION_NAME=$(Build.DefinitionName)
      --build-arg BUILD_SOURCE_BRANCH_NAME=$(Build.SourceBranchName)

步骤2：在Dockerfile中接收参数并设置为环境变量 #

在你的Dockerfile里添加ARG指令接收这些参数，再通过ENV把它们设置为容器内的环境变量，这样entrypoint脚本就能读取到：

# 接收构建参数
ARG BUILD_DEFINITION_NAME
ARG BUILD_SOURCE_BRANCH_NAME

# 设置为容器环境变量
ENV BUILD_DEFINITION_NAME=$BUILD_DEFINITION_NAME
ENV BUILD_SOURCE_BRANCH_NAME=$BUILD_SOURCE_BRANCH_NAME

# 复制并赋予脚本执行权限
COPY entrypoint1.sh entrypoint2.sh /
RUN chmod +x /entrypoint1.sh /entrypoint2.sh

# 后续的启动命令...

步骤3：修改entrypoint2.sh替换pom.xml的占位符 #

把你原来在pom.xml里写的$(Build.DefinitionName)改成自定义的占位符（比如{{BUILD_DEFINITION_NAME}}），然后在entrypoint2.sh里用sed命令替换：

#!/bin/bash

# 替换pom.xml中的占位符为实际环境变量值
sed -i "s/{{BUILD_DEFINITION_NAME}}/$BUILD_DEFINITION_NAME/g" pom.xml
sed -i "s/{{BUILD_SOURCE_BRANCH_NAME}}/$BUILD_SOURCE_BRANCH_NAME/g" pom.xml

# 执行后续的插件和mvn package命令
# ...你的原有脚本逻辑...

方案二：在ADO流水线阶段预先替换pom.xml变量 #

这种方法更简单，直接在Docker构建之前，用ADO的内置任务把pom.xml里的变量替换好，再把处理后的pom.xml复制到镜像里，容器内部就不用再处理变量了。

步骤1：使用ADO的Replace Tokens任务替换pom.xml #

在Docker build任务之前添加ReplaceTokens@4任务，配置好要替换的占位符：

- task: ReplaceTokens@4
  inputs:
    targetFiles: '**/pom.xml'
    encoding: 'utf-8'
    tokenPattern: 'custom'
    tokenPrefix: '$('
    tokenSuffix: ')'

这里的tokenPrefix和tokenSuffix对应你原来写的$(Build.DefinitionName)格式，任务会自动把这些占位符替换成ADO流水线的实际变量值。

步骤2：正常执行Docker build #

经过上面的任务处理后，pom.xml里的变量已经是实际值了，接下来正常执行Docker build即可，容器内的entrypoint2.sh不需要做任何修改，直接使用更新后的pom.xml执行mvn package就行。

这两种方案都能解决你的问题，方案二更适合变量较少、不想修改Docker镜像逻辑的场景；方案一则更灵活，适合需要在容器内部动态使用变量的场景。

内容的提问来源于stack exchange，提问作者Arvind