如何在Jenkins Pipeline中针对Git标签提交条件执行阶段？

你目前的Jenkins Pipeline是通过判断分支来触发发布阶段的：

stage("Publish to Docker Registry") { 
  when { 
    anyOf { 
      branch "release"; 
      branch "prerelease" 
    } 
  } 
  // ... 你的发布逻辑
}

现在想改成只要是带Git标签的提交就触发这个发布阶段，但翻了Jenkins官方的when语法文档没找到相关说明，好奇能不能实现对吧？

当然可以！Jenkins Pipeline其实提供了专门针对标签判断的条件，只是可能你没留意到，下面给你两种常用的实现方案：

方案一：直接使用tag条件（推荐） #

Jenkins的when块原生支持tag条件，既可以匹配所有标签，也能指定标签的匹配模式：

匹配任意标签 #

如果只要是带标签的提交就执行发布，写法非常简洁：

stage("Publish to Docker Registry") { 
  when { 
    tag "*"  // 星号通配符匹配任意标签
  } 
  // ... 你的发布逻辑
}

匹配特定规则的标签 #

要是你只想触发符合特定格式的标签（比如语义化版本标签v1.0.0、v2.3.1-beta这类），可以用通配符或者正则表达式：

// 匹配所有以v开头的标签，比如v0.1.0、v3.2.0-rc1
stage("Publish to Docker Registry") { 
  when { 
    tag "v*" 
  } 
  // ... 发布逻辑
}

// 用正则匹配标准语义化版本标签
stage("Publish to Docker Registry") { 
  when { 
    tag pattern: "^v\\d+\\.\\d+\\.\\d+(-.*)?$", comparator: "REGEXP"
  } 
  // ... 发布逻辑
}

方案二：通过环境变量判断 #

当Jenkins触发标签构建时，会自动设置TAG_NAME环境变量，你也可以通过判断这个变量是否存在来实现需求：

stage("Publish to Docker Registry") { 
  when { 
    expression { 
      env.TAG_NAME?.trim() // 只要TAG_NAME存在且非空就满足条件
    } 
  } 
  // ... 你的发布逻辑
}

这种方式适合需要做更复杂判断的场景，比如结合标签内容做额外的逻辑校验。

额外注意事项 #

• 要确保你的Jenkins项目配置允许标签触发构建：在项目的"Build triggers"部分，勾选对应源码管理工具的"Tag push events"选项（比如GitHub、GitLab都有这个配置）。
• 如果是手动触发标签构建，也要确认Jenkins能正确识别到标签的元数据。

这样就能完美实现你想要的“针对任何带标签的Git提交执行发布阶段”的需求啦！

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