Document `gitlab:backup:` rake tasks for Omnibus users <12.2
GitLab Backup and Restore documentation was updated to replace gitlab:backup:create
and gitlab:backup:restore
with gitlab-backup
command equivalent for all Omnibus users.
Problems:
- Omnibus <12.2 users will see
gitlab-backup: command not found
when issuinggitlab-backup
commands - without documentation of the
gitlab:backup:create
andgitlab:backup:restore
rake tasks in Omnibus <12.2, users will have difficulty discovering/using the Omnibus-includedgitlab:backup:create/restore
rake tasks. - this blocks Support's ability to point customers using Omnibus <12.2 to working backup/restore instructions.
This is particularly concerning as the inclusion of gitlab-backup
is slated for 12.2 milestone which will not be released until Aug 22nd. Until then, our backup/restore documentation will be inaccurate and error-prone for all Omnibus users.
https://docs.gitlab.com/ce/raketasks/backup_restore.html
One potential solution would be to suggest two command options for Omnibus users in each situation - one for 12.2+ and one for "legacy" users. Example
If you're using Omnibus 12.2 or newer, use
`gitlab-backup create`
If you're using Omnibus 12.1 or older, use
`gitlab-rake gitlab:backup:create`
This change was introduced here https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/31555/diffs as part of omnibus-gitlab!3447 (merged)