如何修改Jenkins声明式多分支流水线的检出行为？

• 调整Jenkins Git插件全局配置
  进入Jenkins全局配置页面，找到Git插件的设置项，查看是否有“拉取标签”相关的全局开关，勾选后就能覆盖默认的--no-tags参数。如果全局配置里没有这个选项，再去项目级配置里找对应的设置。

• 在流水线脚本中强制指定拉取标签
  既然是声明式多分支流水线，可以直接在stage的checkout步骤里自定义git拉取参数，覆盖插件默认的命令。示例代码如下：

  stage('Checkout') {
      steps {
          checkout scm: [$class: 'GitSCM',
                          userRemoteConfigs: [[url: '你的Gitea仓库地址']],
                          branches: [[name: '*/main']],
                          extensions: [[$class: 'CloneOption', noTags: false, shallow: false],
                                      [$class: 'FetchOption', fetchTags: true]]]
      }
  }
  

  这里通过CloneOption设置noTags: false、FetchOption设置fetchTags: true，强制开启标签拉取，会直接替换掉默认的--no-tags参数。

• 检查Gitea插件的分支源配置
  进入Jenkins多分支流水线项目的配置页面，找到“分支源”下的Gitea配置项，看看有没有隐藏的“拉取标签”开关。部分版本的Gitea插件会把这个选项放在分支源设置里，开启即可生效。

• 修改Git插件默认行为（不推荐）
  如果以上方法都无效，也可以尝试修改Jenkins Git插件的源码或配置文件，但这种方式需要重启Jenkins，而且插件升级后修改会失效，只建议作为最后手段使用。

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