Azure DevOps组变量无法传入Docker Compose问题求助

问题根源 #

1. Azure DevOps的机密变量默认不会自动注入到脚本的运行环境，必须显式声明才能让shell和Docker Compose读取到
2. Docker Compose解析${VAR_NAME}时，优先读取当前执行shell的环境变量，你当前的流水线配置没有把变量组的变量传递到这个环境中

具体修复步骤 #

1. 显式传递变量组变量到流水线脚本环境 #

修改azure-pipeline.yml的script步骤，通过env块把变量组里的变量逐个传递到运行docker-compose的shell环境中：

steps:
  - script: |
      date
      docker-compose run app 
    env:
      PAT: $(System.AccessToken)
      # 把变量组中的机密变量显式传递到环境
      ClientSettings__CreateClientId: $(ClientSettings__CreateClientId)
      ClientSettings__CreateClientSecret: $(ClientSettings__CreateClientSecret)
      ClientSettings__CreateClientScope: $(ClientSettings__CreateClientScope)
      # 可选：传递.env中的通用变量（如果需要流水线覆盖也可在这里指定）
      ASPNETCORE_ENVIRONMENT: $(ASPNETCORE_ENVIRONMENT)
      REPOSITORY_URL: $(REPOSITORY_URL)
    displayName: Build and Test

2. 修正Docker Compose的语法错误 #

你的docker-compose.yml存在两处语法问题，会导致变量解析失败：

• 注释格式错误：应该用#而非== ((...))
• 变量引用格式错误：Docker Compose变量用${}而非$()，且注意变量名拼写（genreric_variable应为generic_variable）

修正后的docker-compose.yml：

version: '3.7'

services:
  app:
    image: ${REPOSITORY_URL}:latest
    build:
      context: ./
      dockerfile: ./Dockerfile
      args:
        PAT: ${pat} # 所有环境通用，从.env文件读取
    environment:
      generic_variable: ${GENERIC_VARIABLE} # 通用变量从.env或环境变量读取
      ClientSettings__CreateClientId: ${ClientSettings__CreateClientId}
      ClientSettings__CreateClientSecret: ${ClientSettings__CreateClientSecret}
      ClientSettings__CreateClientScope: ${ClientSettings__CreateClientScope}

3. 机密变量传递注意事项 #

• Azure DevOps的机密变量在流水线日志中会自动屏蔽为***，但传递给Docker Compose时会正常赋值，不用担心泄露
• 确保变量组中的变量名和Docker Compose里的引用完全一致（包括双下划线这类特殊格式）

4. 可选：用脚本导出变量替代env块 #

如果变量较多，也可以在脚本中直接导出流水线变量，无需逐个写在env块：

steps:
  - script: |
      # 导出流水线变量到当前shell环境
      export ClientSettings__CreateClientId=$(ClientSettings__CreateClientId)
      export ClientSettings__CreateClientSecret=$(ClientSettings__CreateClientSecret)
      export ClientSettings__CreateClientScope=$(ClientSettings__CreateClientScope)
      export PAT=$(System.AccessToken)
      # 运行docker-compose，自动读取.env和当前环境变量
      docker-compose run app 
    displayName: Build and Test

验证方法 #

在脚本中添加printenv命令，检查变量是否正确注入：

steps:
  - script: |
      printenv | grep ClientSettings
      docker-compose run app 
    env:
      # 传递变量
    displayName: Build and Test

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