Using Docker Compose with Custom Networks

Docker Compose is a powerful tool that allows developers to define and run multi-container Docker applications with ease. By using a simple YAML file, you can configure the services, networks, and volumes that your application needs. One of the often overlooked yet incredibly useful features of Docker Compose is the ability to create and utilize custom networks. This article delves deep into the fundamentals of Docker networks, the advantages of custom networks, and practical examples to illustrate how to effectively use Docker Compose with custom networks.

Comprendiendo las Redes de Docker

Antes de sumergirnos en Docker Compose, es fundamental comprender los conceptos de redes de Docker. Docker utiliza un modelo de redes en capas que proporciona varios tipos de redes:- **Bridge**: Es el tipo de red por defecto para los contenedores. Permite que los contenedores en el mismo host se comuniquen entre sí y con el mundo exterior a través del host.- **Host**: En este modo, el contenedor comparte el espacio de red del host. Esto significa que el contenedor no tiene su propia interfaz de red y utiliza directamente la red del host.- **None**: Este modo deshabilita la red para el contenedor, lo que significa que el contenedor no tiene conectividad de red.- **Overlay**: Este tipo de red permite que los contenedores en diferentes hosts se comuniquen entre sí. Es útil en entornos de orquestación como Docker Swarm.- **Macvlan**: Este modo permite asignar una dirección MAC al contenedor, haciéndolo aparecer como un dispositivo físico en la red.- **Network plugins**: Docker también admite plugins de red de terceros que pueden proporcionar funcionalidades adicionales.Cada uno de estos tipos de red tiene sus propias características y casos de uso. Por ejemplo, la red Bridge es ideal para el desarrollo y las pruebas locales, mientras que la red Overlay es más adecuada para entornos de producción distribuidos.Además, Docker proporciona herramientas para gestionar y configurar estas redes, como el comando `docker network` que permite crear, listar, inspeccionar y eliminar redes.Es importante tener en cuenta que la elección del tipo de red adecuado depende de los requisitos específicos de tu aplicación y entorno. Por ejemplo, si necesitas que tus contenedores se comuniquen con el mundo exterior, la red Bridge es una buena opción. Si necesitas que tus contenedores se comuniquen con otros contenedores en diferentes hosts, la red Overlay es más adecuada.En resumen, comprender los conceptos de redes de Docker es crucial para diseñar e implementar aplicaciones contenerizadas de manera efectiva.

1. Bridge Network: La red predeterminada para contenedores. Si no especificas una red al iniciar un contenedor, se conectará a la red bridge.
2. Red de acogida: Elimina el aislamiento de red entre el contenedor y el host de Docker, permitiendo que el contenedor utilice la pila de red del host.
3. Red Superpuesta: Habilita la comunicación entre contenedores que se ejecutan en diferentes hosts de Docker. Normalmente se utiliza en modo Swarm.
4. Macvlan NetworkAsigna una dirección MAC a un contenedor, permitiendo que este aparezca como un dispositivo físico en la red.

Al utilizar Docker Compose, puedes crear redes personalizadas que facilitan la comunicación entre tus contenedores mientras los aíslan de otros. Las redes personalizadas ofrecen varias ventajas, entre ellas:

• Improved SecurityAl aislar contenedores, limitas la superficie de ataque.
• Descubrimiento de Servicios Simplificado: Containers can communicate using their service names, thanks to Docker’s built-in DNS resolution.
• Enhanced PerformanceLas redes aisladas pueden reducir la sobrecarga asociada a la comunicación entre contenedores.

