6. Mapeo de Puertos (-p) y Variables de Entorno (-e / --env-file)
Conecta puertos del contenedor a la máquina anfitriona y parametriza configuraciones dinámicas y credenciales de forma segura con variables de entorno.
Aislamiento de Red y Mapeo de Puertos (-p)
Por defecto, un contenedor se ejecuta en una red privada y aislada. Si un servidor web dentro del contenedor escucha en el puerto 80, dicho puerto no es accesible desde tu navegador en http://localhost a menos que crees un puente explícito entre el host y el contenedor.
La sintaxis del mapeo con la bandera -p o --publish es siempre:
Por ejemplo, -p 8080:80 significa: "Cualquier petición que llegue a mi computadora en el puerto 8080 será redirigida al puerto interno 80 del contenedor".
Inyección de Variables de Entorno (-e y --env-file)
Para que una imagen sea universal y reutilizable nunca se deben guardar contraseñas, URLs de bases de datos o claves de API dentro del código. El estándar es inyectar estas configuraciones dinámicamente al arrancar:
-e CLAVE=VALOR: Pasa una variable puntual en la línea de comando.--env-file .env: Lee automáticamente un archivo de texto con paresCLAVE=VALOR, ideal para mantener credenciales fuera del historial de la terminal.
.env a .gitignore. Las credenciales de producción nunca deben comitearse al repositorio Git.
⚡ Levantar un Servidor MariaDB / MySQL con Puertos y Variables de Entorno
Ejemplo de comando docker run configurando contraseñas y base de datos inicial mediante variables de entorno oficiales de la imagen MariaDB:
# 1. Levantar contenedor MariaDB mapeando el puerto 3306 e inyectando credenciales
docker run -d \
--name base-datos-kilo \
-p 3306:3306 \
-e MARIADB_ROOT_PASSWORD=SuperClaveSegura2026 \
-e MARIADB_DATABASE=kilopolis_db \
-e MARIADB_USER=desarrollador \
-e MARIADB_PASSWORD=MiClaveDev123 \
mariadb:11
# 2. Levantar un Nginx en el puerto 8080 local mapeado al 80 interno
docker run -d \
--name web-local \
-p 8080:80 \
nginx:alpine
# 3. Probar la respuesta HTTP con curl en la máquina host
curl -I http://localhost:8080
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lecciónSi ejecutas "docker run -d -p 3000:80 nginx:alpine", ¿en qué puerto de tu computadora debes abrir el navegador?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar Docker & Contenedores: De Cero a Producción y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.