Tema 12 · Docker Compose

12. Introducción a Docker Compose y Estructura de compose.yaml

Define y ejecuta arquitecturas completas multi-servicio con un único comando utilizando la especificación estándar compose.yaml.

¿Por qué necesitamos Docker Compose?

Cuando una aplicación requiere múltiples piezas interconectadas (como un servidor web Nginx, un runtime PHP-FPM, una base de datos MySQL y una instancia de Redis para caché), ejecutar manualmente largos comandos docker run con decenas de banderas se vuelve tedioso, frágil e imposible de reproducir entre miembros de un equipo.

Docker Compose es la herramienta oficial de orquestación local y de servidores que permite definir y gestionar arquitecturas multi-contenedor completas mediante un archivo de configuración declarativo en formato YAML: compose.yaml (o históricamente docker-compose.yml).

Estructura Jerárquica de compose.yaml

El archivo Compose organiza los recursos en cuatro bloques principales:

  • services: Define cada uno de los contenedores que forman parte de la arquitectura (por ejemplo: web, api, db).
  • networks: Define las redes virtuales compartidas para aislar la comunicación. Si no se especifican, Compose crea una red bridge por defecto para todo el proyecto.
  • volumes: Declara los volúmenes persistentes que deben sobrevivir al ciclo de vida de los contenedores.
  • secrets: Permite gestionar credenciales sensibles sin exponerlas en texto plano.

Comandos Esenciales de Docker Compose v2

📌 Nota sobre Docker Compose v2: En las versiones modernas de Docker, Compose es un plugin nativo del CLI. El comando estándar actual es docker compose (con espacio), reemplazando al binario antiguo en Python docker-compose (con guión).
  • docker compose up -d: Descarga imágenes, construye Dockerfiles, crea redes, volúmenes y levanta todos los servicios en segundo plano.
  • docker compose ps: Muestra el estado de salud y puertos de los servicios del stack.
  • docker compose logs -f [servicio]: Sigue los logs combinados de todos los contenedores o de uno en particular.
  • docker compose down: Detiene y elimina de forma limpia contenedores y redes creadas por el archivo compose.
  • docker compose down -v: Igual que down, pero además elimina los volúmenes declarados (¡cuidado con las bases de datos!).

⚡ Archivo compose.yaml Básico para una Aplicación Web

Ejemplo mínimo de un archivo compose.yaml que levanta un servidor Nginx con volumen de código y puerto expuesto:

compose.yaml
Solo lectura
# Archivo de Orquestación Estándar compose.yaml
services:
  servidor-web:
    image: nginx:alpine
    container_name: mi_sitio_web
    restart: unless-stopped
    ports:
      - "80:80"
    volumes:
      - ./sitio:/usr/share/nginx/html:ro
    environment:
      - TZ=America/Bogota

# Comandos en terminal para gestionar este stack:
# docker compose up -d     -> Levantar todo
# docker compose ps        -> Ver estado
# docker compose down      -> Detener y limpiar
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Cuál es el comando estándar actual para levantar todos los servicios definidos en compose.yaml en segundo plano?
🦉
¿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.