手动创建GitLab Release时能否触发PRD部署流水线？

背景与流水线设计 #

我基于主干式架构为dev、qas、prd三个环境搭建GitLab流水线，默认分支为主干分支，流程设计如下：

• DEV：开发者推送代码至主干分支时，自动执行构建、测试并部署至DEV环境；
• QAS：通过GitLab标记版本tag，手动触发部署；
• PRD：仅允许特定成员操作，希望通过手动创建GitLab Release触发部署，同时保留发布历史与说明。

当前的.gitlab-ci.yml配置如下：

stages:
    - build
    - test
    - deployDEV
    - deployQAS
    - deployPRD

build: 
    stage: build 
    # build everything

test: 
    stage: test
    # test everything

deployDEV: 
    stage: deployDEV 
    rules: 
        - if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH' 
    script: 
       # deploy code to DEV 

deployQAS: 
    stage: deployQAS
    rules: 
       - if: '$CI_COMMIT_TAG && $CI_DEPLOY_FREEZE == null'
         when: manual
    script: 
      # deploy QAS 

deployPRD: 
    stage: deployPRD
    rules: 
      - if % new Release is created manually trigger this step % # currently not working
    script: 
      #deploy PRD

问题 #

手动创建GitLab Release时，无法触发PRD部署阶段的流水线。想确认这是GitLab的默认行为，还是遗漏了相关配置？目标是实现先在QAS验证版本后，通过创建对应版本的Release触发PRD部署。已查阅GitLab Release官方文档，未找到Release触发流水线的说明。

解决方案 #

1. 核心原因 #

GitLab手动创建Release默认不会触发新流水线——因为Release创建操作本身不会产生新的commit或tag（若基于已有tag创建Release，不会触发流水线；只有创建Release时同时生成新tag，才会触发tag流水线）。

2. 实现方式 #

方式一：关联Tag触发流水线（推荐）

修改deployPRD的规则，基于tag触发并添加权限控制：

deployPRD:
    stage: deployPRD
    rules:
        - if: '$CI_COMMIT_TAG'
          when: manual
    script:
        # deploy PRD
    # 权限控制：设置protected tags，仅特定用户/组可创建用于PRD发布的tag
    only:
        - tags
    environment:
        name: prd
        # 标记环境为protected，仅授权成员可部署
        protected: true

操作步骤：

• 创建Release时，选择「Create a new tag」，指定对应版本号；
• 此时会触发tag流水线，deployPRD阶段会变为手动触发状态，仅授权成员可执行部署。

方式二：通过Release Webhook触发流水线

在项目设置中配置Webhook，利用Release事件触发流水线：

1. 进入项目「Settings」→「Webhooks」；
2. 添加Webhook：
   • URL：填写项目的流水线触发地址（格式：https://<gitlab-domain>/api/v4/projects/<项目ID>/trigger/pipeline）；
   • 触发事件：勾选「Release events」；
   • 添加自定义token；
3. 修改deployPRD规则：

deployPRD:
    stage: deployPRD
    rules:
        - if: '$CI_PIPELINE_SOURCE == "webhook"'
          when: manual
    script:
        # deploy PRD
    environment:
        name: prd
        protected: true

此方式需确保Webhook仅在Release创建时触发，同时配合环境权限控制限制部署人员。

3. 权限控制补充 #

• Protected Tags：在项目「Settings」→「Repository」→「Protected tags」中，设置仅特定用户/组可创建用于PRD发布的tag（比如匹配v*格式的tag）；
• Protected Environments：在项目「Settings」→「CI/CD」→「Environments」中，将prd环境标记为protected，指定仅授权成员可部署至该环境。

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