Sauvegarde GitLab - Guide de Backup Complet

Créer une sauvegarde (Backup) de GitLab : Sécuriser vos données

Pourquoi la sauvegarde est-elle vitale ?

En informatique, il existe une règle d'or : une donnée qui n'est pas sauvegardée est une donnée qui n'existe pas. Que ce soit à cause d'une erreur humaine, d'une mise à jour qui tourne mal ou d'une panne matérielle, perdre l'intégralité de vos dépôts, de vos tickets et de votre configuration peut être une catastrophe pour votre équipe.

Heureusement, GitLab intègre un outil puissant qui permet de réaliser une sauvegarde complète de GitLab en une seule commande. Cette procédure regroupe la base de données, les dépôts Git et tous les fichiers attachés dans une seule archive compressée (.tar).

Lancer une sauvegarde manuelle du serveur

Pour effectuer cette opération, vous devez avoir un accès administrateur à votre serveur et utiliser la ligne de commande.

Créer l'archive complète

Utilisez l'outil intégré pour lancer le processus de sauvegarde globale du système :

sudo gitlab-backup create

Exclure des répertoires spécifiques

Sur de très gros serveurs, la sauvegarde peut prendre beaucoup de temps et d'espace disque. Vous pourriez vouloir ignorer certains éléments lourds comme les fichiers envoyés par les utilisateurs (uploads) ou la base de données.

Utilisez la variable d'environnement SKIP pour filtrer les données à sauvegarder :

sudo gitlab-backup create SKIP=db,uploads

Résultat attendu :

Dumping database ... [DONE]
Dumping repositories ...
 * group/project-alpha ... [DONE]
 * group/project-beta ... [DONE]
Dumping uploads ... [DONE]
Dumping builds ... [DONE]
Dumping artifacts ... [DONE]
Dumping pages ... [DONE]
Creating backup archive: 1713532481_2026_04_19_17.5.2_gitlab_backup.tar ... [DONE]

Où trouver votre fichier de sauvegarde ?

Une fois l'opération terminée, GitLab ne garde pas le fichier dans votre dossier actuel. Il le déplace automatiquement dans un répertoire de sauvegarde sécurisé.

Localiser l'archive .tar

Rendez-vous dans le dossier /var/opt/gitlab/backups pour voir vos fichiers :

cd /var/opt/gitlab/backups
ls -l

Attention : Compatibilité des versions

Une sauvegarde GitLab ne peut être restaurée que sur une instance exécutant exactement la même version de GitLab (ex: de 17.5.2 vers 17.5.2). Notez toujours votre version actuelle lors de l'archivage.

Liste des fichiers de sauvegarde dans le répertoire système

Sécurité des fichiers de configuration

Le fichier de sauvegarde ne contient pas les fichiers de configuration critiques (gitlab.rb et gitlab-secrets.json). Vous devez impérativement sauvegarder manuellement ces fichiers sensibles vers un endroit sûr, sinon votre restauration sera impossible.

Conclusion

Vous savez désormais comment sécuriser vos données GitLab contre les imprévus. Posséder une archive récente est la base d'un bon plan de reprise d'activité (PRA).

Savoir créer une archive est une chose, mais savoir l'utiliser en cas de crise en est une autre. Dans le prochain chapitre, nous allons voir comment restaurer une sauvegarde GitLab pour remettre votre serveur sur pied en quelques minutes.

Chapitre précédent