使用az containerapp compose部署容器：环境变量值未读取及.env文件咨询

关于.env文件的支持 #

az containerapp compose up 命令支持读取同目录下的.env文件，但需要满足以下要求：

• .env文件必须与docker-compose.yaml处于同一目录
• 执行命令时的工作目录需指向该目录，或通过--file指定docker-compose.yaml路径时，确保.env在对应目录
• docker-compose.yaml中需使用${变量名}的格式引用.env中的值，示例：

  # docker-compose.yaml
  services:
    api:
      image: my-api:v1
      environment:
        - DB_CONN_STRING=${DB_CONN}
        - API_PORT=${PORT}
  

  # .env
  DB_CONN=postgres://user:pass@db:5432/mydb
  PORT=8080
  

其他替代方法 #

除了使用Container App原生YAML，还有以下几种方式：

1. 直接在docker-compose.yaml中硬编码值 #

适合临时测试场景，直接将变量值写在environment字段中：

services:
  web:
    image: nginx:alpine
    environment:
      - NGINX_PORT=80
      - API_ENDPOINT=http://api:8080

2. 命令行参数传递变量 #

运行az containerapp compose up时，通过--env-vars参数直接传递环境变量，多个变量用空格分隔：

az containerapp compose up --env-vars DB_HOST=db.example.com REDIS_PASS=myredissecret

3. Azure Key Vault 集成（生产环境推荐） #

对于敏感变量，建议存储在Azure Key Vault中，通过托管标识让Container App访问：

1. 为Container App的托管标识分配Key Vault的Secret Reader权限
2. 在docker-compose.yaml中使用Key Vault引用格式：

   services:
     app:
       image: my-prod-app:v2
       environment:
         - DB_PASSWORD=@Microsoft.KeyVault(SecretUri=https://my-vault.vault.azure.net/secrets/db-password/)
   

排查要点 #

• 检查.env文件格式：变量名无多余空格，值无需额外引号（除非值本身包含空格或特殊字符）
• 执行命令时添加--debug参数，查看日志确认是否正确读取.env文件
• 确认docker-compose.yaml中的变量引用格式为${VAR_NAME}，避免语法错误

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