GitLab：如何为流水线运行加描述或标签，在UI中明确部署环境？

针对你提出的需求——让用户无需自行推断，直接在GitLab UI看到流水线对应的部署环境，以下是几种实用方案：

方案1：利用GitLab环境（Environment）原生展示标签 #

这是最简便的原生方案，GitLab会自动在流水线列表和详情页显示关联的环境标签，和你示例图中的效果一致。只需在.gitlab-ci.yml中给部署作业指定environment字段：

deploy_staging:
  stage: deploy
  rules:
    - if: $CI_PIPELINE_SOURCE == 'merge_request_event'
  environment:
    name: staging
  script:
    - # 写入你的staging环境部署脚本

deploy_production:
  stage: deploy
  rules:
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
  environment:
    name: production
  script:
    - # 写入你的production环境部署脚本

配置完成后，合并请求流水线的ID旁会自动显示staging标签，master分支的流水线会显示production标签，完全满足需求。

方案2：设置流水线描述（Pipeline Description） #

如果需要更直白的文字说明（比如“部署至staging环境”），可以通过GitLab API动态设置流水线描述：

1. 先在项目的设置→CI/CD→变量中创建一个名为GITLAB_API_TOKEN的变量，权限选择api，值为具有项目API访问权限的个人令牌。
2. 在.gitlab-ci.yml中添加如下配置：

workflow:
  rules:
    - if: $CI_PIPELINE_SOURCE == 'merge_request_event'
      variables:
        DEPLOY_ENV: staging
        PIPELINE_DESC: "部署至 $DEPLOY_ENV 环境"
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
      variables:
        DEPLOY_ENV: production
        PIPELINE_DESC: "部署至 $DEPLOY_ENV 环境"

set_pipeline_description:
  stage: .pre
  script:
    - |
      curl --request PUT --header "PRIVATE-TOKEN: $GITLAB_API_TOKEN" \
        "$CI_API_V4_URL/projects/$CI_PROJECT_ID/pipelines/$CI_PIPELINE_ID" \
        --form "description=$PIPELINE_DESC"

这样流水线列表中会直接显示设置的描述文字，用户一眼就能看到部署目标环境。

方案3：添加自定义流水线标签（可选） #

如果需要和latest类似的醒目标签，还可以通过API给流水线添加自定义标签：

add_deploy_tag:
  stage: .pre
  rules:
    - if: $CI_PIPELINE_SOURCE == 'merge_request_event'
      variables:
        DEPLOY_TAG: staging-deploy
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
      variables:
        DEPLOY_TAG: prod-deploy
  script:
    - |
      curl --request POST --header "PRIVATE-TOKEN: $GITLAB_API_TOKEN" \
        "$CI_API_V4_URL/projects/$CI_PROJECT_ID/pipelines/$CI_PIPELINE_ID/tags" \
        --form "name=$DEPLOY_TAG"

标签会显示在流水线卡片的标签区域，和latest并列，进一步强化环境标识。

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