首页/开发/CI/CD 与发布速查/GitLab CI 子流水线(Child Pipelines)
工具链要点63 条

GitLab CI 子流水线(Child Pipelines)

父流水线触发子流水线:适合按目录拆分的大型仓库与动态生成的流水线配置;用 strategy: depend 让父级等待子级结果。

CI/CD 与发布速查开发更新于 2026-10-12
写法trigger: {include: path}
动态生成trigger 指向 generate 作业产出的 YAML
等待trigger:strategy: depend 父级随子级结果
适用monorepo 按模块拆分、多项目编排

触发子流水线

触发子流水线
staging:
  stage: deploy
  trigger:
    include: .gitlab-ci-staging.yml
    strategy: depend
不设置 depend 时父流水线触发后立即继续:需要等待子级完成的编排要显式声明。

易错点

  • 子流水线配置写错:父级触发失败但错误信息在子级,排查入口要对准
  • 动态生成的 YAML 未做校验:错误配置直到运行时才暴露

数据来源与参考

  • GitLab Docs《Downstream pipelines》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