如何实现GitLab多流水线串行执行integration-test完整阶段

你的问题核心是共享测试资源（部署在VM上的ag-test专属Runner）被多条流水线同时占用，导致安装、卸载网关的任务交叉执行，破坏了集成测试的依赖环境。最直接的解决方案是用GitLab CI原生的**资源组（resource groups）**来限制integration-test阶段的并发执行，确保同一时间只有一条流水线的该阶段任务完整运行。

具体配置修改方案 #

方案1：为每个任务添加资源组约束

直接给integration-test阶段的三个任务都加上同一资源组标记，同时用needs保证单条流水线内的任务执行顺序：

stages:
  # 保留你原有的其他阶段
  - integration-test

install-gw:
  stage: integration-test
  tags:
    - ag-test
  resource_group: ag-test-vm-exclusive-lock  # 自定义唯一的资源锁名称
  script:
    - ./你的安装网关脚本.sh

integration-test:
  stage: integration-test
  tags:
    - ag-test
  resource_group: ag-test-vm-exclusive-lock
  script:
    - ./你的集成测试脚本.sh
  needs: [install-gw]  # 确保安装完成后再跑测试

uninstall-gw:
  stage: integration-test
  tags:
    - ag-test
  resource_group: ag-test-vm-exclusive-lock
  script:
    - ./你的卸载网关脚本.sh
  needs: [integration-test]  # 确保测试完成后再卸载

方案2：为整个阶段添加资源组约束（更简洁）

如果该阶段的所有任务都需要共享同一资源锁，可以直接给阶段本身配置资源组，阶段内的所有任务会自动继承这个约束：

stages:
  # 保留你原有的其他阶段
  - name: integration-test
    resource_group: ag-test-vm-exclusive-lock  # 给整个阶段加资源锁

install-gw:
  stage: integration-test
  tags:
    - ag-test
  script:
    - ./你的安装网关脚本.sh

integration-test:
  stage: integration-test
  tags:
    - ag-test
  script:
    - ./你的集成测试脚本.sh
  needs: [install-gw]

uninstall-gw:
  stage: integration-test
  tags:
    - ag-test
  script:
    - ./你的卸载网关脚本.sh
  needs: [integration-test]

原理说明 #

• 资源组是GitLab CI的原生功能，会自动对标记了同一资源组的任务进行排队：只有当前正在执行的流水线完成该阶段的所有任务后，下一条流水线的该阶段任务才会启动。
• needs配置保证了单条流水线内的任务按install-gw → integration-test → uninstall-gw的顺序执行，避免单条流水线内的任务乱序。
• 资源组是项目级别的，同一项目下的所有流水线都会遵守这个锁的规则，不会出现跨流水线的任务交叉。

注意事项 #

• 确保你的GitLab版本在13.6及以上（资源组功能是13.6版本引入的）。
• 资源组名称可以自定义，只要在项目内唯一即可，建议命名和资源用途关联，方便维护。

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