Praefect Rake tasks

{{< details >}}

• Tier: Free, Premium, Ultimate
• Offering: GitLab Self-Managed

{{< /details >}}

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:

  shellCopy

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

• Self-compiled installations:

  shellCopy

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

Check replicas for all projects

{{< history >}}

• Introduced in GitLab 18.10.

{{< /history >}}

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:

  shellCopy

  sudo gitlab-rake gitlab:praefect:replicas
  

• Self-compiled installations:

  shellCopy

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