Sauvegarder et restaurer une instance GitLab

Procédure pour sauvegarder les données et la configuration d'une instance GitLab et les restaurer en cas de besoin. Compatible avec les installation sous Docker.

1. Sur l'hôte ou dans le conteneur hébergeant GitLab, générer un backup :

   gitlab-backup create

2. Récupérer l'archive obtenue dans /var/opt/gitlab/backup

1. Installer une nouvelle instance vierge de GitLab sur la machine cible
2. Copier l'archive contenant la sauvegarde dans /var/opt/gitlab/backup
3. Stopper les services suivants :

   docker exec -it gitlab gitlab-ctl stop unicorn

   docker exec -it gitlab gitlab-ctl stop sidekiq

4. Modifier les permissions de l'archive :

   chown gitlab:gitlab /var/opt/gitlab/backups/1772568331_2026_03_03_18.8.5_gitlab_backup.tar

5. Lancer la restauration :

   docker exec -it gitlab gitlab-backup restore BACKUP=1772568331_2026_03_03_18.8.5

   Indiquer le nom de l'archive avant le _gitlab

6. Tester la connexion à Gitlab avec les identifiants de l'ancienne instance, c'est fonctionnel !