CI/CD / 系统课时
配置并行与矩阵任务
配置并行与矩阵任务
当一条持续集成流水线需要同时验证多个运行时版本或测试类型时,串行执行会把反馈时间直接相加。本课用 GitLab CI 的并行与矩阵能力,把兼容性验证拆成可独立调度的作业,并说明怎样避免并行后成本失控。
学习目标
- 区分普通并行作业与矩阵作业的适用场景
- 使用
parallel:matrix生成多组兼容性验证任务 - 判断 Runner 并发度、共享资源和失败策略对总耗时的影响
先拆清并行与矩阵
普通并行适合“同一种工作拆成多份”,例如把一组测试按分片编号分给多个 Runner;矩阵任务适合“同一套步骤使用不同参数组合”,例如 Node.js 20/22 分别运行 unit/integration 测试。矩阵的价值不是复制 YAML,而是让变量组合自动展开成独立作业。

配置版本与测试类型矩阵
下面是一份可直接提交到仓库根目录的 .gitlab-ci.yml。它使用两个 Node.js 主版本和两种测试类型,最终展开为四个作业;示例中的脚本只验证矩阵变量与运行时版本,方便先确认调度结构正确。
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预期结果
共生成 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 或减少矩阵组合。
最终保留的矩阵应同时满足两点:每个组合都对应真实兼容性风险,而且新增并发带来的反馈收益高于计算资源与维护成本。