转载

Jenkins 中 Git 操作 not a tree 分析与解决

配置 Webhook 自动触发执行 Jenkins 流水线时，报错：

hudson.plugins.git.GitException: Command "git checkout -f 23b446ea" returned status code 128:
stdout: 
stderr: fatal: reference is not a tree: 23b446ea

2. Git 如何管理版本

Git 是一个内容寻址文件系统。Git 维护着一棵 sha tree ，通过 sha 值可以回溯到任何一个历史节点。先看看提交记录：

执行命令：

git log

commit e5562ec75fedf0bd66fe752e686db108cf20cf9b (HEAD -> fix_create_pipeline, origin/fix_create_pipeline)
Date:   Thu May 14 15:31:50 2020 +0800

    fix create pipeline error

commit 1bd660c370aca1113ae0b4fa2e814e9ea337e4d7
Date:   Thu May 14 13:22:30 2020 +0800

    fix proxy bug (#2070)

commit 1464ca197d161b2ed693c7e9a053fcc97e0fdbaa (origin/master, origin/HEAD, fix_apiserver_devops)
Merge: 1d48ca34 250dd4b0
Date:   Wed May 13 17:24:31 2020 +0800

    Merge pull request #2057 from 

    fix bug of pvc api

可以发现，每次提交 git 都会生成一个 commitId ，也就是一个 sha 。commitId 后面紧跟的括号，说明了 commit 内容所属分支发生的变化。

那么这些 (origin/master, origin/HEAD, fix_apiserver_devops) 又是什么含义呢？

在 .git/refs/ 中，Git 存储着指向数据（分支）的提交对象的指针。

tree .git/refs/

.git/refs/
├── heads
│   ├── feature_add_pipeline_api
│   ├── fix_apiserver_devops
│   ├── fix_create_devops
│   ├── fix_create_pipeline
│   ├── master
│   └── release-2.1
├── remotes
│   ├── origin
│   │   ├── HEAD
│   │   ├── feature_add_pipeline_api
│   │   ├── fix_create_devops
│   │   ├── fix_create_pipeline
│   │   ├── fix_devops
│   │   └── master
│   └── upstream
│       ├── master
│       └── release-2.1
└── tags

cat .git/refs/heads/feature_add_pipeline_api

f0749ac442ef683a2de6ed3fdc8e3e3b44b71076

分支、标签在 Git 看来，就是指向 sha tree 某一个 sha 的指针。

3. 原因分析

Jenkins 或相关 Git 插件出错的概率较小，当然也可以检查一下 Git 的版本。控制变量法，首先在 Jenkins 外部执行发生错误的命令。

git checkout -f 23b446ea

在了解 Git 的工作原理之后，大概就能分析出原因：人使用的是 branchName、tagName ，而 Git 使用的是 sha 。 reference not a tree 意味着，触发和执行两个阶段 sha tree 发生了变化。触发时，branchName 对应的 sha，在执行阶段不存在。下面是结合其他人遇到的情景进行的一些可能分析：