1. 问题描述
配置 Webhook 自动触发执行 Jenkins 流水线时，报错：
|
|
2. Git 如何管理版本
Git 是一个内容寻址文件系统。Git 维护着一棵 sha tree ，通过 sha 值可以回溯到任何一个历史节点。先看看提交记录：执行命令：
|
|
可以发现，每次提交 git 都会生成一个 commitId ，也就是一个 sha 。commitId 后面紧跟的括号，说明了 commit 内容所属分支发生的变化。那么这些 (origin/master, origin/HEAD, fix_apiserver_devops) 又是什么含义呢？在 .git/refs/ 中，Git 存储着指向数据（分支）的提交对象的指针。
|
|
|
|
分支、标签在 Git 看来，就是指向 sha tree 某一个 sha 的指针。
3. 原因分析
Jenkins 或相关 Git 插件出错的概率较小，当然也可以检查一下 Git 的版本。控制变量法，首先在 Jenkins 外部执行发生错误的命令。
|
|
在了解 Git 的工作原理之后，大概就能分析出原因：人使用的是 branchName、tagName ，而 Git 使用的是 sha 。reference not a tree 意味着，触发和执行两个阶段 sha tree 发生了变化。触发时，branchName 对应的 sha，在执行阶段不存在。下面是结合其他人遇到的情景进行的一些可能分析：
- 分支名和标签名相同
分支和标签的差别在于，分支可以继续提交，而标签不能继续更改。两者同名时，会有一些怪异的行为，比如 branchName 消失等。
- rebase 导致
rebase 通常用于合并 upstream 的代码，也会用于将多个线性 commit 合并为一个。比如，下面的命令，将前 3 个版本的提交合并为 1 个：
|
|
这样会导致 commit 丢失，而丢失的 commit 可能正好触发了 Jenkins 的某个动作。
- PR 合并后，分支被删除
基于 特征开发，主干集成，分支发布 的思想，在持续集成的过程中，最佳实践的方式是当代码合并之后，随即删掉分支，Github 上打通了这个流程。特征分支触发 Jenkins 流水线之后，分支被删除，当执行到拉取代码时，也会报错。
- Subumodule
子仓库的 commit 记录发生了变化，在执行 git update 之类的操作时，也可能报错。
- 非最新代码
使用了缓存的代码，在旧代码上找不到最新的 commit 。由于在 Jenkins 实践的过程中，使用方式和场景存在差异，除非是必现的错误，排查问题需要围绕问题的关键，控制变量一步一步筛查。
4. 参考
- https://github.com/kubernetes/kubernetes/issues/27462
