diff options
| author | GitLab Bot <gitlab-bot@gitlab.com> | 2023-01-16 15:07:37 +0000 |
|---|---|---|
| committer | GitLab Bot <gitlab-bot@gitlab.com> | 2023-01-16 15:07:37 +0000 |
| commit | f0718f2099663226531b8916e14d5582eb28e453 (patch) | |
| tree | bd8f8e6ef6353b1ce066c43c0e19655ca3be62e6 /doc/raketasks | |
| parent | 6d4ce68742e8decbfca5a1b382ce260790e8c396 (diff) | |
| download | gitlab-ce-f0718f2099663226531b8916e14d5582eb28e453.tar.gz | |
Add latest changes from gitlab-org/gitlab@master
Diffstat (limited to 'doc/raketasks')
| -rw-r--r-- | doc/raketasks/backup_gitlab.md | 12 | ||||
| -rw-r--r-- | doc/raketasks/restore_gitlab.md | 2 |
2 files changed, 12 insertions, 2 deletions
diff --git a/doc/raketasks/backup_gitlab.md b/doc/raketasks/backup_gitlab.md index 350cf110878..771120df1c3 100644 --- a/doc/raketasks/backup_gitlab.md +++ b/doc/raketasks/backup_gitlab.md @@ -332,8 +332,16 @@ FLAG: On self-managed GitLab, by default this feature is available. To hide the feature, ask an administrator to [disable the feature flag](../administration/feature_flags.md) named `incremental_repository_backup`. On GitLab.com, this feature is not available. -Incremental backups can be faster than full backups because they only pack changes since the last backup into the backup -bundle for each repository. There must be an existing backup to create an incremental backup from: +NOTE: +Only repositories support incremental backups. Therefore, if you use `INCREMENTAL=yes`, the task +creates a self-contained backup tar archive. This is because all subtasks except repositories are +still creating full backups (they overwrite the existing full backup). +See [issue 19256](https://gitlab.com/gitlab-org/gitlab/-/issues/19256) for a feature request to +support incremental backups for all subtasks. + +Incremental repository backups can be faster than full repository backups because they only pack changes since the last backup into the backup bundle for each repository. +The incremental backup archives are not linked to each other: each archive is a self-contained backup of the instance. There must be an existing backup +to create an incremental backup from: - In GitLab 14.9 and 14.10, use the `BACKUP=<timestamp_of_backup>` option to choose the backup to use. The chosen previous backup is overwritten. - In GitLab 15.0 and later, use the `PREVIOUS_BACKUP=<timestamp_of_backup>` option to choose the backup to use. By default, a backup file is created diff --git a/doc/raketasks/restore_gitlab.md b/doc/raketasks/restore_gitlab.md index 61198a3d9ca..c97a71b1b5d 100644 --- a/doc/raketasks/restore_gitlab.md +++ b/doc/raketasks/restore_gitlab.md @@ -20,6 +20,8 @@ If your backup is a different version than the current installation, you must [downgrade](../update/package/downgrade.md) or [upgrade](../update/package/index.md#upgrade-to-a-specific-version-using-the-official-repositories) your GitLab installation before restoring the backup. +Each backup archive contains a full self-contained backup, including those created through the [incremental repository backup procedure](backup_gitlab.md#incremental-repository-backups). To restore an incremental repository backup, use the same instructions as restoring any other regular backup archive. + ## Restore prerequisites You need to have a working GitLab installation before you can perform a |