使用az containerapp compose create时如何让环境变量生效？

问题原因 #

Azure CLI的az containerapp compose create命令不支持自动解析Compose文件中的Shell环境变量占位符，和原生Docker Compose的行为不同。你设置的DOCKER_REGISTRY环境变量不会被替换到${DOCKER_REGISTRY-}的位置，导致Azure CLI直接把这个占位符当成镜像名称的一部分，触发镜像解析错误。

可行解决方案 #

方案1：用Shell工具预替换环境变量 #

先通过Shell工具将Compose文件中的变量占位符替换为实际值，再传给Azure CLI命令：

Bash环境

使用envsubst工具生成替换后的Compose文件：

# 生成替换了变量的临时Compose文件
envsubst < docker-compose.yml > docker-compose-resolved.yml
# 用替换后的文件运行Azure命令
az containerapp compose create --file docker-compose-resolved.yml

PowerShell环境

用PowerShell的字符串替换功能处理：

# 读取原文件并替换变量
(Get-Content docker-compose.yml) -replace '${DOCKER_REGISTRY-}', $env:DOCKER_REGISTRY | Set-Content docker-compose-resolved.yml
# 执行Azure命令
az containerapp compose create --file docker-compose-resolved.yml

方案2：借助原生Docker Compose先构建推送镜像 #

利用原生Docker Compose能解析环境变量的特性，先完成镜像的构建和推送，再让Azure CLI引用已存在的镜像：

# 用原生Docker Compose构建镜像（自动解析变量）
docker compose build
# 推送镜像到你的仓库
docker compose push
# 直接运行Azure命令，此时镜像已存在，无需再解析变量
az containerapp compose create --file docker-compose.yml

补充说明 #

建议将Compose文件中image字段调整为${DOCKER_REGISTRY-}/sample-blazorapp（添加斜杠），避免镜像名称格式错误——这个调整需要配合上述方案一起使用，因为只有变量被替换后，斜杠才会生效。

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