GitLab CI/CD YAML配置报错排查及自定义规则需求咨询

问题描述 #

现有.gitlab-ci.yml配置如下：

job1:
    stage: build
    script:
        - cd docker/some-dir
        - make build
        - make run
    rules:
        - changes: 
            - "docker/some-dir/**/*"
          when: always
        - when: never

job2:    
    stage: build
    needs:
        - job1
    script:
        - cd docker/some-dir2
        - make build
        - make run

背景信息：

• job1负责构建推送docker_image_1，job2负责构建推送docker_image_2，后者的Dockerfile以FROM docker_image_1开头，依赖前者
• 需求是仅当docker/some-dir目录有变更时才重建docker_image_1，但删除job1的rules会导致所有push事件都触发构建，不符合预期
• 当前配置提示YAML错误但无详细信息，且规则无法实现预期逻辑

预期要实现的规则：

• 当docker/some-dir目录有变更（所有push触发的流水线）时运行job1
• 非push事件触发的流水线（手动触发、定时任务等）也运行job1
• 其他情况不运行job1
• 无论job1是否运行，job2都必须执行

配置无效的原因 #

1. YAML语法缩进问题：changes字段下的路径列表缩进层级错误，GitLab CI要求规则内的子项（比如changes和when）保持对齐，路径列表要作为changes的子项，缩进需与changes保持正确层级。
2. 规则逻辑覆盖不全：原规则只处理了push且目录变更的场景，没有覆盖手动触发、定时任务等非push事件；最后一条when: never会直接阻止所有未匹配前一条规则的场景，包括需要运行job1的非push事件。
3. job2的依赖冲突：job2配置了needs: [job1]，如果job1不运行，job2会因为依赖不存在而被跳过，无法实现“无论job1是否运行都执行job2”的需求。

修正后的配置 #

job1:
    stage: build
    script:
        - cd docker/some-dir
        - make build
        - make run
    rules:
        # 非push事件（手动、定时等）强制运行job1
        - if: '$CI_PIPELINE_SOURCE != "push"'
          when: always
        # push事件且目标目录有变更时强制运行job1
        - if: '$CI_PIPELINE_SOURCE == "push"'
          changes:
            - "docker/some-dir/**/*"
          when: always
        # 其他情况不运行job1
        - when: never

job2:    
    stage: build
    script:
        - cd docker/some-dir2
        - make build
        - make run
    # 确保job2始终执行
    rules:
        - when: always
    # 若需要等待job1完成再执行，同时允许job1不运行时job2正常执行
    needs:
        - job1
    allow_failure: true

关键修正说明 #

• 修复YAML缩进：确保changes下的路径列表与changes保持正确缩进，规则内的if/changes/when字段对齐。
• 完善规则逻辑：分两条规则分别覆盖非push事件、push且目录变更的场景，最后用when: never兜底其他情况，完全匹配需求。
• 调整job2依赖：通过rules: - when: always确保job2始终执行；保留needs保证job1运行时先完成构建，同时添加allow_failure: true，避免job1不运行时job2被跳过。

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