CI/CD / 系统课时

配置并行与矩阵任务

配置并行与矩阵任务

当一条持续集成流水线需要同时验证多个运行时版本或测试类型时,串行执行会把反馈时间直接相加。本课用 GitLab CI 的并行与矩阵能力,把兼容性验证拆成可独立调度的作业,并说明怎样避免并行后成本失控。

学习目标

  • 区分普通并行作业与矩阵作业的适用场景
  • 使用 parallel:matrix 生成多组兼容性验证任务
  • 判断 Runner 并发度、共享资源和失败策略对总耗时的影响

先拆清并行与矩阵

普通并行适合“同一种工作拆成多份”,例如把一组测试按分片编号分给多个 Runner;矩阵任务适合“同一套步骤使用不同参数组合”,例如 Node.js 20/22 分别运行 unit/integration 测试。矩阵的价值不是复制 YAML,而是让变量组合自动展开成独立作业。

并行作业与版本矩阵的展开关系

配置版本与测试类型矩阵

下面是一份可直接提交到仓库根目录的 .gitlab-ci.yml。它使用两个 Node.js 主版本和两种测试类型,最终展开为四个作业;示例中的脚本只验证矩阵变量与运行时版本,方便先确认调度结构正确。

yaml
stages:
  - test

compatibility-test:
  stage: test
  image: node:${NODE_VERSION}-bookworm
  parallel:
    matrix:
      - NODE_VERSION: ["20", "22"]
        TEST_SUITE: ["unit", "integration"]
  script:
    - printf 'node=%s suite=%s\n' "$NODE_VERSION" "$TEST_SUITE"
    - node -e "if (process.versions.node.split('.')[0] !== process.env.NODE_VERSION) process.exit(1)"
    - |
      if [ "$TEST_SUITE" = "unit" ]; then
        node -e "console.log('unit-ok')"
      else
        node -e "console.log('integration-ok')"
      fi

预期结果

text
共生成 4 个 compatibility-test 作业:
NODE_VERSION=20, TEST_SUITE=unit
NODE_VERSION=20, TEST_SUITE=integration
NODE_VERSION=22, TEST_SUITE=unit
NODE_VERSION=22, TEST_SUITE=integration

每个作业独立通过后,test 阶段通过。

实际 Job 日志会分别显示对应组合;镜像补丁版本、Runner 名称和时间戳等动态值可能不同。把最后一段演示脚本替换为项目真实的单元测试、集成测试或构建命令,就能把同一结构用于兼容性验证。

控制并行后的总成本

矩阵组合数会按维度相乘。两个版本乘两类测试只有四个作业,但继续加入操作系统、数据库版本和架构后,数量会快速增长。只保留真正影响兼容性的维度,并把昂贵组合安排在主分支或定时流水线中,通常比在每次提交上跑完整矩阵更合理。

并行任务还应避免争用同一外部状态,例如共用数据库 schema、固定端口、同名临时文件或同一部署环境。需要共享资源时,为每个作业使用包含矩阵变量或 $CI_JOB_ID 的唯一名称,或者主动限制并发。

验收矩阵是否值得保留

提交配置后,先确认流水线确实生成预期数量的作业,再比较串行基线与矩阵后的总墙钟时间。若四个任务都能同时获得 Runner,反馈时间应接近最慢单个作业,而不是四个作业耗时之和;若排队时间反而增长,就应先扩容 Runner 或减少矩阵组合。

最终保留的矩阵应同时满足两点:每个组合都对应真实兼容性风险,而且新增并发带来的反馈收益高于计算资源与维护成本。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置并行与矩阵任务

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通