Comment restaurer Immich après l’échec d’une mise à jour du conteneur

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.

Restaurez Immich après l’échec d’une mise à jour de conteneur en préservant les éléments de preuve disponibles, en épinglant chaque service Immich à la dernière version connue comme fonctionnelle et en restaurant les données uniquement si une restauration coordonnée ne permet pas de démarrer la pile.

Une mise à jour peut modifier simultanément le code de l’application, les attentes relatives au schéma de la base de données, les variables d’environnement et les versions des services associés. Télécharger plusieurs fois la dernière version ou mélanger d’anciens et de nouveaux conteneurs rend la limite de récupération plus difficile à repérer. Avant d’agir, sauvegardez le fichier Compose, l’environnement, les journaux, la base de données et les chemins des fichiers téléversés, puis choisissez entre la restauration d’une image et celle complète de la base de données et de la bibliothèque.

Gelez l’état défaillant et déterminez à quel moment la mise à jour a eu lieu

Désactivez les redémarrages automatiques et notez les images exactes ou les empreintes de version du serveur, du service d’apprentissage automatique, de la base de données et du cache. Enregistrez les journaux de démarrage et les fichiers de déploiement avant tout nouveau téléchargement. La vérification est réussie si vous pouvez nommer les éléments qui ont changé ; en cas d’échec, suspendez la récupération jusqu’à ce que les anciennes versions puissent être identifiées dans l’historique de déploiement ou parmi les images locales.

Vérifiez si le serveur s’arrête avant de se connecter à la base de données, pendant une migration ou après être devenu opérationnel. Une erreur de connexion à une dépendance indique qu’il faut réparer le réseau, les identifiants ou l’état de santé ; une erreur de migration accroît le risque lié à la restauration de la seule image de l’application, car la base de données a peut-être déjà été modifiée.

Un guide pas à pas sur les mises à jour d’Immich par version montre pourquoi la limite entre les versions et les fichiers de déploiement sont importants. Utilisez-le pour dresser l’inventaire de la transition, en vous fiant à vos propres journaux et sauvegardes pour la restauration.

Essayez d’abord une restauration complète des images à la dernière version connue comme fonctionnelle

Épinglez toutes les images de l’application Immich à la dernière version qui fonctionnait, au lieu de ne modifier qu’un seul service. Recréez les conteneurs concernés sans toucher aux volumes persistants. Si la pile fonctionne correctement et que les journaux ne signalent aucune incompatibilité de schéma, cette restauration avec peu de changements est réussie.

Si l’ancien serveur refuse le schéma actuel de la base de données, arrêtez-vous. Ne faites pas alterner différentes versions sur la même base de données et ne modifiez pas manuellement les tables de migration. Cet échec signifie que la mise à jour a franchi une frontière de données et que la récupération doit s’appuyer sur une sauvegarde de la base de données dont l’horodatage correspond à la version de l’application sélectionnée.

Un rapport sur Immich v1.135.3 décrit un échec précis du démarrage après une mise à jour, dû à la migration de la base de données. Son exemple de migration limitée justifie de lire attentivement la première erreur fatale ; il ne permet pas de copier les commandes de ce cas dans une autre version.

Restaurer la base de données et les médias uniquement si le retour arrière ne permet pas de récupérer

Créez une copie de sécurité ou un instantané du stockage de l’état en échec avant la restauration. Préparez une cible de récupération propre, restaurez la sauvegarde de la base de données, puis rendez accessible la bibliothèque d’envois correspondante et les fichiers de déploiement nécessaires. N’écrasez pas l’unique bibliothèque actuelle avec une copie plus ancienne simplement pour faire correspondre les horodatages.

Les enregistrements de la base de données et les fichiers des ressources doivent décrire la même collection. Si la sauvegarde précède les envois récents, conservez séparément ces fichiers plus récents pour les réconcilier ultérieurement. La restauration est réussie lorsque les migrations se terminent, que les utilisateurs et ressources attendus apparaissent et que les originaux vérifiés s’ouvrent sans erreurs généralisées de fichiers manquants.

Le guide de migration d’Immich de ZimaSpace fournit un inventaire utile pour déplacer les composants persistants sans confondre une image de conteneur avec la photothèque elle-même.

Valider la récupération avant de retenter la mise à jour

Testez la connexion, la navigation dans la chronologie, le téléchargement des originaux, la génération des vignettes, la recherche intelligente, le traitement des visages, l’envoi d’un nouveau fichier et une sauvegarde de la base de données. Redémarrez les conteneurs et l’hôte une fois. La validation est réussie si les mêmes ressources et fonctions sont disponibles après le redémarrage, sans erreurs répétées de migration ou d’autorisation.

Gardez les états en échec et récupéré étiquetés séparément jusqu’à la fin de la validation. Si la récupération dépend d’une version antérieure, désactivez le téléchargement automatique des images et consignez la version épinglée. Ne retentez la mise à jour qu’après avoir examiné chaque version intermédiaire et effectué une nouvelle sauvegarde coordonnée.

Revenez à la cible de récupération conservée si un nouvel envoi disparaît, si les originaux ne s’ouvrent pas ou si des tâches plantent à répétition. Faites remonter le problème avec les versions source et cible, les condensats des images, le premier journal d’erreur fatale, l’horodatage de la sauvegarde de la base de données et la correspondance des stockages ; ne retirez jamais la dernière copie connue comme fonctionnelle tant que la compatibilité de la mise à jour n’est pas établie.

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.