GitLab CI配置manual与rules规则时作业异常运行问题排查

• rules匹配逻辑完全错误：GitLab CI的rules按从上到下顺序匹配，命中第一条符合条件的规则后就终止判断。你三个作业的rules末尾都加了一条无任何前置限制的- when: manual，意味着不管changes条件是否命中、前置作业是否执行成功，最终都会落到这条规则上，作业永远会被加入流水线，这是两个作业始终可运行的最主要原因。
• changes路径写法错误导致条件失效：changes字段匹配仓库文件时，路径是相对于仓库根目录的，不需要加./前缀。你写的./src/myfile.txt无法被GitLab正确识别，会导致文件变更判断永远不命中，直接走到最后一条manual规则。
• 缺少全局阶段顺序定义：配置里没有声明全局stages顺序，publishdev和pushstage两个阶段的执行顺序不可控，可能出现pushtostage早于devjob执行的问题。
• pushdev规则不符合需求：需求要求pushdev仅在devjob成功后才可手动触发，但现有配置第一条规则是文件变更时自动执行，也没有限制手动按钮的可用时机；另外同阶段作业默认并行，仅靠needs无法正确控制触发逻辑。
• pushtostage规则逻辑矛盾：需求要求作业仅在myfile.txt变更时才运行，但兜底的manual规则会让作业无论文件是否变更都会出现在流水线中。
• 额外缺失：pushdev声明依赖lint作业的制品，但配置中没有定义lint作业，运行时会直接报依赖错误。

# 先明确定义阶段执行顺序
stages:
  - publishdev
  - pushstage

devjob:
  image: node:16
  stage: publishdev
  script:
    - echo "running validation checks"
    - npm run validate
  rules:
    # 修正路径写法，移除错误的兜底manual规则，命中文件变更时自动执行
    - changes:
        - src/myfile.txt

# 若确实需要依赖lint作业，请补充lint作业的定义，否则删除needs中的"lint"项
pushdev:
  image: node:16
  stage: publishdev
  needs: ["devjob", "lint"]
  script:
    - echo "Pushing changes after validation to dev"
    - npm run pushdev
  rules:
    # 仅当myfile.txt变更时才加入流水线，设为手动触发
    - changes:
        - src/myfile.txt
      when: manual
      # 若要求该作业必须执行可设为false，手动作业默认允许失败
      allow_failure: true

pushtostage:
  image: node:16
  stage: pushstage
  script:
    - echo "Pushing changes to stage"
  rules:
    # 仅当myfile.txt变更时才加入流水线自动执行，无变更时作业不会出现在流水线中
    - changes:
        - src/myfile.txt

• 所有无意义的兜底when: manual规则已全部移除，从根源上解决作业无条件出现在流水线的问题
• 修正了changes的路径写法，确保文件变更判断能正常生效
• 明确定义了阶段顺序，保证publishdev阶段的作业全部执行完才会进入pushstage阶段
• pushdev配置了needs: ["devjob"]，只有devjob运行成功后，手动触发按钮才会变为可点击状态，完全满足“devjob成功后才支持手动触发”的要求
• pushtostage仅保留文件变更的判断规则，只有src/myfile.txt发生变更时作业才会被创建执行，满足“当且仅当文件变更时运行”的要求
• 如果你希望pushdev无论文件是否变更，只要devjob成功就支持手动触发，把pushdev的rules替换为- when: manual即可

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