Kaj je Docker Compose in zakaj ga uporabljamo?

Question

Accepted Answer

**Docker Compose** je orodje za definiranje in poganjanje **aplikacij z več vsebniki** z eno samo YAML datoteko. Namesto ročnega zagona številnih `docker run` ukazov opišete vse svoje storitve (aplikacija, baza podatkov, predpomnilnik) v `docker-compose.yml` in jih zaženete skupaj z enim ukazom.

## Problem, ki ga rešuje Compose

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

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

Ena datoteka definira vse storitve, njihove slike/gradnje, vrata, okolje, zvezke in odvisnosti — in si delijo omrežje (doseganje med seboj po imenu storitve, npr. `db`).

## Poganjanje sklada

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

## Zakaj je to pomembno

Razumevanje Docker Composea je dragoceno, ker pravi aplikacije skoraj vedno vključujejo **več vsebnikov**, in Compose je standardno orodje za njihovo upravljanje, zato je to pomembno praktično znanje.

Problema, ki ga rešuje, je resničen: tipična aplikacija ima več storitev (spletna aplikacija, baza podatkov, predpomnilnik, morda vrsta sporočil), in ročno poganjanje vsake s ločenimi `docker run` ukazi — s konfiguriranjem vrat, omrežij, zvezkov, spremenljivk okolja in vrstnega reda zagona — je naporno, dovzetno za napake in težko reproducirati ali deliti. **Compose** to reši z definiranjem **celotnega sklada z več vsebniki v eni deklarativni YAML datoteki** in zagonom vsega z enim ukazom (`docker compose up`), kar naredi aplikacije z več vsebniki enostavne za poganjanje, reproduciranje in deljenje.

Razumevanje strukture `docker-compose.yml` (definiranje storitev s svojimi slikami/gradnjami, vrati, okoljem, zvezki in odvisnostmi, pri čemer so storitve avtomatsko povezane v omrežje in dosegljive po imenu) in ključnih ukazov (`up`, `down`, `ps`, `logs`) je praktično, vsakodnevno znanje za razvoj in poganjanje aplikacij z več storitvami.

Compose je posebej dragocen za **lokalna razvojna okolja** (zagon aplikacije s svojo bazo podatkov in odvisnostmi v enem ukazu) in za reproducibilno definiranje aplikacijskih skladov.

Ker so prave aplikacije ponavadi aplikacije z več vsebniki, in ker je Docker Compose standardno, pogosto uporabljeno orodje za njihovo enostavno definiranje in poganjanje (zamenjava tednika ročne orkestracije z eno deklarativno datoteko in ukazom), je razumevanje Docker Composea — kaj rešuje, struktura datoteke compose in ukazi — dragoceno, pogosto uporabljano znanje za delo z aplikacijami z več vsebniki, praktično nepogrešljiv spremljevalec Docker-ja za katero koli kompleksnejšo aplikacijo v vsebnikih in vseprisotno orodje v razvojnih poteh.