Tema 6 · Puertos & Configuración

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:

-p <PUERTO_EN_TU_MAQUINA_HOST>:<PUERTO_INTERNO_DEL_CONTENEDOR>

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 pares CLAVE=VALOR, ideal para mantener credenciales fuera del historial de la terminal.
🚨 Regla de Oro en Producción: Agrega siempre tu archivo .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:

levantar-mariadb.sh
Solo lectura
# 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ón
1 Pregunta
Pregunta 1
Si 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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.