BigW Consortium Gitlab

repository_checks.md 1.84 KB
Newer Older
1
# Repository checks
Jacob Vosmaer committed
2

3
>**Note:**
4 5
This feature was [introduced][ce-3232] in GitLab 8.7. It is OFF by
default because it still causes too many false alarms.
Jacob Vosmaer committed
6

7
Git has a built-in mechanism, [git fsck][git-fsck], to verify the
Chris Spicer committed
8
integrity of all data committed to a repository. GitLab administrators
9 10 11 12 13
can trigger such a check for a project via the project page under the
admin panel. The checks run asynchronously so it may take a few minutes
before the check result is visible on the project admin page. If the
checks failed you can see their output on the admin log page under
'repocheck.log'.
Jacob Vosmaer committed
14

15
## Periodic checks
Jacob Vosmaer committed
16

17
GitLab periodically runs a repository check on all project repositories and
Jacob Vosmaer committed
18 19
wiki repositories in order to detect data corruption problems. A
project will be checked no more than once per week. If any projects
20
fail their repository checks all GitLab administrators will receive an email
Jacob Vosmaer committed
21 22 23
notification of the situation. This notification is sent out no more
than once a day.

24 25
## Disabling periodic checks

26 27
You can disable the periodic checks on the 'Settings' page of the admin
panel.
Jacob Vosmaer committed
28 29 30

## What to do if a check failed

Jacob Vosmaer committed
31
If the repository check fails for some repository you should look up the error
Jacob Vosmaer committed
32 33 34
in repocheck.log (in the admin panel or on disk; see
`/var/log/gitlab/gitlab-rails` for Omnibus installations or
`/home/git/gitlab/log` for installations from source). Once you have
35
resolved the issue use the admin panel to trigger a new repository check on
Jacob Vosmaer committed
36 37
the project. This will clear the 'check failed' state.

38
If for some reason the periodic repository check caused a lot of false
39 40
alarms you can choose to clear ALL repository check states from the
'Settings' page of the admin panel.
Jacob Vosmaer committed
41 42 43

---
[ce-3232]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/3232 "Auto git fsck"
Chris Spicer committed
44
[git-fsck]: https://www.kernel.org/pub/software/scm/git/docs/git-fsck.html "git fsck documentation"