Azure DevOps Docker@2任务中构建参数无法展开流水线变量

核心问题分析 #

你遇到的问题主要来自两个关键点：

1. 变量模板中误用了中文单引号，导致date命令执行失败，无法生成正确日期值
2. Azure DevOps变量展开顺序差异：${{variables.TODAY}}是编译时解析，而日期属于运行时动态生成的值，必须用运行时变量引用$(TODAY)

可行解决方案 #

方案1：前置任务生成并设置运行时变量（推荐） #

在Docker任务前添加Bash/PowerShell任务，动态计算当日日期并设置为管道变量，确保Docker任务能正确读取：

针对Linux代理（Bash任务）

- bash: |
    # 使用英文单引号执行date命令
    TODAY=$(date +'%Y-%m-%d')
    # 将值设置为管道级变量
    echo "##vso[task.setvariable variable=TODAY]$TODAY"
  displayName: '生成并设置当日日期变量'

针对Windows代理（PowerShell任务）

- powershell: |
    $today = Get-Date -Format "yyyy-MM-dd"
    Write-Host "##vso[task.setvariable variable=TODAY]$today"
  displayName: '生成并设置当日日期变量'

后续Docker任务调用

- task: Docker@2
  displayName: '构建Docker镜像'
  inputs:
    command: build
    dockerfile: '**/Dockerfile'
    # 使用运行时变量引用$(TODAY)传递build-arg
    buildArguments: '--build-arg TODAY=$(TODAY)'

方案2：修复变量模板并调整引用方式 #

如果要保留变量模板，先修正模板中的符号问题：

# 变量模板文件（如variables.yml）
variables:
  # 替换中文单引号为英文单引号
  TODAY: $(date '%Y-%m-%d')

然后在管道中引用模板后，Docker任务必须使用运行时变量语法$(TODAY)，而非编译时的${{variables.TODAY}}：

- template: variables.yml

- task: Docker@2
  displayName: '构建Docker镜像'
  inputs:
    command: build
    dockerfile: '**/Dockerfile'
    buildArguments: '--build-arg TODAY=$(TODAY)'

验证Dockerfile中的接收 #

确保Dockerfile中正确接收并使用该参数：

# 声明构建参数
ARG TODAY
# 示例：将日期写入环境变量或用于其他操作
ENV BUILD_DATE=${TODAY}

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