Merge branch 'sh-document-stop-sidekiq-puma-backup-restore' into 'master'

Add warning to stop Puma and Sidekiq when restoring from backup

See merge request gitlab-org/gitlab!40791

changelogs/unreleased/sh-document-stop-sidekiq-puma-backup-restore.yml

+---
+title: Add warning to stop Puma and Sidekiq when restoring from backup
+merge_request: 40791
+author:
+type: other

lib/tasks/gitlab/backup.rake

@@ -47,6 +47,11 @@ namespace :gitlab do
         begin
           unless ENV['force'] == 'yes'
             warning = <<-MSG.strip_heredoc
+              Be sure to stop Puma, Sidekiq, and any other process that
+              connects to the database before proceeding. For Omnibus
+              installs, see the following link for more information:
+              https://docs.gitlab.com/ee/raketasks/backup_restore.html#restore-for-omnibus-gitlab-installations
+
               Before restoring the database, we will remove all existing
               tables to avoid future upgrade problems. Be aware that if you have
               custom tables in the GitLab database these tables and all data will be