Azure DevOps中Docker Compose无法在Dockerfile的COPY语句正确渲染变量

问题核心 #

在Azure DevOps流水线中，通过环境变量testvar传递路径到Dockerfile的COPY指令时，构建输出显示变量为空，但流水线命令行中testvar已正确解析。本地环境运行正常，仅在Azure DevOps中出现此问题。

解决方案：使用Docker构建参数替代环境变量 #

Dockerfile的COPY指令在构建阶段执行，宿主机的环境变量默认不会自动传递到构建上下文，需要通过构建参数（build args）显式传递。

1. 修改Dockerfile，声明并使用构建参数

FROM python:3-alpine
WORKDIR /some/testfolder
# 声明构建参数
ARG testvar
# 使用构建参数执行COPY操作
COPY ${testvar} /some/testfolder

2. 更新Docker Compose配置，传递构建参数
   在build节点下添加args字段，将宿主机的testvar环境变量传递给构建过程：

alpine2:
  build:
    context: ./python2
    dockerfile: Dockerfile.python2
    args:
      testvar: ${testvar}
  container_name: test-container2
  command:
    - /bin/sh
    - -c
    - |
      ls -ll "/some/testfolder"

3. 保持流水线命令不变
   确保流水线中testvar已正确赋值，命令无需修改：

- script: |
    testvar=$(fileapilocation) docker compose -f docker-compose.yml up --build

额外排查点 #

• 验证fileapilocation变量在流水线中存在有效值，可通过echo $(fileapilocation)步骤确认
• 检查Docker Compose版本，确保支持build.args语法（建议使用v2+版本）
• 确认${testvar}指向的文件/目录在Docker Compose指定的context路径范围内，避免因上下文限制导致文件找不到

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