¿Qué es Docker Compose y por qué usarlo?

Question

Accepted Answer

**Docker Compose** es una herramienta para definir y ejecutar **aplicaciones de múltiples contenedores** utilizando un único archivo YAML. En lugar de ejecutar muchos comandos `docker run` manualmente, describes todos tus servicios (app, base de datos, caché) en `docker-compose.yml` e inicias todos juntos con un único comando.

## Por qué es importante

```text
A real app often has MULTIPLE containers: a web app + a database + a cache + ...
  → manually running each with docker run (ports, networks, volumes, env, dependencies)
    is tedious, error-prone, and hard to reproduce/share
→ Compose defines the WHOLE stack in one file → start it all with one command.
```

## Un docker-compose.yml

```yaml
services:
  web:
    build: .                    # build from the local Dockerfile
    ports:
      - "3000:3000"             # map ports
    environment:
      - DATABASE_URL=postgres://db:5432/myapp
    depends_on:
      - db                       # start db before web
  db:
    image: postgres:16           # use a prebuilt image
    environment:
      - POSTGRES_PASSWORD=secret
    volumes:
      - dbdata:/var/lib/postgresql/data   # persist the database
volumes:
  dbdata:
```

Un archivo define todos los servicios, sus imágenes/compilaciones, puertos, entorno, volúmenes y dependencias — y comparten una red (accediéndose entre sí por nombre de servicio, p. ej. `db`).

## Ejecutando el stack

```bash
docker compose up -d        # build and start ALL services (in the background)
docker compose ps           # list the running services
docker compose logs -f      # view logs from all services
docker compose down         # stop and remove everything
docker compose down -v      # also remove volumes
```

## Por qué es importante

Comprender Docker Compose es valioso porque las aplicaciones reales casi siempre involucran **múltiples contenedores**, y Compose es la herramienta estándar para gestionarlos, por lo que es conocimiento práctico importante.

El problema que resuelve es real: una aplicación típica tiene varios servicios (una aplicación web, una base de datos, un caché, quizá una cola de mensajes), y ejecutar manualmente cada uno con comandos `docker run` separados — configurando puertos, redes, volúmenes, variables de entorno y orden de inicio — es tedioso, propenso a errores y difícil de reproducir o compartir. **Compose** aborda esto definiendo el **stack completo de múltiples contenedores en un único archivo YAML declarativo** e iniciando todo con un solo comando (`docker compose up`), haciendo que las aplicaciones de múltiples contenedores sean fáciles de ejecutar, reproducir y compartir.

Comprender la estructura de `docker-compose.yml` (definiendo servicios con sus imágenes/compilaciones, puertos, entorno, volúmenes y dependencias, con servicios automáticamente conectados en red y accesibles por nombre) y los comandos clave (`up`, `down`, `ps`, `logs`) es conocimiento práctico, cotidiano para desarrollo y para ejecutar aplicaciones multi-servicio.

Compose es especialmente valioso para **entornos de desarrollo local** (iniciando una aplicación con su base de datos y dependencias en un solo comando) y para definir stacks de aplicaciones reproducibles.

Ya que las aplicaciones reales son típicamente multi-contenedor, y ya que Docker Compose es la herramienta estándar, ampliamente utilizada para definir y ejecutarlas simplemente (reemplazando la tedious orquestación manual con un archivo declarativo y un comando), comprender Docker Compose — qué resuelve, la estructura del archivo de composición y los comandos — es conocimiento valioso, frecuentemente aplicado para trabajar con aplicaciones multi-contenedor, un complemento casi esencial para Docker para cualquier aplicación contenerizada no trivial y una herramienta omnipresente en flujos de trabajo de desarrollo.