如何在GitLab中按指定顺序自动化部署多Maven项目？

项目背景 #

• 拥有复杂Maven项目结构，包含外部依赖及开发中的内部依赖，所有项目托管在GitLab，依赖关系呈树形结构
• 所有项目的develop分支在提交/合并后，会自动触发构建部署流水线

依赖关系示例 #

依赖树结构如下：

/--> C
A ---> B -        /--> D
          \--> D -
                  \--> E

分层说明（0到3层）：

3 |   2   |    1   |   0  
____________________________
    |       | /--> C |
  A |---> B |-       | /--> D
    |       | \--> D |-
    |       |        | \--> E

示例中：A依赖B，B依赖C和D，D依赖自身和E。

当前痛点 #

当修改项目E并合并到develop分支后，需手动执行一系列繁琐操作：

1. 从E开始向左遍历所有依赖项目，手动更新POM中E的新版本
2. 按E → C → D → B → A的顺序（从右到左、同层从上到下）手动触发各项目的SNAPSHOT版本升级、构建与部署
3. 使用单个Runner确保同一时间仅部署一个项目，需等待前一个项目流水线完成后再操作下一个，流程耗时且易出错

核心需求 #

提交E的修改后，自动完成以下操作：

• 自动更新所有依赖E的项目POM文件，引入E的新版本
• 自动升级各项目自身版本号
• 按指定顺序自动触发各项目的构建与部署流水线

自动化解决方案 #

1. 版本自动更新：Maven版本插件+GitLab CI脚本 #

借助versions-maven-plugin实现依赖版本更新与自身版本升级，集成到CI脚本中：

• 调用versions:use-latest-snapshots自动拉取E的最新SNAPSHOT版本
• 调用versions:set自动递增当前项目版本号
• 脚本示例：

# 更新E的依赖到最新SNAPSHOT版本
mvn versions:use-latest-snapshots -Dincludes=com.yourgroup:E
# 自动升级当前项目版本（用流水线ID做版本后缀）
mvn versions:set -DnewVersion=1.0.${CI_PIPELINE_ID}-SNAPSHOT -DgenerateBackupPoms=false
# 提交POM变更到develop分支
git add pom.xml
git commit -m "Auto-update E dependency and bump version"
git push origin develop

2. 按序触发多项目流水线：GitLab多项目流水线链式触发 #

利用GitLab多项目流水线功能，配置上下游项目的触发链路，实现E → C → D → B → A的顺序执行：

• 在E项目的.gitlab-ci.yml中，部署完成后触发C项目的流水线
• 在C项目的CI配置中，部署完成后触发D项目的流水线，以此类推
• 配置示例（以E项目为例）：

deploy:
  stage: deploy
  script:
    - # 执行E的部署脚本
  after_script:
    - # 触发C项目的develop分支流水线
    - curl --request POST --form "token=${CI_JOB_TOKEN}" --form "ref=develop" https://gitlab.example.com/api/v4/projects/${C_PROJECT_ID}/trigger/pipeline

• 注意：需在GitLab中配置项目间的CI_JOB_TOKEN权限，确保上游项目可触发下游流水线

3. 串行部署控制：专属Runner标签+流水线依赖 #

• 给单个Runner添加专属标签（如serial-deploy），所有部署任务指定使用该标签，确保同一时间仅运行一个部署任务
• 在每个项目的CI配置中，设置部署任务依赖上游项目流水线的成功状态，避免并行部署导致的依赖版本不一致

4. 依赖树自动解析（可选） #

针对超复杂依赖树，可结合maven-dependency-plugin生成依赖树文件，再通过脚本解析出需更新的项目顺序，实现完全自动化的依赖链触发：

# 生成项目依赖树文件
mvn dependency:tree -DoutputFile=dependency-tree.txt
# 解析依赖树，提取依赖E的项目并排序为指定顺序
python parse-dependency-tree.py dependency-tree.txt

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