如何在GitLab CI流水线中向并行矩阵传递数组变量？

你当前的写法无法实现预期效果——[$SUITES]会把SUITES变量的内容当作单个元素处理，不会自动拆分成数组项。要实现每个测试套件单独运行并行任务，以下是两种可行的调整方案：

方案1：通过变量传递数组格式值（推荐） #

如果SUITES是可提前定义的套件列表，直接通过GitLab CI变量传递合法的YAML数组格式，或对字符串格式的变量做语法适配：

配置示例 #

stages:
- test

test:
  stage: test
  image: $CI_REGISTRY_IMAGE
  parallel:
    matrix:
      # 若SUITES是逗号分隔字符串（如"auth,profile,payment"），替换逗号为空格适配YAML数组
      - SUITE: ${SUITES//,/ }
  script:
    - pytest -m ${SUITE} --json-report --json-report-file=${SUITE}_report.json
  artifacts:
    when: always
    paths:
      - "${SUITE}_report.json"
    expire_in: "1 day"

使用说明 #

• 在GitLab项目的CI/CD变量中定义SUITES时，两种格式都支持：
  1. 直接写YAML数组：["auth", "profile", "payment"]
  2. 逗号分隔字符串：auth,profile,payment（配合配置里的${SUITES//,/ }自动转换为数组格式）
• 这种方式无需修改.gitlab-ci.yml，就能通过变量灵活调整测试套件列表。

方案2：直接在矩阵中声明套件数组 #

如果套件列表固定，也可以直接在配置里写死数组，省去变量传递的步骤：

parallel:
  matrix:
    - SUITE: ["auth", "profile", "payment"]

常见误区修正 #

• 不要直接写SUITE: [$SUITES]：这会把$SUITES的完整内容当作单个矩阵项，比如SUITES=auth,profile时，只会生成一个任务，SUITE值为auth,profile，而非两个独立任务。
• 确保变量值符合YAML语法：传递数组格式的变量时，必须是合法的YAML数组结构，否则GitLab CI无法解析为多个并行任务。

内容的提问来源于stack exchange，提问作者Dmitriy Klepikov