Configuración de un archivo Docker ComposeEn esta sección, aprenderás a configurar un archivo Docker Compose para tu aplicación. Docker Compose es una herramienta que te permite definir y ejecutar aplicaciones multi-contenedor de Docker. Con Docker Compose, puedes definir todos los servicios que componen tu aplicación en un solo archivo YAML, y luego iniciarlos con un solo comando.Para configurar un archivo Docker Compose, sigue estos pasos:1. Crea un nuevo archivo llamado `docker-compose.yml` en la raíz de tu proyecto.2. Define los servicios que componen tu aplicación en el archivo `docker-compose.yml`. Cada servicio se define como una sección en el archivo, con su propio nombre y configuración. Por ejemplo:```yaml version: '3' services: web: build: . ports: - "5000:5000" volumes: - .:/code redis: image: redis ```En este ejemplo, se definen dos servicios: `web` y `redis`. El servicio `web` se construye a partir del Dockerfile en el directorio actual, y se expone en el puerto 5000. El servicio `redis` utiliza la imagen oficial de Redis.3. Una vez que hayas definido todos los servicios, puedes iniciarlos con el siguiente comando:```bash docker-compose up ```Este comando iniciará todos los servicios definidos en el archivo `docker-compose.yml`.4. Para detener los servicios, utiliza el siguiente comando:```bash docker-compose down ```Este comando detendrá y eliminará todos los contenedores definidos en el archivo `docker-compose.yml`.5. Para ver el estado de los servicios, utiliza el siguiente comando:```bash docker-compose ps ```Este comando mostrará una lista de todos los contenedores que se están ejecutando como parte de la aplicación.6. Para ver los registros de los servicios, utiliza el siguiente comando:```bash docker-compose logs ```Este comando mostrará los registros de todos los contenedores que se están ejecutando como parte de la aplicación.7. Para ejecutar un comando en un contenedor específico, utiliza el siguiente comando:```bash docker-compose exec ```Por ejemplo, para ejecutar el comando `bash` en el contenedor `web`, utiliza el siguiente comando:```bash docker-compose exec web bash ```8. Para ver la configuración de los servicios, utiliza el siguiente comando:```bash docker-compose config ```Este comando mostrará la configuración de todos los servicios definidos en el archivo `docker-compose.yml`.9. Para ver la versión de Docker Compose, utiliza el siguiente comando:```bash docker-compose --version ```Este comando mostrará la versión de Docker Compose instalada en tu sistema.10. Para ver la ayuda de Docker Compose, utiliza el siguiente comando:```bash docker-compose --help ```Este comando mostrará una lista de todos los comandos disponibles en Docker Compose.Con estos pasos, podrás configurar y utilizar Docker Compose para gestionar tu aplicación multi-contenedor de Docker.

To illustrate how to use Docker Compose with custom networks, we will create a simple web application consisting of a web server and a database. For this example, we will use Nginx as the web server and PostgreSQL as the database.

Estructura de directorios

Create a directory for your project and set up a basic structure as follows:

my_project/
├── docker-compose.yml
└── web/
    ├── Dockerfile
    └── index.html

# Use an official Python runtime as a parent image FROM python:3.8-slim-buster# Set the working directory in the container WORKDIR /app# Copy the current directory contents into the container at /app COPY . /app# Install any needed packages specified in requirements.txt RUN pip install --no-cache-dir -r requirements.txt# Make port 80 available to the world outside this container EXPOSE 80# Define environment variable ENV NAME World# Run app.py when the container launches CMD ["python", "app.py"]

En el web directorio, crea un archivo llamado Dockerfile with the following content:

# Usa la imagen oficial de Nginx
FROM nginx:alpine

# Copia el archivo index.html
COPY index.html /usr/share/nginx/html/index.html

A continuación, crea un simple index.html file in the same directory:

    Docker Compose Custom Network Example

    Hello from Nginx!

Creando el archivo Docker Compose

Ahora es el momento de crear el docker-compose.yml file in the root of your my_project directory:

version: '3.8'

services:
  web:
    build:
      context: ./web
    networks:
      - custom_network
    ports:
      - "8080:80"

  db:
    image: postgres:alpine
    environment:
      POSTGRES_USER: user
      POSTGRES_PASSWORD: password
      POSTGRES_DB: my_database
    networks:
      - custom_network

networks:
  custom_network:
    driver: bridge

Explicación del docker-compose.yml

1. Versión: Especifica la versión de Docker Compose utilizada. En este caso, estamos utilizando la versión 3.8.
2. Servicios: Define los servicios que componen su aplicación.
   • web: This service builds from the Dockerfile in the web directory, connects to the custom_network, y asigna el puerto 8080 del host al puerto 80 del contenedor.
   • dbEste servicio utiliza la imagen oficial de PostgreSQL. Se pasan variables de entorno para configurar la base de datos. También se conecta a la misma. custom_network.
3. Networks: Define la red personalizada custom_network, que utiliza el controlador de puente.

Inicie la aplicación

To start the multi-container application, navigate to the my_project directorio en tu terminal y ejecuta:

docker-compose up --build

Accessing the Application

Una vez que la aplicación esté en funcionamiento, puedes acceder al servidor web visitando http://localhost:8080 in your web browser. You should see the message "Hello from Nginx!".

Aislamiento de red

Since both services are connected to the same custom network, they can communicate with each other using their service names:

• El web service can connect to the db servicio que utiliza el nombre de host db.
• El db El servicio puede ser accedido desde el web service using the same hostname.

Esto resulta particularmente útil en escenarios donde la aplicación web necesita realizar consultas a bases de datos u otras comunicaciones internas.

Advanced Network Configurations

Redes personalizadas múltiples

En algunos casos, es posible que desees separar los servicios en múltiples redes para una mejor aislación. Puedes definir múltiples redes personalizadas en tu docker-compose.yml:

version: '3.8'

services:
  web:
    build:
      context: ./web
    networks:
      - frontend
      - backend
    ports:
      - "8080:80"

  db:
    image: postgres:alpine
    environment:
      POSTGRES_USER: usuario
      POSTGRES_PASSWORD: contraseña
      POSTGRES_DB: mi_base_de_datos
    networks:
      - backend

