Praefect Rake tasks

Rake tasks are available for projects that have been created on Praefect storage. See the Praefect documentation for information on configuring Praefect.

Replica checksums

gitlab:praefect:replicas prints out checksums of the repository on:

• The primary Gitaly node.
• Secondary internal Gitaly nodes.

You can check replicas for a specific project or for all projects.

Run this Rake task on the node that GitLab is installed and not on the node that Praefect is installed.

Check replicas for a specific project

• Linux package installations:

  sudo gitlab-rake "gitlab:praefect:replicas[project_id]"

• Self-compiled installations:

  sudo -u git -H bundle exec rake "gitlab:praefect:replicas[project_id]" RAILS_ENV=production

Check replicas for all projects

Checking replicas for all projects can be resource-intensive on large GitLab instances with thousands of projects because each project requires external calls to Gitaly services. Consider running this task during off-peak hours or on a schedule that doesn’t impact production performance.

• Linux package installations:

  sudo gitlab-rake gitlab:praefect:replicas

• Self-compiled installations:

  sudo -u git -H bundle exec rake gitlab:praefect:replicas RAILS_ENV=production