GitLab CI/CD中rules:changes:compare_to动态变量失效问题排查

首先明确：你当前场景下无法使用动态变量（预定义CI/CD变量）作为compare_to的值，原因在于GitLab流水线的配置解析机制：

• include和rules关键字属于流水线的预解析阶段（初始化阶段），这个阶段GitLab还未完全初始化所有预定义变量，且changes:compare_to要求在解析时必须是一个明确的静态分支名/提交SHA，无法动态解析变量。
• 即使文档提到compare_to支持CI/CD变量，实际仅在作业执行阶段的部分场景生效，而非配置解析阶段的include或作业rules中。

替代实现方案 #

1. 针对include的条件加载需求 #

如果需要仅当ansible/或docker/目录变更时才加载.ci/container-images.yml，可以去掉compare_to，结合分支规则和默认变更检测：

# .gitlab-ci.yml
include:
  - local: .ci/container-images.yml
    rules:
      # 针对默认分支，检测当前提交与分支最新提交的变更
      - if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH'
        changes:
          - "ansible/**/*"
          - "docker/**/*"
      # 针对MR，检测当前分支与目标分支的变更
      - if: '$CI_MERGE_REQUEST_ID'
        changes:
          - "ansible/**/*"
          - "docker/**/*"

GitLab默认会在MR场景下对比源分支与目标分支的变更，在分支推送场景下对比当前提交与上一次流水线的提交，基本能满足需求。

2. 针对作业级别的变更检测需求 #

对于.ci/container-images.yml中需要对比$CI_COMMIT_BEFORE_SHA的场景，改用脚本手动检测变更，绕过rules:changes的限制：

# .ci/container-images.yml
"build-docker-$[[ inputs.image ]]":
  script:
    # 手动对比当前提交与上一次提交的指定目录变更
    - |
      BEFORE_SHA=${CI_COMMIT_BEFORE_SHA:-$CI_DEFAULT_BRANCH}
      if git diff --name-only $BEFORE_SHA $CI_COMMIT_SHA | grep -q "^${{ inputs.context }}/"; then
        # 这里替换为你的实际构建命令
        docker build -t $[[ inputs.image ]] $[[ inputs.context ]]
        docker push $[[ inputs.image ]]
      else
        echo "No changes detected in $[[ inputs.context ]], skipping build"
        exit 0
      fi
  rules:
    - if: '$CI_COMMIT_BRANCH || $CI_MERGE_REQUEST_ID'

这种方式的优势是完全在作业执行阶段处理，能正确解析所有预定义变量，且变更检测逻辑更灵活。

额外优化点 #

如果需要严格对比默认分支的最新状态，可在脚本中先拉取默认分支（需确保CI runner有Git权限）：

git fetch origin $CI_DEFAULT_BRANCH
git diff --name-only origin/$CI_DEFAULT_BRANCH $CI_COMMIT_SHA | grep -q "^${{ inputs.context }}/"

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