Cómo evitar la pérdida de la configuración de Immich durante las actualizaciones

Evita perder la configuración de Immich durante las actualizaciones tratando el archivo de Compose, los valores del entorno, la base de datos, la biblioteca de cargas y las definiciones de montaje de bibliotecas externas como activos persistentes independientes que deben capturarse y restaurarse juntos.

Un contenedor se puede reemplazar; la configuración que lo rodea, no. Una actualización puede dar la impresión de haber borrado Immich cuando un montaje enlazado relativo se resuelve desde un directorio de proyecto diferente, una modificación del entorno nunca llega al contenedor recreado o la nueva pila se inicia con una base de datos vacía. Primero inventaría la implementación activa, conserva copias versionadas fuera del host y demuestra una recreación controlada antes de cambiar a producción.

Captura la implementación activa antes de cada actualización

Exporta la configuración efectiva de Compose con los secretos ocultos, registra las versiones o los resúmenes criptográficos de las imágenes y copia los archivos de Compose y del entorno en un almacenamiento versionado. Inspecciona los montajes en ejecución en lugar de asumir que el archivo de tu editor inició los contenedores actuales. El criterio de aprobación es que cada ruta en tiempo de ejecución corresponda a una ubicación del host conocida.

Registra las rutas de las bibliotecas externas, la configuración del proxy inverso, la URL del aprendizaje automático, los valores de conexión de la base de datos, la identidad del usuario y del grupo, los nombres de red y cualquier dispositivo de aceleración de hardware. La ausencia de un elemento aquí se convertirá más adelante en una diferencia inexplicable tras la actualización.

Las preguntas de la comunidad sobre actualizaciones muestran repetidamente que los operadores pierden de vista qué generación de Compose o qué estructura del entorno corresponde. La lección útil de un debate sobre la configuración de actualización es conservar la definición actual y funcional antes de traducirla.

Realiza copias de seguridad de la base de datos, los medios y los archivos de implementación por separado

Realiza una copia de seguridad nativa de la base de datos, además de una copia del sistema de archivos o una instantánea de la biblioteca de cargas y del directorio de implementación. Registra las horas de inicio y finalización, los tamaños de los archivos y las sumas de comprobación. Una copia de seguridad que solo contiene YAML de Compose puede reconstruir los contenedores, pero no restaurar cuentas, metadatos, álbumes ni registros de activos.

Usa una copia con el servicio detenido para establecer el límite de coherencia más sencillo, o coordina un volcado de la base de datos en vivo y una instantánea del almacenamiento para documentar su relación. Incluye las bibliotecas externas en el inventario aunque Immich no sea propietario de sus originales, porque las rutas y las reglas de acceso siguen afectando al servicio restaurado.

Un procedimiento de actualización a una versión principal mantenido por la comunidad destaca la importancia de conservar la base de datos, los medios, Compose y las entradas del entorno. Trata su secuencia como experiencia práctica de operadores y confirma cada paso con respecto a la versión que realmente implementas.

Prepara la actualización con versiones fijadas

Lee las notas de la versión de cada versión omitida y actualiza deliberadamente la definición de implementación guardada. Fija la versión de destino, descárgala sin eliminar las imágenes antiguas y valida la configuración renderizada de Compose. Las variables desconocidas, los montajes vacíos o las versiones de servicio mezcladas hacen que la preparación no supere el control.

Cuando la capacidad lo permita, restaura la copia de seguridad en una pila de prueba aislada, con puertos diferentes y sin acceso de escritura a producción. Iníciala con la versión de destino e inspecciona las migraciones, los usuarios, las rutas de almacenamiento y los trabajos en segundo plano. Que el contenedor se inicie correctamente por sí solo no demuestra que la biblioteca original esté conectada.

La guía relacionada de ZimaSpace sobre un NAS autoalojado seguro ayuda a ubicar los archivos de implementación y las copias de seguridad fuera del límite de un único host y de credenciales que una actualización puede alterar.

Featured

ZimaCube 2 NAS personal en la nube para el hogar

ZimaCube2

$799.00 - $2,499.00

Buy Now

Demuestra la persistencia de la configuración después de la recreación

Antes del cambio, recrea los contenedores de prueba a partir de los archivos guardados en lugar de reiniciarlos en su sitio. Verifica los usuarios, la configuración del servidor, las plantillas de almacenamiento, las bibliotecas, los trabajos, el acceso mediante el proxy y los valores efectivos del entorno. El criterio de aprobación es que la configuración sobreviva al reemplazo porque reside en componentes persistentes documentados.

Después del cambio a producción, carga un activo de prueba, realiza una búsqueda, abre un original y crea una copia de seguridad nueva de la base de datos. Reinicia la pila y el host, y repite las pruebas. Conserva la versión antigua, la copia de seguridad y la definición de implementación hasta que la carga de trabajo normal se mantenga estable durante el periodo de observación.

Si la actualización ya se inició vacía, detenla antes de que la incorporación de usuarios o las nuevas cargas creen un estado conflictivo. Vuelve a conectar únicamente una ruta persistente verificada o restaura en un destino limpio. Revierte el cambio cuando falten los usuarios o activos esperados; solicita ayuda con la configuración efectiva de Compose, los montajes, las versiones y las marcas de tiempo de las copias de seguridad, todos ellos anonimizados, si la identidad sigue sin estar clara.