基于 2024 年 5 月 27 日的部署实践，使用 Docker Compose v2.26.0 版本配合 GitLab CI 变量 $CI_COMMIT_REF_NAME 能有效解决多环境配置不一致导致的部署失败问题。
原因分析
根据 2025 年 11 月 19 日发布的集成指南，Docker Compose 在流水线中承担环境模拟加服务部署角色，核心优势在于开发、测试、生产环境均基于同一 docker-compose.yml 配置，避免开发能跑测试报错。
2026 年 2 月 6 日的实战指南进一步指出，配置即代码通过 compose.yaml 文件版本化管理服务配置，确保了多容器协调的简化。
解决方案
1. 基础环境安装
参考 2024 年 5 月 27 日的安装记录，需下载特定版本 Docker Compose，命令为 wget https://github.com/docker/compose/releases/download/v2.26.0/docker-compose-linux-x86_64，随后移动文件至 /usr/local/bin/docker-compose 并赋予执行权限。
2. CI 流水线配置
在 GitLab CI 中，利用 2023 年 12 月 26 日阿里云开发者社区提供的变量方案，设置 DOCKER_IMAGE_TAG 为 CI_REGISTRY_IMAGE 加 CI_COMMIT_REF_NAME 减 CI_COMMIT_SHA，确保每次提交生成唯一镜像标签。
3. 多环境部署命令
针对微服务场景，2026 年 3 月 6 日的 CompreFace 实践建议使用重叠配置文件命令：docker-compose -f docker-compose.yml -f docker-compose.dev.ui.yml up --build，实现后端服务与前端开发服务器的同时启动与热重载。
注意事项
部署 GitLab 容器时需注意端口冲突，2024 年 5 月 27 日的配置显示需映射 ports 为 80:80、443:443 及 2224:22，避免与宿主机现有服务占用相同端口。
此外，Harbor 仓库部署建议采用 v2.10.2 版本离线安装包，下载地址为 https://github.com/goharbor/harbor/releases/download/v2.10.2/harbor-offline-installer-v2.10.2.tgz，以确保私有镜像仓库的稳定性。
参考来源
来源：CSDN 博客 - Docker Compose CI/CD 集成完全指南：自动化构建、测试与部署 (2025 年 11 月 19 日)
来源：阿里云开发者社区 - 深入理解 CI/CD 与 Docker 集成：自动化构建和部署的完整指南 (2023 年 12 月 26 日)
来源：GitHub - docker/compose 和 goharbor/harbor 发布页面 (2024 年 5 月 27 日)
原文链接：https://www.zjcp.cc/ask/9808.html