Comment empêcher les sauvegardes Immich de capturer un état incohérent

Eva Wong est la rédactrice technique et bricoleuse résidente chez ZimaSpace. Geek depuis toujours, passionnée par les laboratoires informatiques personnels et les logiciels open source, elle se spécialise dans la vulgarisation de concepts techniques complexes au moyen de guides pratiques et concrets. Eva pense que l’hébergement personnel doit être amusant, et non intimidant. À travers ses tutoriels, elle aide la communauté à démystifier les configurations matérielles, de la construction de leur premier NAS à la maîtrise des conteneurs Docker.

Évitez les sauvegardes Immich incohérentes en traitant la base de données et les médias comme une seule unité de récupération, dont l’ordre de capture et l’activité d’écriture sont délibérément contrôlés.

Une sauvegarde peut contenir tous les fichiers qu’elle devait copier et tout de même donner une mauvaise restauration si la base de données référence des ressources qui n’ont pas été capturées, ou si la copie des médias correspond à un autre instantané du catalogue. Définissez d’abord la limite de cohérence, choisissez une méthode à l’arrêt ou une méthode à chaud coordonnée, puis validez le résultat en isolation.

Définissez l’unité de récupération avant de planifier la sauvegarde

Répertoriez la base de données PostgreSQL, les médias téléversés, les données de profil, la configuration du déploiement, les valeurs d’environnement, les secrets et tous les chemins de stockage personnalisés nécessaires à la recréation du service. Distinguez les miniatures générées, les vidéos encodées et les fichiers de modèles, selon que votre politique de récupération prévoit de les protéger ou de les régénérer.

La comparaison de ZimaSpace entre les sauvegardes à chaud et à l’arrêt d’Immich explique le choix de base en matière de cohérence. Ce processus de prévention va un peu plus loin : quelle que soit la méthode choisie, elle doit produire un point documenté qui peut être restauré sans devoir deviner quelle base de données correspond à quelle copie des médias.

Indiquez l’ordre de restauration à côté du périmètre de la sauvegarde. Si le plan dit « restaurer les photos » sans préciser quel vidage de base de données, quelle configuration, quels identifiants et quels mappages de stockage reconnectent ces photos aux utilisateurs et aux albums, la définition de la sauvegarde est incomplète avant même le premier lancement planifié.

Choisissez une capture à l’arrêt si la solution la plus simple vous convient

Pour un petit foyer qui peut tolérer une courte période de maintenance, suspendez les téléversements et arrêtez les services de l’application qui écrivent dans l’état de la bibliothèque. Créez la sauvegarde de la base de données, capturez les médias et la configuration, puis ne redémarrez qu’une fois l’instantané ou la copie clairement horodaté et son achèvement confirmé.

Arrêter l’application ne rend pas automatiquement un mauvais chemin correct. Vérifiez que l’export de la base de données a réussi, que les racines de médias prévues ont été incluses et que la destination de sauvegarde est indépendante des données actives qu’elle est censée permettre de récupérer. Consignez les heures de début et de fin afin que les restaurations ultérieures puissent identifier la génération exacte.

La méthode est validée si aucune écriture de l’application n’a lieu pendant la capture et si un test de restauration retrouve les utilisateurs, le nombre de ressources, les albums et les originaux échantillonnés attendus. Si l’interruption dépasse régulièrement ce que le foyer peut tolérer, passez à une méthode à chaud coordonnée au lieu de laisser discrètement les téléversements reprendre à mi-chemin d’une copie de fichiers.

Pour les sauvegardes à chaud, capturez la base de données et les fichiers dans un ordre défini

Si Immich doit rester disponible, créez un vidage cohérent natif de la base de données plutôt que de copier le répertoire de données PostgreSQL actif sous forme de fichiers ordinaires. Capturez ensuite l’arborescence des médias ou créez-en un instantané dans l’ordre documenté, tout en suivant les téléversements qui arrivent pendant la fenêtre de sauvegarde.

Le processus pratique de sauvegarde de la base de données Immich présente l’approche tenant compte de la base de données. Les commandes et les noms de conteneurs peuvent varier selon le déploiement ; le principe à retenir est de demander à PostgreSQL une sauvegarde cohérente plutôt que de se fier à une copie récursive de fichiers de base de données en cours d’utilisation.

Privilégiez un ordre qui empêche la base de données restaurée de pointer vers des médias qui n’ont jamais été inclus dans la sauvegarde. Si la copie du système de fichiers contient des fichiers supplémentaires que la base de données ne connaît pas encore, il est plus sûr de les réconcilier que de gérer des enregistrements de base de données dont les originaux référencés sont absents. Documentez tout chargement qui chevauche cette limite.

Coordonnez les instantanés du système de fichiers avec des hooks de base de données au lieu de supposer qu’ils sont atomiques

Les instantanés du système de fichiers sont précieux parce qu’ils capturent rapidement un volume, mais ils ne garantissent pas à eux seuls la cohérence transactionnelle de deux systèmes qui évoluent indépendamment. Si la base de données et les médias se trouvent sur des jeux de données ou des appareils différents, définissez des hooks avant et après la capture instantanée et consignez leur chronologie dans le journal de sauvegarde.

Un exemple de 2026 associant un logiciel de sauvegarde à des hooks de capture instantanée Btrfs montre pourquoi l’orchestration des instantanés nécessite des limites explicites au niveau de l’application ou de la base de données. Inspirez-vous de cette approche pour coordonner les captures, mais ne copiez pas ses commandes de système de fichiers sans discernement sur une configuration différente.

Si l’outil de capture instantanée ne peut pas coordonner la base de données et les médias à un même instant, optez plutôt pour un dump logique de la base de données et une sauvegarde des médias au lieu de prétendre à une récupération atomique. La complexité n’est justifiée que si l’exercice de restauration prouve que la capture plus rapide restitue un état cohérent de l’application.

Intégrez les tests de restauration au calendrier des sauvegardes

La réussite d’une tâche de sauvegarde prouve uniquement que la capture est terminée. Sélectionnez périodiquement une génération récente, restaurez-la sous un nom d’hôte isolé, rattachez le stockage attendu et vérifiez les utilisateurs, des originaux représentatifs, les albums, les autorisations, le comportement de la recherche et une nouvelle sauvegarde de la base de données depuis l’instance restaurée.

La présentation de la récupération PostgreSQL dans le guide de planification des sauvegardes et restaurations PostgreSQL met l’accent sur la validation de la restauration et les objectifs de récupération, plutôt que de considérer la création d’un dump comme une fin en soi. Appliquez la même rigueur à l’unité de récupération Immich combinée.

Faites échouer la politique de sauvegarde si la restauration de la base de données réussit, mais que des fichiers manquent, si les médias s’ouvrent sans utilisateurs ni relations, ou si la récupération dépend d’un secret stocké uniquement sur l’hôte défaillant. Corrigez le périmètre, l’ordre, la rétention ou l’indépendance avant d’augmenter la fréquence des sauvegardes ; multiplier les copies incohérentes ne crée pas un point de récupération fiable.

Assistance et conseils

À lire aussi

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.