Un servicio de Compose puede usar valores de entorno distintos después de reiniciar si el lanzador de arranque resuelve otro directorio del proyecto, archivo env o fuente de precedencia.
Un comando manual puede ejecutarse desde la carpeta prevista con un entorno de shell, mientras que systemd, un programador de NAS o Portainer inicia el mismo archivo Compose desde otro contexto después del arranque. El servicio también puede reiniciar un contenedor existente cuyo entorno quedó fijado al crearlo, en lugar de volver a leer el archivo editado. Compara el modelo de Compose renderizado y el entorno del proceso en ejecución de las rutas manual y de arranque antes de editar varios archivos a la vez.
Compara el entorno en ejecución con el archivo previsto
Registra el ID del contenedor, la hora de creación, la imagen, las etiquetas de Compose, el nombre del proyecto y los valores reales visibles dentro del proceso principal. Compáralos con el archivo env previsto sin imprimir secretos en registros compartidos.
El entorno del proceso de Linux muestra los valores proporcionados en el momento de la ejecución, lo que constituye una prueba más sólida que leer un archivo env que quizá el contenedor actual nunca haya usado.
Si el contenedor contiene los valores antiguos y se creó antes del despliegue al reiniciar, es posible que el servicio solo lo haya reiniciado. Si el contenedor es nuevo, continúa con la precedencia y la resolución de rutas.
Aplica la precedencia de variables de entorno de Compose en el orden correcto
Enumera todas las fuentes de una variable inocua: indicadores de la CLI, valores del shell, environment:, env_file:, el archivo .env predeterminado o explícito y ENV de la imagen.
Docker define un orden formal de precedencia de las variables de entorno, por lo que un archivo env correcto puede quedar anulado por un valor de mayor prioridad inyectado por el servicio de arranque o el gestor de la pila.
No busques solo archivos con nombres duplicados. Busca el nombre de la variable en el modelo de Compose renderizado, el archivo de unidad, la configuración del gestor, el entorno del shell y los valores predeterminados de la imagen.
Comprueba el directorio del proyecto y las rutas relativas de los archivos Env
Compara el directorio de trabajo del comando manual con el directorio de trabajo del lanzador de arranque, los argumentos del archivo Compose, el directorio del proyecto y las referencias relativas a env_file.
La especificación de Compose define el modelo de aplicación usado para resolver los servicios y la configuración, por lo que la definición de proyecto seleccionada y sus rutas son entradas del despliegue, no propiedades que se vuelven a determinar a partir del contenedor en ejecución.
Usa rutas absolutas para los archivos env esenciales para el arranque cuando la herramienta de despliegue lo permita, o configura explícitamente un directorio de proyecto y un directorio de trabajo para que los lanzamientos manuales y automatizados resuelvan los mismos archivos.
Inspecciona el directorio de trabajo y los archivos de entorno de systemd
Lee la unidad efectiva, todos los archivos drop-in, WorkingDirectory=, Environment=, EnvironmentFile= y ExecStart=. Compara la unidad cargada al arrancar con el comando usado manualmente.
La configuración de ejecución de systemd define el directorio de trabajo del servicio y los archivos de entorno, que no heredan automáticamente el directorio actual ni las variables exportadas de un shell de inicio de sesión interactivo.
Después de cambiar una unidad o un archivo drop-in, vuelve a cargar el gestor de systemd y comprueba de nuevo la unidad efectiva. Editar una plantilla o un archivo sin usar no cambia el servicio que realmente se inicia.
Revisa las variables del gestor de pilas y el estado de despliegue almacenado
Si Portainer o la interfaz de usuario del NAS gestiona la pila, compara las variables guardadas, el archivo env cargado, la ruta de despliegue de Git, el comportamiento de actualización del webhook y el modelo de Compose que se muestra.
Portainer distingue el comportamiento de .env y stack.env, por lo que los valores introducidos en el gestor pueden diferir de los de un archivo editado directamente en el host.
Elige una única fuente de verdad. Una pila gestionada desde Git o un editor web no debería iniciarse también manualmente desde otra copia local después de cada reinicio.
Vuelve a crear el contenedor en lugar de limitarte a reiniciarlo
Compara la hora de creación del contenedor con la hora de modificación del archivo env. Renderiza la configuración de Compose prevista y luego vuelve a crear de forma controlada solo el servicio afectado.
La guía de systemd de Red Hat recomienda comprobar los archivos y las anulaciones que realmente usa un servicio antes de reiniciarlo, para evitar que una unidad o un envoltorio obsoleto vuelva a crear el contenedor con valores antiguos.
Al reiniciar un contenedor, no se reconstruye su entorno a partir de Compose. Vuelve a crearlo solo después de proteger los datos persistentes y confirmar que el modelo renderizado apunta a los volúmenes y secretos previstos.
Haz que el inicio manual, el reinicio y la nueva implementación produzcan el mismo modelo
Fija los archivos de Compose, el nombre del proyecto, el directorio del proyecto, la ruta del archivo env, el responsable de la pila y la dependencia de inicio. Guarda una configuración renderizada con los valores sensibles ocultos y una huella digital inocua del entorno.
El artículo de ZimaSpace sobre el alcance de las copias de seguridad de Docker ofrece la regla complementaria: los archivos de entorno y las definiciones de implementación deben conservarse junto con el estado persistente.
El problema se resuelve cuando una recreación manual, el reinicio del host, una actualización programada y una nueva implementación desde el administrador de la pila crean el servicio con la misma huella digital del entorno, con los valores sensibles ocultos.
Preguntas frecuentes
¿Cuál es la diferencia entre .env y env_file?
Un archivo .env del proyecto suele proporcionar valores de interpolación a Compose, mientras que un env_file del servicio proporciona variables al contenedor. Su interacción y precedencia dependen del modelo completo de Compose.
¿Al reiniciar un contenedor se vuelve a cargar un archivo env modificado?
No. Los valores del entorno se establecen cuando se crea el contenedor. Normalmente, hay que volver a crear el servicio con la configuración de Compose corregida.
¿Por qué aparece el problema solo después de reiniciar?
La ruta de reinicio puede usar una unidad de systemd, un programador, variables almacenadas por el administrador, otro directorio de trabajo o una copia antigua de Compose que difiera del inicio manual.
Soporte y consejos
Más para leer

Cómo mantener ocultos de tu familia los vídeos para adultos en tu NAS
Mantén privados los vídeos para adultos en un NAS familiar. Comprueba los permisos de las carpetas, el acceso a las bibliotecas de Plex y...

Qué comprobar antes de cargar un modelo de la comunidad en Transformers
Usa la actualización del entorno aislado de Jinja para Transformers para revisar la procedencia del modelo, las plantillas de chat, el código remoto, los...

Ejecuta Mirage localmente: OCR y detección de objetos a partir de una sola imagen
Prueba el pequeño modelo de visión local de Cactus Compute, valida el OCR y la extracción de objetos con datos reales y comprende las...



