GitLab CI构建容器Job：如何限定仅在指定分支运行？

你可以通过在规则中同时指定目标分支和文件变更条件，实现仅在特定分支且Dockerfile修改时触发任务。

方法一：使用only结合分支与changes #

以指定main和develop分支为例，修改后的配置如下：

build_container:
    stage: build
    # 保留你原有的其他配置
    only:
      refs:
        - main
        - develop
      changes:
        - Dockerfile

该配置要求同时满足两个条件才会触发任务：

1. 当前运行任务的分支是main或develop
2. 本次提交中Dockerfile文件存在变更

方法二：使用rules（GitLab推荐写法） #

如果需要更灵活的分支判断逻辑，可使用rules替代only，示例如下：

build_container:
    stage: build
    # 保留你原有的其他配置
    rules:
      - if: '$CI_COMMIT_BRANCH == "main" || $CI_COMMIT_BRANCH == "develop"'
        changes:
          - Dockerfile
        when: always

rules支持通过CI变量（如$CI_COMMIT_BRANCH）编写分支判断逻辑，更适配多分支或复杂条件场景。

补充说明 #

新建指定分支时，若该分支初始Dockerfile与上游分支一致，GitLab CI不会检测到文件变更，因此不会触发任务；只有当你在该分支上修改Dockerfile后，任务才会被触发。

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