Cómo modificar variables de entorno en un contenedor Docker

Cómo modificar variables de entorno en un contenedor Docker

/* ---- --- */
Alejandro Robles
Alejandro Robles
Por: Alejandro Robles
Publicado el:

Modifica las variables de entorno (Env) de tu contenedor Docker en ejecución de manera sencilla y sin riesgos con Portainer

En entornos Docker, las variables de entorno son la forma más práctica de parametrizar el comportamiento de tus aplicaciones sin modificar el código ni los archivos internos del contenedor. Cuando necesitas ajustar credenciales, configuraciones de conexión o cualquier otro valor sensible, lo ideal es actualizar estas variables y recrear el contenedor para que tome los nuevos parámetros desde el arranque.

Portainer simplifica enormemente esta tarea ya que ofrece una interfaz gráfica intuitiva para administrar tus contenedores. En lugar de lidiar con la línea de comandos o editar manualmente un archivo .env, con unos pocos clics puedes duplicar la configuración actual, modificar exactamente la variable que te interesa y desplegar la instancia actualizada.

1. Ingresa a la intefaz web de Portainer

Abre tu navegador en la URL de Portainer (por ejemplo https://portainer.tudominio.com) e inicia sesión.

Login portainer
En este caso Portainer esta alojado en un subdominio pero todo depende de como este hosteado en tu servidor VPS.

2. Localiza tu aplicación Docker en ejecución

Para este caso de ejemplo estaremos actualizando nuestra aplicación n8n. Recuerda que este tutorial funciona igual para cualquier contendor corriendo en nuestro servidor.

Damos clic en el nombre del contenedor para acceder a su configuración:

n8n Corriendo en Docker

3. Detenemos la ejecución de nuestra aplicación.

Primero vamos a detener la el Contenedor dando clic al botón “Stop”

n8n Stop Docker

Esperaremos hasta que se nos muestre un Popup con el siguiente mensaje:

n8n Stop Docker

4. Entrar al modo edición

Haz clic en Duplicate/Edit. Esto te lleva a un formulario con toda la configuración actual del contenedor lista para editar:

Portainer edit

5. Modificar la variable de entorno

Desplázate hasta la sección Advanced container settings después en la pestaña Env Localiza la variable que quieres cambiar:

Portainer edit

Para este ejemplo cambiaremos el valor de la variable de entorno TZ (Time Zone), la cual le indica a nuestra aplicación que zona horaria usar para todas las automatizaciones y flujos.

Portainer edit env
Ajustamos el nuevo valor de America/Monterrey a America/Mexico_City (Revisa que no haya espacios extras ni comillas innecesarias)

6. Revisar el resto de la configuración

Antes de desplegar, verifica la opción: Always pull the image déjala activa solo si tu aplicación tenga algún aviso de que existen actualizaciones disponibles. En caso contrario, se recomienda desactivar esta opción ya que podría causar errores al momento de desplegar nuevamente el contenedor.

Portainer actualizar pull
Nota: Esta opción descarga la versión mas reciente de la imagen Docker del DockerHub.

7. Desplegar (hacer Deploy) del contenedor

Deslízate hasta el final de la página y haz clic en el botón Deploy the container:

Portainer Deploy

Se mostrara un Modal de confirmación. Hacemos clic en el boton Replace:

Portainer Deploy

Esto nos redireccionará a la pantalla principal y al terminar el proceso aparecerá un Popup con el siguiente mensaje:

Portainer Deploy success
Portainer detendrá y eliminará el contenedor antiguo, y lanzará uno nuevo con la configuración actualizada.

5.Verificar el funcionamiento de nuestra aplicación

Hasta este punto tu aplicación Docker ya debería contar con los valores de las variables de entorno actualizadas y corriendo sin problemas. Ahora, vamos a ingresar a la URL de la aplicación para verificar su correcto funcionamiento. Recuerda que para este caso estamos usando n8n como ejemplo en un subdominio similar a: https://n8n.tudominio.com.

n8n Login

6. Posibles errores con Apache 2

Si estas usando Apache 2 con un Proxy Reverse puede que se muestre en tu navegador este mensaje cuando intentas ingresar a la URL de tu aplicación. No te preocupes, solo espera unos cuantos minutos en lo que Apache actualiza su servicio y ya podrás ingresar sin problema.

Apache Proxy
Apache Proxy
Administra, crea y actualiza tus aplicaciones Docker corriendo en tu VPS mediante una interfaz web con Portainer.

$99
$175
🔥 En tendencia
Costo por el servicio en USD.

Artículos Relacionados

Aplicaciones y servicios
HTTPS para tu aplicación Docker en VPS

HTTPS para tu aplicación Docker en VPS

Aprende paso a paso a exponer tu aplicación Docker en un subdominio con Apache2 y asegurarla con HTTPS gratis y renovación automática.