首页/开发/CI/CD 与发布速查/GitLab CI parallel:matrix 矩阵
工具链要点63 条

GitLab CI parallel:matrix 矩阵

一次定义多组作业:维度变量的组合自动展开,适合跨版本、跨数据库的兼容性测试。

CI/CD 与发布速查开发更新于 2026-10-12
写法parallel:matrix 列表
变量每个组合注入维度变量
展开作业数 = 维度组合数
资源大量组合消耗并发额度

双维度矩阵

双维度矩阵
test:
  parallel:
    matrix:
      - RUBY: ["3.1", "3.2"]
        DB: [postgres, mysql]
  script:
    - run-tests --ruby=$RUBY --db=$DB
矩阵与 needs、rules 可组合:小矩阵 + DAG 是常见的兼容测试形态。

易错点

  • 组合数失控:多维度相乘拉长排队时间,先评估 Runner 容量
  • 变量名大小写不一致:脚本取值为空却难以察觉

数据来源与参考

  • GitLab Docs《Parallel execution》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