在CI/CD中通过Docker Compose变量语法动态注入镜像Tag，需用${APP_TAG:-latest}格式声明镜像、流水线中导出同名环境变量，并用docker-compose config验证解析结果。
在 CI/CD 流水线中，通过 Docker Compose 的变量语法动态注入镜像 Tag，核心是结合环境变量传递 + docker-compose.yml 中的变量占位符，而非依赖构建时硬编码或外部脚本替换。
确保 Compose 文件使用标准变量语法
Compose 支持 ${VAR_NAME} 和 $VAR_NAME 两种形式（推荐前者，更明确且兼容性更好）。镜像字段必须写成可被替换的形式：
- ✅ 正确写法：
image: myapp:${APP_TAG:-latest} - ✅ 带默认值更安全，避免空 Tag 导致拉取失败
- ❌ 避免写死：
image: myapp:v1.2.3或image: myapp:$CI_COMMIT_TAG（Shell 变量不被 Compose 解析）
在流水线中正确导出并传递环境变量
变量需在执行 docker-compose up 或 docker-compose build 前生效，且作用域覆盖 Compose 进程：
- GitLab CI 示例：
APP_TAG: $CI_COMMIT_TAG（在variables下定义），或运行前用export APP_TAG=$CI_COMMIT_TAG - Github Actions 示例：
env: { APP_TAG: ${{ github.sha }} }，并在run步骤中调用docker-compose up -d - 关键点：变量名必须与 Compose 文件中
${...}内完全一致，区分大小写
验证变量是否生效的简单方法
无需启动服务，用 Compose 自带命令快速检查解析结果：
- 运行
docker-compose config，输出会显示实际使用的镜像名（如image: myapp:abc123） - 若看到原始占位符（如
image: myapp:${APP_TAG}），说明变量未导出或拼写错误 - 也可临时加
echo "Using tag: ${APP_TAG}"在流水线中辅助调试
进阶：多环境差异化 Tag 注入
可通过不同变量控制开发、测试、生产环境的镜像来源：
- 例如：
image: myapp:${APP_TAG:-dev}-${ENVIRONMENT:-local} - 在 CI 中按 stage 设置
ENVIRONMENT: staging，再配合APP_TAG即可生成myapp:20240501-staging - 注意：Compose 不支持嵌套变量（如
${${ENV}_TAG}），复杂逻辑建议用 Makefile 或 Shell 封装
