Comment revenir en toute sécurité à une version antérieure d’Immich après une mise à jour incompatible

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.

Ne revenez à une ancienne version d’Immich qu’après avoir préservé l’état actuel et déterminé si la nouvelle version a modifié la base de données ou la configuration d’une manière que l’ancienne image ne peut pas lire.

Une image de conteneur peut être remplacée, mais son état persistant a peut-être déjà été migré. Si une mise à niveau se passe mal, arrêtez les mises à jour automatiques et les nouvelles écritures, notez les deux versions, protégez la base de données et les médias actuels, puis choisissez entre un simple retour à une image précédente et la restauration du point de récupération antérieur à la mise à niveau.

Gelez la mise à niveau défaillante avant qu’elle ne modifie davantage l’état du système

Désactivez les mises à jour automatiques des images et empêchez les clients d’ajouter de nouvelles photos pendant la collecte des éléments nécessaires. Notez les versions ou les condensats exacts des anciennes et nouvelles images Immich, la version de PostgreSQL, les fichiers Compose et d’environnement, les chemins de montage, ainsi que la première erreur de démarrage ou de migration.

Le guide ZimaSpace sur les limites du retour en arrière des conteneurs établit une distinction essentielle : les volumes persistants survivent au remplacement de l’image, mais cela n’est sûr que si l’ancienne application reste compatible avec les données qu’ils contiennent.

Effectuez une sauvegarde de la base de données avec un outil natif si la base de données est lisible, et conservez séparément la sauvegarde antérieure à la mise à niveau. N’écrasez ni l’une ni l’autre avec des essais répétés. La copie actuelle pourra être nécessaire pour avancer ultérieurement, même si l’objectif immédiat est de revenir à l’ancienne version.

Déterminez si la version a franchi une étape de migration de la base de données

Examinez le premier échec survenu après la mise à niveau et déterminez s’il se produit avant ou pendant la migration de la base de données, après la migration au démarrage de l’application, ou uniquement lors d’une opération utilisateur. Ce moment détermine le plan de retour en arrière, car une ancienne image peut ne pas reconnaître un schéma déjà modifié par la nouvelle version.

Un récent signalement concernant Immich, où le service a échoué après un parcours de mise à niveau, montre pourquoi des chemins de migration non pris en charge ou ignorés peuvent rendre peu fiable un simple changement de version. Considérez ce fil comme une étude de cas et vérifiez la séquence exacte de migration correspondant à vos versions.

Si la nouvelle application n’a jamais touché à la base de données et que le problème se limite à la compatibilité de l’image ou de l’environnement d’exécution, revenir à une image épinglée peut suffire. Si les migrations ont été effectuées, considérez que la sauvegarde de la base de données antérieure à la mise à niveau est le partenaire le plus sûr pour l’ancienne image, à moins de disposer de preuves explicites de compatibilité.

Restaurez une base de données et un environnement d’exécution compatibles au lieu de mélanger les versions

Construisez le point de retour à partir de la dernière version fonctionnelle connue de l’application, de sa configuration de déploiement compatible et du point de récupération de la base de données antérieur à la modification incompatible. Conservez l’arborescence des médias intacte, sauf si la version a modifié des fichiers multimédias d’une manière documentée ; ne recopiez pas des téraoctets simplement parce que l’image de l’application a changé.

La discussion sur le retour en arrière de la base de données dans la planification d’un retour en arrière compatible avec la base de données explique le danger général du déploiement d’un ancien code sur un schéma qu’il ne comprend plus. Ce principe importe davantage que le fait que le conteneur démarre ou non correctement.

Démarrez l’instance de retour à la version antérieure de manière isolée afin que les clients mobiles et les tâches planifiées ne puissent pas écrire avant la fin de la validation. Si l’ancienne version signale immédiatement des erreurs de schéma, arrêtez. Ne forcez pas manuellement le retour en arrière des migrations sur l’unique copie de la base de données, sauf si vous disposez d’une procédure de récupération testée et propre à la version.

Épingler l’image exacte connue comme fonctionnelle et reproduire sa configuration

Utilisez une version précise ou une référence d’image immuable plutôt qu’une étiquette évolutive. Restaurez l’environnement correspondant, les dépendances entre services, les mappages de périphériques, les réseaux, les ports et la cible du proxy inverse du dernier déploiement connu comme fonctionnel. Un retour à une version antérieure qui modifie silencieusement plusieurs couches de l’infrastructure crée un second incident.

Conservez l’image et la configuration de la nouvelle version défaillante avec les notes sur le retour à la version antérieure. Cela permet une récupération contrôlée vers une version plus récente une fois l’incompatibilité comprise. Supprimer immédiatement tous les nouveaux artefacts peut rendre plus difficile la comparaison entre l’état défaillant et l’état fonctionnel, ou la reproduction de la mise à niveau dans un environnement de test.

Si l’ancien service démarre avec l’état restauré, examinez les journaux avant d’autoriser les clients à se connecter. Vérifiez qu’il n’y a aucune tentative de migration inattendue, aucune initialisation de nouvelle installation, aucun montage de stockage manquant ni aucune réécriture des permissions. Une page de connexion ne prouve pas à elle seule que le retour à la version antérieure utilise les données prévues.

Valider l’ancienne version avec le déclencheur d’origine et préserver une voie de mise à niveau

Testez des utilisateurs représentatifs, des éléments anciens et récents, les albums, le partage, la recherche, un nouveau téléversement contrôlé, les tâches en arrière-plan, la création d’une sauvegarde de la base de données et la route du proxy inverse. Redémarrez la pile une fois et confirmez que les mêmes montages et la même base de données sont rétablis sans intervention manuelle.

Suspendez les nouveaux téléversements jusqu’à ce que ces vérifications soient concluantes, puis rétablissez l’accès et surveillez la période d’activité habituelle. Conservez à la fois la sauvegarde antérieure à la mise à niveau et celle de l’état défaillant de la nouvelle version, afin de pouvoir réessayer la mise à niveau ultérieurement dans une copie isolée, une fois le problème de compatibilité compris.

Le retour à une version antérieure a échoué si cette version signale une incompatibilité de schéma, si des données connues sont manquantes ou si les écritures aboutissent à un emplacement inattendu. Arrêtez et restaurez à nouveau le point de récupération préservé au lieu d’empiler les réparations. Faites remonter le problème en indiquant les versions exactes, les journaux de migration, les horodatages des sauvegardes de la base de données, le diff Compose et la première étape de vérification qui échoue.

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.