我在让 Jenkins 构建指定标签时遇到问题。该标签是参数化构建的一部分，但我不知道如何将其传递给 git 插件来构建该标签。这花了我一天的 3 个小时，我在 Stack Overflow 向大师们认输了。
【问题讨论】：
我找到了解决这个问题的最佳方法， 您应该使用 GitSCM 类而不是 git 类：
stages {
stage('SCM') {
steps {
script {
wrap([$class: 'BuildUser']) {
currentBuild.displayName = "#${BUILD_NUMBER} - ${env.BUILD_USER} --> Build from branch ${BRANCH}"
slackSend channel: "#jenkins-build", color: "#02fe21", message: "${JOB_NAME} started by ${env.BUILD_USER} : #${BUILD_NUMBER} --> Build from ${BRANCH} branch with ${TAG} TAG"
}
}
checkout(
changelog: false, poll: false, scm: [
$class : 'GitSCM',
branches : [
[name: "$BRANCH"],
],
userRemoteConfigs: [
[
url: "<YOUR-GIT-URL>/${REPOSITORY}.git", credentialsId: '<YOUR-CREDENTIAL>'
],
],
])
}
}
【讨论】：
在这里添加我的两分钱，因为我没有看到在 Jenkins 中使用“使用参数构建”选项的答案。
在这里，我使用 Jenkins CI 浏览器控制台进行项目 starwars_api，并且我能够直接使用带有值的“使用参数构建”进行构建 refs/tags/tag-name
【讨论】：
我将 Advanced->Refspec 字段设置为 refs/tags/[your tag name]。这似乎比 Refspec 的其他各种建议更简单，但对我来说效果很好。
2014 年 7 月 23 日更新 - 实际上，经过进一步测试，事实证明这并没有按预期工作。看来 HEAD 版本仍在检查中。请将此作为已接受的答案撤消。通过关注thread（3 月 30 日）中 gotgenes 的帖子，我最终得到了一个可行的解决方案。那篇文章中提到的不必要触发构建的问题对我来说不是问题，因为我的工作是由上游工作触发的，而不是轮询 SCM。
UPDATE APR-2018 - 请注意在 cmets 中这对一个人有效，并同意 Jenkins 文档。
【讨论】：
refs/tags/<tagname> 是 Jenkins 文档 说 应该使用的，它对我来说工作正常。也许该插件在最初发布时有问题，但是......截至 2018 年 4 月，这是正确答案。
refs/tags 前缀而只使用<tagname>。 YMMV，但是...对于我的目的来说它工作得很好。
如果您正在使用 Jenkins 管道并想要签出特定标签（例如：您构建的 TAG 参数），您可以执行以下操作：
stage('Checkout') {
steps {
checkout scm: [$class: 'GitSCM', userRemoteConfigs: [[url: 'YOUR_GIT_REPO_URL.git', credentialsId: 'YOUR_GIT_CREDENTIALS_ID' ]], branches: [[name: 'refs/tags/${TAG}']]], poll: false
}
}
【讨论】：
我做了这样的事情并且成功了：
Source Code Management
Git
Repositories
Advance
Name: ref
Refspec : +refs/tags/*:refs/remotes/origin/tags/*
Branches to build
Branch Specifier (blank for 'any') : v0.9.5.2
Jenkins 日志确认它是从标签中获取源代码
检查修订版0b4d6e810546663e931cccb45640583b596c24b9 (v0.9.5.2)
【讨论】：
refspec 是点击高级按钮的诀窍。
您甚至可以使用通配符构建标签类型，例如1.2.3-alpha43：
参考规范： +refs/tags/*:refs/remotes/origin/tags/*
分支说明符： origin/tags/1.2.3-alpha*
您也可以勾选“当更改推送到 GitHub 时构建”以触发推送，但您必须在 webhook 中添加 “create” 操作 p>
【讨论】：
在最新的 Jenkins（1.639 及更高版本）中，您可以：
【讨论】：
1.0.1）来构建字段。
我最后做的是：
jenkins-target，并让 jenkins 跟踪它jenkins-target
jenkins-target 分支创建一个标签我不确定这是否适用于所有人，我的项目很小，没有太多标签和东西，但它很容易做到，不必乱用 refspecs 和参数和东西 :-)
【讨论】：
使用 Jenkins CI v.1.555、Git Client 插件 v.1.6.4 和 Git 插件 2.0.4，这些答案对我来说都不够。
我想要一份为一个特定的、固定的（即非参数化的）标签构建一个 Git 存储库的工作。我不得不从各种答案以及"build a Git tag" blog post cited by Thilo 中拼凑出一个解决方案。
git push --tags 将标签推送到远程存储库
+refs/tags/*:refs/remotes/origin/tags/*
*/tags/<TAG_TO_BUILD>（将 <TAG_TO_BUILD> 替换为您的实际标签名称）。事实证明，为我添加 Refspec 至关重要。尽管当我将其留空时，git 存储库似乎默认获取所有远程信息，但 Git 插件仍然无法找到我的标签。只有当我在 Refspec 字段中明确指定“获取远程标签”时，Git 插件才能识别并从我的标签构建。
2014 年 5 月 7 日更新：不幸的是，这个解决方案确实对 Jenkins CI (v.1.555) 和 Git 存储库推送通知机制带来了不良副作用，就像 Stash Webhook to Jenkins：每当存储库上的 any 分支在推送中更新时，标签构建作业也将再次触发。这会导致很多不必要的重复构建相同的标签作业。我尝试使用和不使用“使用工作区强制轮询”选项来配置作业，但它似乎没有效果。我可以阻止 Jenkins 为标记作业进行不必要的构建的唯一方法是清除 Refspec 字段（即删除 +refs/tags/*:refs/remotes/origin/tags/*）。
如果有人找到更优雅的解决方案，请通过更新编辑此答案。例如，我怀疑如果 refspec 具体是 +refs/tags/<TAG TO BUILD>:refs/remotes/origin/tags/<TAG TO BUILD> 而不是星号包罗万象，这可能不会发生。不过，目前这个解决方案对我们有用，我们只需在作业成功后删除额外的 Refspec。
【讨论】：
+refs/heads/*:refs/remotes/origin/*，现在将是 +refs/heads/*:refs/remotes/origin/* +refs/tags/*:refs/remotes/origin/tags/*。 （我没有经常使用 refspecs，所以需要进行一些实验才能了解到这个字段是用空格分隔的。）
你不能告诉 Jenkins 从 Ref 名称构建吗？如果是这样，那就是
refs/tags/tag-name
从我看到的所有关于 Jenkins 和 Hudson 的问题来看，我建议切换到 TeamCity。我无需编辑任何配置文件即可让 TeamCity 工作。
【讨论】：
git push --tags专门将该标签推送到远程仓库吗？
我可以通过使用“要构建的分支”参数来做到这一点：
Branch Specifier (blank for default): tags/[tag-name]
将 [tag-name] 替换为您的标签名称。
【讨论】：
HEAD 的版本。 git 插件的逻辑似乎比较了这两个版本，在我的存储库中，它们总是不相等，因此总是会触发新的构建。
通过将 Refspec 和 Branch Specifier 设置为 detailed in this blog post，我能够让 Jenkins 构建标签。
我还必须设置存储库名称（在我的情况下为“来源”），以便我可以在 Refspec 中引用它（否则它显然会使用随机生成的名称）。
【讨论】：