GitLab CI如何基于git diff结果条件性运行或约束作业？

完全可以实现你的需求，核心思路是通过判断分支更新前后的代码差异，决定是否自动运行耗时作业，同时保留手动触发入口且不阻塞合并流程。以下是主流CI系统的具体配置方案：

GitLab CI 配置示例 #

针对GitLab合并请求场景，通过rules结合文件变化检测或自定义diff判断，实现差异化触发：

# 定义耗时作业
heavy_resource_job:
  stage: test
  script:
    - echo "执行资源密集型作业..."
    - # 替换为你的实际作业命令（如编译、集成测试等）
  rules:
    # 当合并请求有代码变更时，自动运行作业
    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
      changes:
        - src/**/*  # 指定作业关联的文件路径，可根据实际调整
        - tests/**/*
      when: always
    # 当无代码变更时，仅允许手动触发，且不阻塞合并
    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
      when: manual
      allow_failure: true
  # 允许作业失败，不强制要求通过
  allow_failure: true

如果需要更精确的diff判断（比如排除合并main分支带来的提交历史变化），可以在before_script中自定义差异检测逻辑：

heavy_resource_job:
  stage: test
  before_script:
    - git fetch origin main
    # 计算当前分支与main分支的实际代码差异（排除合并历史）
    - DIFF_CONTENT=$(git diff origin/main...$CI_COMMIT_SHA --name-only)
    - if [ -z "$DIFF_CONTENT" ]; then export NO_CHANGES=true; fi
  script:
    - if [ "$NO_CHANGES" = "true" ]; then echo "无代码变更，跳过自动执行"; exit 0; fi
    - # 执行实际作业命令
  rules:
    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
      allow_failure: true
    - if: '$CI_PIPELINE_SOURCE == "web"'  # 支持手动触发
      when: always
  allow_failure: true

GitHub Actions 配置示例 #

在GitHub PR中，通过自定义步骤判断diff结果，控制作业执行：

name: Merge Request CI
on:
  pull_request:
    branches: [main]

jobs:
  heavy_job:
    runs-on: ubuntu-latest
    continue-on-error: true  # 不阻塞PR合并
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0  # 拉取完整Git历史，确保diff计算准确
      
      - name: 检测代码变更
        id: check_changes
        run: |
          # 对比当前分支与main分支的实际差异
          DIFF=$(git diff origin/main...HEAD --name-only)
          if [ -z "$DIFF" ]; then
            echo "changes=false" >> $GITHUB_OUTPUT
          else
            echo "changes=true" >> $GITHUB_OUTPUT
          fi
      
      - name: 自动运行耗时作业（仅当有变更时）
        if: steps.check_changes.outputs.changes == 'true'
        run: |
          echo "执行资源密集型作业..."
          # 替换为你的实际作业命令
      
      - name: 无变更提示（支持手动重跑）
        if: steps.check_changes.outputs.changes == 'false'
        run: echo "无代码变更，可在Actions页面手动重跑此作业"

关键注意事项 #

• Git历史完整性：确保CI环境拉取完整Git历史（如fetch-depth: 0），否则diff计算可能遗漏关键变更
• 路径精准性：使用changes或指定diff文件路径时，尽量缩小范围，避免无关文件变更触发作业
• 权限配置：确保团队成员拥有手动触发作业的权限，按需执行验证
• 失败容忍：通过allow_failure或continue-on-error设置作业非强制通过，不阻塞合并流程

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