diff options
Diffstat (limited to 'doc/administration/gitaly/praefect.md')
| -rw-r--r-- | doc/administration/gitaly/praefect.md | 21 |
1 files changed, 12 insertions, 9 deletions
diff --git a/doc/administration/gitaly/praefect.md b/doc/administration/gitaly/praefect.md index 6eefd0a7bb5..0297f295e6f 100644 --- a/doc/administration/gitaly/praefect.md +++ b/doc/administration/gitaly/praefect.md @@ -1133,15 +1133,15 @@ For more information on Gitaly server configuration, see our storage: [ { name: 'gitaly-1', - path: '/var/opt/gitlab/git-data', + path: '/var/opt/gitlab/git-data/repositories', }, { name: 'gitaly-2', - path: '/var/opt/gitlab/git-data', + path: '/var/opt/gitlab/git-data/repositories', }, { name: 'gitaly-3', - path: '/var/opt/gitlab/git-data', + path: '/var/opt/gitlab/git-data/repositories', }, ], } @@ -1337,7 +1337,7 @@ Particular attention should be shown to: 1. Check that the Praefect storage is configured to store new repositories: - 1. On the left sidebar, expand the top-most chevron (**{chevron-down}**). + 1. On the left sidebar, select **Search or go to**. 1. Select **Admin Area**. 1. On the left sidebar, select **Settings > Repository**. 1. Expand the **Repository storage** section. @@ -1498,9 +1498,12 @@ For a replication factor: > [Introduced](https://gitlab.com/gitlab-org/gitaly/-/issues/4080) in GitLab 15.0. Praefect stores metadata about the repositories in a database. If the repositories are modified on disk -without going through Praefect, the metadata can become inaccurate. Because the metadata is used for replication -and routing decisions, any inaccuracies may cause problems. Praefect contains a background worker that -periodically verifies the metadata against the actual state on the disks. The worker: +without going through Praefect, the metadata can become inaccurate. For example if a Gitaly node is +rebuilt, rather than being replaced with a new node, repository verification ensures this is detected. + +The metadata is used for replication and routing decisions, so any inaccuracies may cause problems. +Praefect contains a background worker that periodically verifies the metadata against the actual state on the disks. +The worker: 1. Picks up a batch of replicas to verify on healthy storages. The replicas are either unverified or have exceeded the configured verification interval. Replicas that have never been verified are prioritized, followed by @@ -1512,8 +1515,8 @@ periodically verifies the metadata against the actual state on the disks. The wo The worker acquires an exclusive verification lease on each of the replicas it is about to verify. This avoids multiple workers from verifying the same replica concurrently. The worker releases the leases when it has completed its check. -Praefect contains a background goroutine that releases stale leases every 10 seconds when workers are terminated for -some reason without releasing the lease. +If workers are terminated for some reason without releasing the lease, Praefect contains a background goroutine +that releases stale leases every 10 seconds. The worker logs each of the metadata removals prior to executing them. The `perform_deletions` key indicates whether the invalid metadata records are actually deleted or not. For example: |