如何为GitLab中运行的流水线添加标签？

当你在主分支运行多个不同配置的夜间定时流水线时，添加自定义标签确实是区分它们的绝佳方式——毕竟默认显示的提交信息、流水线编号这些内容，除了编号几乎没差别，太容易搞混了。下面是具体的实现方案：

方法1：通过CI配置直接定义流水线标签 #

你可以在.gitlab-ci.yml里为不同配置的流水线绑定专属标签，触发后标签会直接显示在流水线列表中，一目了然。

针对你的场景示例：区分MAIN和HEADs流水线 #

假设你有两个定时触发的流水线需求：

• MAIN流水线：子模块固定在特定SHA值
• HEADs流水线：拉取所有子模块的最新HEAD版本

可以在CI配置里这样编写：

# MAIN流水线专属作业
main-nightly-pipeline:
  only:
    - schedules
    variables:
      - $PIPELINE_TAG == "MAIN"
  tags:
    - MAIN
  script:
    - # 执行MAIN流水线逻辑：拉取固定SHA的子模块
    - git submodule update --init --recursive --reference ./submodules
    - # 后续构建、测试等命令

# HEADs流水线专属作业
heads-nightly-pipeline:
  only:
    - schedules
    variables:
      - $PIPELINE_TAG == "HEADs"
  tags:
    - HEADs
  script:
    - # 执行HEADs流水线逻辑：拉取子模块最新版本
    - git submodule update --init --recursive --remote
    - # 后续构建、测试等命令

接着在GitLab的定时流水线设置中创建两个定时任务：

• 第一个定时任务添加变量PIPELINE_TAG=MAIN
• 第二个定时任务添加变量PIPELINE_TAG=HEADs

触发后，流水线列表里就会直接显示MAIN或HEADs标签，再也不用靠流水线编号区分了。

方法2：通过API动态添加标签（适配已运行流水线） #

如果流水线已经启动，或者需要更灵活的标签管理，也可以用GitLab API给流水线打标签：

# 替换为你的GitLab实例地址、项目ID、流水线ID和目标标签
curl --request POST --header "PRIVATE-TOKEN: <你的访问令牌>" \
"https://你的gitlab地址/api/v4/projects/<项目ID>/pipelines/<流水线ID>/tags?tag=MAIN"

你可以把这个API调用加到流水线的初始化作业里，让流水线启动后自动给自己打标签，完全自动化。

额外小技巧：强化区分度 #

除了标签，你还可以在定时任务的描述里写上对应的标签名称，或者在CI作业里设置明确的stage名称，双重强化流水线的辨识度，彻底避免混淆。

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