如何配置GitLab CI/CD，仅在Dockerfile变更时触发build_image任务

Got it, let's sort this out for you! The core trick here is leveraging GitLab CI's change detection features to control which jobs run based on which files were modified. First, let's fix a tiny typo in your original config (your build_image job was referencing a non-existent stage run_docker—it should match the build_image stage defined in your stages list), then implement the targeted triggers.

Recommended Modern Syntax (Using rules) #

This approach is more flexible and aligns with GitLab's current best practices:

stages:
  - run_script
  - build_image

run_script:
  stage: run_script
  script:
    - echo "script is running"
  rules:
    # Run this job only when changes don't include Dockerfile
    - if: '$CI_COMMIT_BRANCH'
      changes:
        - "!Dockerfile"
    # Optional: Uncomment below to run on first commit (no prior SHA to compare against)
    # - if: '$CI_PIPELINE_SOURCE == "push" && $CI_COMMIT_BEFORE_SHA == "0000000000000000000000000000000000000000"'

build_image:
  stage: build_image
  script:
    - echo "building image"
  rules:
    # Run this job ONLY when Dockerfile is modified
    - if: '$CI_COMMIT_BRANCH'
      changes:
        - Dockerfile

Breakdown: #

• For run_script: The !Dockerfile in changes excludes this job from running when only the Dockerfile is modified. The if: '$CI_COMMIT_BRANCH' ensures it only runs on branch pushes (adjust if you need it for tags/merge requests).
• The optional rule handles the first commit scenario (where there's no prior commit SHA to compare changes against) if you want run_script to run on initial repo setup.
• For build_image: The changes: [Dockerfile] ensures this job triggers only when the Dockerfile is modified.

Alternative Legacy Syntax (Using only/except) #

If you prefer a more concise (but less flexible) approach, you can use the older only/except keywords:

stages:
  - run_script
  - build_image

run_script:
  stage: run_script
  script:
    - echo "script is running"
  except:
    changes:
      - Dockerfile

build_image:
  stage: build_image
  script:
    - echo "building image"
  only:
    changes:
      - Dockerfile

Extra Notes: #

• If you have other files that should trigger the build_image job (like .dockerignore or build context files), just add them to the changes list, e.g., - Dockerfile - .dockerignore.
• Always double-check stage names match between your stages list and individual jobs—mismatches will cause jobs to fail to execute.

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