Co je Docker Compose a proč jej používat?

Question

Accepted Answer

**Docker Compose** je nástroj pro definování a spouštění **aplikací s více kontejnery** pomocí jednoho souboru YAML. Místo ručního spuštění mnoha příkazů `docker run` popíšete všechny své služby (aplikace, databáze, mezipaměť) v souboru `docker-compose.yml` a spustíte je dohromady jedním příkazem.

## Problém, který Compose řeší

```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.
```

## Soubor 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:
```

Jedin soubor definuje všechny služby, jejich image/buildy, porty, prostředí, svazky a závislosti — a všechny sdílejí síť (mohou se oslovit podle jména služby, například `db`).

## Spuštění zásobníku

```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
```

## Proč to je důležité

Rozmět Docker Compose je cenné znalosti, protože reálné aplikace téměř vždy zahrnují **více kontejnerů** a Compose je standardní nástroj pro jejich správu, takže jde o důležité praktické znalosti.

Problém, který řeší, je skutečný: typická aplikace má několik služeb (webová aplikace, databáze, mezipaměť, případně fronta zpráv) a ruční spuštění každé ze služeb pomocí samostatných příkazů `docker run` — s konfigurací portů, sítí, svazků, proměnných prostředí a pořadí spuštění — je únavné, náchylné k chybám a obtížně opakovatelné či sdílitelné. **Compose** řeší tento problém definováním **celého zásobníku s více kontejnery v jednom deklarativním souboru YAML** a spuštěním vše pomocí jednoho příkazu (`docker compose up`), čímž činí aplikace s více kontejnery snadné na spuštění, opakovatelné a sdílitelné.

Rozmět strukturu `docker-compose.yml` (definování služeb s jejich image/buildy, porty, prostředím, svazky a závislostmi, se službami automaticky připojenými v síti a dosažitelnými podle jména) a klíčové příkazy (`up`, `down`, `ps`, `logs`) je praktické, každodenní znalosti pro vývoj a spouštění aplikací s více službami.

Compose je zvláště cenný pro **lokální vývojová prostředí** (spuštění aplikace se svou databází a závislostmi jedním příkazem) a pro definování aplikačních zásobníků opakovatelným způsobem.

Protože reálné aplikace jsou typicky tvořeny více kontejnery a Docker Compose je standardní, rozšířeně používaný nástroj pro jejich definování a jednoduché spouštění (nahrazující únavnou manuální orchestraci jedním deklarativním souborem a příkazem), pochopení Docker Compose — co řeší, struktura compose souboru a příkazy — je cenné, často aplikované znalosti pro práci s aplikacemi s více kontejnery, téměř nezbytný doplněk k Dockeru pro jakoukoli netriviální kontejnerizovanou aplikaci a všudypřítomný nástroj ve vývojových pracovních tocích.