Immich peut-il utiliser une base de données externe sans compliquer les mises à niveau ?

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.

Vous pouvez connecter Immich à un service PostgreSQL externe, mais cela ne rend pas les mises à niveau automatiquement sûres ; la responsabilité des versions de la base de données, des extensions, des privilèges, des sauvegardes et des retours arrière incombe alors à l’utilisateur, et non à la pile par défaut.

Considérez une base de données externe comme une limite de compatibilité avancée, et non comme une simple option de performance. Avant chaque mise à niveau d’Immich ou de PostgreSQL, vérifiez les exigences de la version exacte d’Immich que vous prévoyez d’utiliser, confirmez que le serveur externe peut fournir les extensions et privilèges requis, créez une sauvegarde restaurable et ne modifiez qu’une seule couche à la fois afin de savoir quel composant a provoqué une défaillance.

Commencez par définir les conditions de la base de données externe

Consignez le point de terminaison de la base de données, son nom, le compte de service, le mode TLS, la version majeure de PostgreSQL, les noms et versions des extensions installées, ainsi que les personnes autorisées à les mettre à niveau. Conservez ces informations avec la définition du déploiement Immich afin qu’une recréation de conteneur ne le reconnecte pas silencieusement à un autre serveur ou à une autre base de données.

Il est possible d’utiliser un serveur PostgreSQL existant, mais ce n’est pas la configuration recommandée par défaut pour Immich. Pour les versions actuelles, l’utilisation d’une base de données autonome nécessite pgvector et VectorChord ; Immich est compatible avec PostgreSQL 14 à 19, pgvector >=0.7 et <0.9, ainsi que VectorChord >=0.3 et <2.0. Vérifiez à nouveau ces plages avant chaque mise à niveau, car elles peuvent changer.

Planifiez les privilèges avant la bascule. Immich nécessite généralement un rôle de base de données doté de l’autorisation de superutilisateur ; fonctionner sans cette autorisation est une approche avancée qui peut nécessiter une intervention manuelle lors des mises à jour, et les sauvegardes automatisées actuelles de la base de données nécessitent cette autorisation. Si votre fournisseur externe ne peut pas satisfaire à ces exigences, arrêtez-vous avant de déplacer les données de production.

Vérifiez la compatibilité de PostgreSQL et des extensions avant toute modification

Indiquez les versions actuelles et cibles de PostgreSQL, ainsi que toutes les extensions dont Immich dépend. Une mise à niveau majeure de PostgreSQL peut nécessiter des binaires d’extensions compilés pour la version majeure cible, tandis qu’une mise à niveau d’Immich peut exiger une extension plus récente ou modifier le comportement des migrations, même si PostgreSQL démarre toujours.

Les fichiers des paquets d’extensions et leur état SQL doivent être transférés délibérément avec la base de données, plutôt que de supposer qu’ils suivent automatiquement une mise à niveau de PostgreSQL. Consultez les dépendances de mise à niveau des extensions PostgreSQL avant de modifier la version majeure de la base de données ou les paquets des extensions requises par Immich.

Si votre fournisseur externe ne vous permet pas d’installer ou de mettre à niveau l’extension requise, de modifier les paramètres de préchargement partagés lorsque nécessaire ou d’accorder les privilèges nécessaires à la migration, arrêtez-vous avant de mettre Immich à jour. Une base de données qui accepte les requêtes ordinaires peut tout de même être incompatible avec la prochaine migration de l’application.

Distinguez les mises à niveau majeures de la base de données des mises à niveau d’Immich

Évitez de combiner une mise à niveau majeure de PostgreSQL, une mise à niveau d’extension et une mise à niveau de l’application Immich dans une seule opération de maintenance, sauf si vous avez déjà répété la séquence complète. Lorsque plusieurs points de compatibilité évoluent simultanément, un échec au démarrage ne permet plus de savoir quelle couche en est la cause.

Les mises à jour mineures de PostgreSQL et les mises à niveau vers une version majeure sont deux opérations de maintenance différentes, et les mises à niveau majeures nécessitent de préparer au préalable l’environnement cible, y compris les extensions tierces. Dans la mesure du possible, effectuez les mises à niveau majeures de PostgreSQL séparément d’une mise à niveau de l’application Immich, afin qu’en cas d’échec du démarrage, une seule modification soit à examiner.

Pour un serveur domestique, la séquence la moins risquée est généralement la suivante : effectuer des sauvegardes, vérifier une restauration, mettre à jour une seule couche, lancer les vérifications, puis continuer. Si une version d’Immich nécessite une modification de la base de données, suivez l’ordre prescrit pour cette version au lieu d’appliquer une procédure générique de mise à niveau de PostgreSQL.

Préserver une procédure de restauration couvrant la base de données et les médias

Avec une base de données externe, il est plus facile d’oublier que l’état d’Immich est réparti entre PostgreSQL et la bibliothèque multimédia. Sauvegardez la base de données avec une méthode qui en garantit la cohérence et préservez l’état pertinent des médias et de la configuration pendant la même période de récupération, avant une migration susceptible de modifier les schémas ou les métadonnées des fichiers.

L’état de la base de données, les fichiers de l’application, la configuration et les fichiers téléversés doivent être cohérents au moment de la restauration. Utilisez une sauvegarde cohérente du conteneur de base de données comme critère d’acceptation, et ne vous contentez pas de vérifier que PostgreSQL démarre.

Ne considérez pas la restauration comme prête tant que vous ne savez pas ce qu’il advient des deux côtés si la migration de l’application ne réussit que partiellement. Gardez l’ancienne version de l’application, la définition du déploiement, la sauvegarde de la base de données et l’état des médias disponibles assez longtemps pour pouvoir récupérer les données sans écraser la seule copie connue comme fiable avec un état plus récent.

Valider la mise à niveau au niveau de l’application, et pas seulement la connexion à la base de données

Après la modification, vérifiez que PostgreSQL accepte le rôle Immich prévu, que les extensions requises sont présentes dans les versions attendues et que la migration d’Immich se termine sans erreurs répétées de base de données. Une connexion TCP réussie ou un `SELECT 1` prouve la connectivité, pas la compatibilité avec l’application.

Utilisez ensuite Immich normalement : chargez d’anciens albums, ouvrez des photos et vidéos représentatives, effectuez des recherches, vérifiez les utilisateurs ou le partage si nécessaire, puis téléversez un fichier sans importance. Pendant ces opérations, surveillez les journaux de l’application et de la base de données afin de repérer les extensions manquantes, les erreurs d’autorisation, les échecs de migration ou les tentatives répétées.

Ce n’est qu’une fois que l’application a passé ces vérifications que vous devriez reprendre la rétention normale des sauvegardes et supprimer la copie de restauration. Si la base de données externe fait régulièrement dépendre les mises à niveau courantes d’Immich d’interventions manuelles sur les extensions ou les privilèges que vous ne pouvez pas répéter de manière fiable, le cycle de vie par défaut d’une base de données dédiée est le choix opérationnel le plus sûr.

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.