Compartir comentarios
Las respuestas se generan en base a la documentación.

Publicar y exponer puertos

Tabla de contenidos

Explicación

Si has estado siguiendo las guías hasta ahora, comprenderás que los contenedores proporcionan procesos aislados para cada componente de tu aplicación. Cada componente (un frontend de React, una API de Python y una base de datos Postgres) se ejecuta en su propio entorno aislado (sandbox), completamente separado de todo lo demás en tu máquina host. Este aislamiento es excelente para la seguridad y la gestión de dependencias, pero también significa que no puedes acceder a ellos directamente. Por ejemplo, no puedes acceder a la aplicación web en tu navegador.

Ahí es donde entra en juego la publicación de puertos.

Publicar puertos

Publicar un puerto proporciona la capacidad de romper un poco el aislamiento de red configurando una regla de reenvío. Como ejemplo, puedes indicar que las solicitudes en el puerto 8080 de tu host deben reenviarse al puerto 80 del contenedor. La publicación de puertos ocurre durante la creación del contenedor utilizando la bandera -p (o --publish) con docker run. La sintaxis es:

$ docker run -d -p HOST_PORT:CONTAINER_PORT nginx
  • HOST_PORT: El número de puerto en tu máquina host donde deseas recibir tráfico
  • CONTAINER_PORT: El número de puerto dentro del contenedor que está escuchando conexiones

Por ejemplo, para publicar el puerto 80 del contenedor en el puerto 8080 del host:

$ docker run -d -p 8080:80 nginx

Ahora, cualquier tráfico enviado al puerto 8080 en tu máquina host se reenviará al puerto 80 dentro del contenedor.

Important

Cuando se publica un puerto, se publica en todas las interfaces de red de forma predeterminada. Esto significa que cualquier tráfico que llegue a tu máquina puede acceder a la aplicación publicada. Ten cuidado al publicar bases de datos o cualquier información confidencial. Obtén más información sobre los puertos publicados aquí.

Publicar en puertos efímeros

A veces, es posible que simplemente desees publicar el puerto pero no te importe qué puerto del host se utilice. En estos casos, puedes dejar que Docker elija el puerto por ti. Para hacerlo, simplemente omite la configuración HOST_PORT.

Por ejemplo, el siguiente comando publicará el puerto 80 del contenedor en un puerto efímero del host:

$ docker run -p 80 nginx

Una vez que el contenedor esté funcionando, el uso de docker ps te mostrará el puerto elegido:

docker ps
CONTAINER ID   IMAGE         COMMAND                  CREATED          STATUS          PORTS                    NAMES
a527355c9c53   nginx         "/docker-entrypoint.…"   4 seconds ago    Up 3 seconds    0.0.0.0:54772->80/tcp    romantic_williamson

En este ejemplo, la aplicación está expuesta en el host en el puerto 54772.

Publicar todos los puertos

Al crear una imagen de contenedor, la instrucción EXPOSE se utiliza para indicar que la aplicación empaquetada utilizará el puerto especificado. Estos puertos no se publican de forma predeterminada.

Con la bandera -P o --publish-all, puedes publicar automáticamente todos los puertos expuestos en puertos efímeros. Esto es bastante útil cuando intentas evitar conflictos de puertos en entornos de desarrollo o pruebas.

Por ejemplo, el siguiente comando publicará todos los puertos expuestos configurados por la imagen:

$ docker run -P nginx

Pruébalo

En esta guía práctica, aprenderás cómo publicar puertos de contenedores utilizando tanto la CLI como Docker Compose para implementar una aplicación web.

Usar la CLI de Docker

En este paso, ejecutarás un contenedor y publicarás su puerto utilizando la CLI de Docker.

  1. Descarga e instala Docker Desktop.

  2. En una terminal, ejecuta el siguiente comando para iniciar un nuevo contenedor:

    $ docker run -d -p 8080:80 docker/welcome-to-docker

    El primer 8080 se refiere al puerto del host. Este es el puerto en tu máquina local que se utilizará para acceder a la aplicación que se ejecuta dentro del contenedor. El segundo 80 se refiere al puerto del contenedor. Este es el puerto en el que escucha la aplicación dentro del contenedor para recibir conexiones entrantes. Por lo tanto, el comando vincula el puerto 8080 del host con el puerto 80 en el sistema del contenedor.

  3. Verifica el puerto publicado yendo a la vista de Containers del Panel de Docker Desktop.

    Una captura de pantalla del Panel de Docker Desktop que muestra el puerto publicado

  4. Abre el sitio web seleccionando el enlace en la columna Port(s) de tu contenedor o visitando http://localhost:8080 en tu navegador.

    Una captura de pantalla de la página de inicio del servidor web Nginx que se ejecuta en un contenedor

Usar Docker Compose

Este ejemplo iniciará la misma aplicación utilizando Docker Compose:

  1. Crea un directorio nuevo y, dentro de ese directorio, crea un archivo compose.yaml con el siguiente contenido:

    services:
  app:
    image: docker/welcome-to-docker
    ports:
      - 8080:80

    La configuración ports acepta diferentes tipos de sintaxis para la definición del puerto. En este caso, estás utilizando el mismo formato HOST_PORT:CONTAINER_PORT utilizado en el comando docker run.

  2. Abre una terminal y navega al directorio que creaste en el paso anterior.

  3. Utiliza el comando docker compose up para iniciar la aplicación.

  4. Abre tu navegador en http://localhost:8080.

Recursos adicionales

Si deseas profundizar en este tema, asegúrate de consultar los siguientes recursos:

Siguientes pasos

Ahora que comprendes cómo publicar y exponer puertos, estás listo para aprender cómo sobrescribir los valores predeterminados del contenedor utilizando el comando docker run.

Sobrescribir los valores predeterminados del contenedor