summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAndrew Winata <awinata@gitlab.com>2019-02-15 11:11:13 +0000
committerAndrew Winata <awinata@gitlab.com>2019-02-15 11:11:13 +0000
commitb9b80d6fec5ebddb96b804cfe68c3529d4b45f27 (patch)
treec364a9ba32a4c892b8865bb3d917f8423f3ef152
parent0b966fb0d95bb6e7070db50b4d1a64e3dddac1a4 (diff)
downloadgitlab-ce-docs-add-info-fatal-ref-error.tar.gz
docs update info on git fatal: reference is not tree errordocs-add-info-fatal-ref-error
-rw-r--r--doc/topics/git/troubleshooting_git.md15
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/topics/git/troubleshooting_git.md b/doc/topics/git/troubleshooting_git.md
index d1729d70158..98e0abae487 100644
--- a/doc/topics/git/troubleshooting_git.md
+++ b/doc/topics/git/troubleshooting_git.md
@@ -95,3 +95,18 @@ and provide GitLab with more information on how to improve the service.
[SSH troubleshooting]: ../../ssh/README.md#troubleshooting "SSH Troubleshooting"
[Broken-Pipe]: https://stackoverflow.com/questions/19120120/broken-pipe-when-pushing-to-git-repository/36971469#36971469 "StackOverflow: 'Broken pipe when pushing to Git repository'"
+
+## fatal: reference is not a tree error
+
+During a git action and you receive an error something like the following:
+
+```
+Cloning into `/tmp/build/get`...
+fatal: reference is not a tree: xxxxxxxxxx
+```
+
+This means git is referencing a git object that does not exist anymore.
+
+This most likely happened when you do a `git push` with `-f` or `--force` (force push) which could have removed the object in question from the repository. Force push is a destructive action and it might [overwrite refs](https://git-scm.com/docs/git-push#git-push--f)
+
+There are no silver bullet actions to solve this. If you still need the referenced object, you will need to retrieve them back from your local repository or your team local repo. You can read this [great article regarding how to deal with force push](https://evilmartians.com/chronicles/git-push---force-and-how-to-deal-with-it) \ No newline at end of file