GitLab CI/CD多版本并行作业配置问题求助

问题说明 #

现有GitLab CI/CD配置中，build_ubuntu作业通过parallel.matrix并行运行版本A、B、C，但需要为每个版本绑定对应的EXEFILE和EXEPATH参数（A对应A_EXE/A_PATH，B对应B_EXE/B_PATH，C对应C_EXE/C_PATH）。尝试使用对象数组格式定义矩阵时，返回YAML无效错误。

原始核心配置：

.apk_caching: &apk_caching
    tags:
        - runner_name
    image:
        name: $IMAGE_DOCKER:latest
    <<: *docker_dind_service

.program_ready_template: &program_ready_template
    <<: *apk_caching
    stage: build
    script:
        - python2.7 method.py

build_ubuntu:
  variables:
    program_version : $version
    program_exe : $EXEFILE
    program_installer_path : $EXEPATH
  extends: .program_ready_template
  rules:
    - *rules_schedule
    - *rules_branch
    - if: '$CI_PIPELINE_SOURCE != "web"'
        changes:
        - images/dockerfiles/*
        when: always
    - when: never   
  parallel:
    matrix:
      - version: ["A", "B", "C"]

参数对应关系：

• 版本A：EXEFILE=A_EXE，EXEPATH=A_PATH
• 版本B：EXEFILE=B_EXE，EXEPATH=B_PATH
• 版本C：EXEFILE=C_EXE，EXEPATH=C_PATH

尝试的无效配置：

parallel:
      matrix:
        - version: "A"
          EXEFILE: "A_EXE"
          EXEPATH: "A_PATH"
        - version: "B"
          EXEFILE: "B_EXE"
          EXEPATH: "B_PATH"
        - version: "C"
          EXEFILE: "C_EXE"
          EXEPATH: "C_PATH"

正确解决方案 #

问题出在YAML缩进语法错误，GitLab CI支持用对象数组定义并行矩阵，每个对象对应一组绑定的参数组合。修正后的完整build_ubuntu配置如下：

build_ubuntu:
  variables:
    program_version : $version
    program_exe : $EXEFILE
    program_installer_path : $EXEPATH
  extends: .program_ready_template
  rules:
    - *rules_schedule
    - *rules_branch
    - if: '$CI_PIPELINE_SOURCE != "web"'
      changes:
      - images/dockerfiles/*
      when: always
    - when: never   
  parallel:
    matrix:
      - version: "A"
        EXEFILE: "A_EXE"
        EXEPATH: "A_PATH"
      - version: "B"
        EXEFILE: "B_EXE"
        EXEPATH: "B_PATH"
      - version: "C"
        EXEFILE: "C_EXE"
        EXEPATH: "C_PATH"

关键说明 #

1. 缩进规范：确保所有同级YAML键的缩进一致（建议用2或4个空格，禁止用制表符），比如matrix下每个-后的version、EXEFILE、EXEPATH必须对齐。
2. 参数绑定：每个数组元素是独立的参数对象，GitLab会为每个对象生成一个并行作业，自动将对象中的键值对注入为作业变量。
3. 变量引用：variables段中的$version、$EXEFILE、$EXEPATH会自动匹配矩阵中对应的参数值，传递给脚本使用。

内容的提问来源于stack exchange，提问作者'H'H'