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 on which GitLab is installed and not on the node on which 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