networks:
  frontend:
    driver: bridge
  backend:
    driver: bridge

In this configuration:

• El web El servicio está conectado tanto al front-end and backend redes.
• El db service is only connected to the backend red.

This allows the web servicio para comunicarse con ambos los db servicio y cualquier otro servicio que pueda estar conectado al front-end La red, mientras aísla la base de datos del acceso directo por otros servicios.

Alias de red

Docker Compose te permite definir alias de red, que proporcionan nombres adicionales para tus servicios dentro de una red. Puedes definir un alias para el db service in the web servicio como este:

servicios:
  web:
    build:
      context: ./web
    networks:
      custom_network:
        aliases:
          - database

In this case, the web service can access the db servicio usando cualquiera de los dos db or base de datos como el nombre de host.

Depuración de problemas de red

La depuración de problemas de red en Docker puede ser un desafío en ocasiones. Aquí tienes algunos consejos para ayudarte a solucionar problemas:

1. Inspeccionando redes: Puedes inspeccionar las redes personalizadas para ver qué contenedores están conectados a ellas:

   docker network inspeccionar my_project_custom_network

2. Checking Container LogsPuedes ver los registros de un contenedor para obtener información sobre errores o problemas:

   docker-compose logs web

3. Ping Between ContainersPuedes usar Docker exec para ejecutar un shell en uno de tus contenedores y hacer ping a otro contenedor para probar la conectividad.

   docker exec -it my_project_web_1 ping db

Best Practices for Using Custom Networks

1. Limit Connectivity: Conecte solo los servicios que necesitan comunicarse. Esto minimiza la superficie de ataque y mejora la seguridad.
2. Usa nombres significativosNombra tus redes de forma descriptiva para que sea más fácil entender su propósito.
3. Uso de la red de documentos: Provide comments in your docker-compose.yml archivo para aclarar los roles de las diferentes redes para futuros desarrolladores o para tu yo futuro.
4. Prueba las conexiones de redPara probar una conexión de red, puedes usar el comando ping. El comando ping envía un mensaje de solicitud de eco ICMP a un host y espera una respuesta. Si el host está activo y es accesible, responderá con un mensaje de respuesta de eco ICMP. El comando ping muestra el tiempo que tardó en recibir la respuesta y otros detalles.Para probar una conexión a un host específico, usa el siguiente comando:``` ping hostname ```Reemplaza "hostname" con el nombre del host al que deseas conectarte. Por ejemplo, para probar la conexión a un servidor web llamado "www.example.com", usa el siguiente comando:``` ping www.example.com ```El comando ping enviará cuatro mensajes de solicitud de eco ICMP al host y esperará una respuesta. Si el host está activo y es accesible, responderá con un mensaje de respuesta de eco ICMP. El comando ping mostrará el tiempo que tardó en recibir la respuesta y otros detalles.Si el host no responde, el comando ping mostrará un mensaje de error. Esto puede indicar que el host no está activo o que hay un problema con la conexión de red.También puedes usar el comando ping para probar la conexión a una dirección IP específica. Para hacerlo, usa el siguiente comando:``` ping ip_address ```Reemplaza "ip_address" con la dirección IP del host al que deseas conectarte. Por ejemplo, para probar la conexión a un servidor web con la dirección IP "192.168.1.1", usa el siguiente comando:``` ping 192.168.1.1 ```El comando ping enviará cuatro mensajes de solicitud de eco ICMP al host y esperará una respuesta. Si el host está activo y es accesible, responderá con un mensaje de respuesta de eco ICMP. El comando ping mostrará el tiempo que tardó en recibir la respuesta y otros detalles.Si el host no responde, el comando ping mostrará un mensaje de error. Esto puede indicar que el host no está activo o que hay un problema con la conexión de red.: Regularly test the connectivity between services, especially when making significant changes to your application.

Conclusión

Las redes personalizadas en Docker Compose son una característica poderosa que permite mejorar la seguridad, el rendimiento y el descubrimiento de servicios. Al comprender cómo configurar y gestionar estas redes, puedes crear aplicaciones más robustas y escalables. Ya sea que estés trabajando en una simple aplicación web o en una compleja arquitectura de microservicios, aprovechar Docker Compose con redes personalizadas puede ayudar a agilizar tu proceso de desarrollo.

Con los conocimientos adquiridos en este artículo, ahora estás equipado para utilizar redes personalizadas de manera efectiva en tus aplicaciones Docker Compose. A medida que continúes desarrollando y desplegando aplicaciones contenerizadas, recuerda que las estrategias de red efectivas son clave para construir sistemas resilientes en el mundo de los microservicios. ¡Feliz Dockering!