如何在GitLab合并请求中排除.gitlab-ci.yml并按分支配置CI任务？

一、让.gitlab-ci.yml在各分支保持独有，合并请求中排除该文件 #

你可以通过两种方式实现：

1. 使用.gitattributes设置合并策略
   在仓库根目录创建.gitattributes文件，添加以下内容：

   .gitlab-ci.yml merge=ours
   

   这个规则会让Git在合并时，始终保留当前分支的.gitlab-ci.yml版本，忽略来自其他分支的修改。需要确保所有协作成员拉取该文件后，本地仓库自动应用规则；若要强制远程仓库遵循，可配置GitLab预接收钩子，常规团队协作中配合合并请求审核即可。

2. GitLab项目设置限制文件修改
   在GitLab项目的「设置」→「仓库」→「保护分支」中，对master和stage分支开启保护；再到「设置」→「合并请求」→「合并请求规则」中，添加“不允许修改特定文件”的规则，将.gitlab-ci.yml加入受保护文件列表。这样任何包含该文件修改的合并请求都会被拦截。

二、通用.gitlab-ci.yml中分支条件不生效的解决方法 #

你之前的写法失效，大概率是变量使用或流水线触发场景的问题，以下是修正方案：

情况1：仅在直接push到stage分支时运行任务 #

使用rules时，给条件表达式加单引号避免YAML解析错误，确保变量正确：

runTests_job:
  stage: runTests
  tags:
    - ps
  rules:
    - if: '$CI_COMMIT_BRANCH == "stage"'
  script:
    - chcp 65001
    - Invoke-Sqlcmd -ConnectionString $CONNSTR -Query "EXEC dbo.test"

情况2：合并请求流水线中运行任务 #

如果流水线由合并请求触发（而非直接push分支），CI_COMMIT_BRANCH变量不会被设置，需改用合并请求专属变量：

• 目标分支为stage时运行：

  rules:
    - if: '$CI_MERGE_REQUEST_TARGET_BRANCH_NAME == "stage"'
  

• 源分支为stage时运行：

  rules:
    - if: '$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME == "stage"'
  

用only语法的正确写法 #

若偏好only，确保语法正确且覆盖触发场景：

runTests_job:
  stage: runTests
  tags:
    - ps
  only:
    refs:
      - stage  # 仅在直接push到stage分支时触发
      # 若需合并请求到stage时也触发，添加merge_requests并配合条件
      # - merge_requests
  # 合并请求场景下限制目标分支，可结合only: variables
  # variables:
  #   - $CI_MERGE_REQUEST_TARGET_BRANCH_NAME == "stage"
  script:
    - chcp 65001
    - Invoke-Sqlcmd -ConnectionString $CONNSTR -Query "EXEC dbo.test"

建议在GitLab流水线详情的「变量」页面查看变量实际值，确认CI_COMMIT_BRANCH或合并请求变量是否正确设置，快速定位问题。

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