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
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:
# 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¿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.