Što je Docker Compose i zašto ga koristiti?

Question

Accepted Answer

**Docker Compose** je alat za definiranje i pokretanje **aplikacija s više kontejnera** koristeći jednu YAML datoteku. Umjesto ručnog pokretanja više `docker run` naredbi, opisujete sve svoje servise (aplikaciju, bazu podataka, cache) u `docker-compose.yml` i pokrećete ih zajedno jednom naredbom.

## Problem koji Compose rješava

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

## Docker-compose.yml datoteka

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

Jedna datoteka definira sve servise, njihove slike/gradnje, portove, okruženja, volumene i ovisnosti — i dijele mrežu (dosežu se međusobno po imenu servisa, npr. `db`).

## Pokretanje stacka

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

## Zašto je važno

Razumijevanje Docker Composea je vrijedno jer prave aplikacije gotovo uvijek uključuju **više kontejnera**, a Compose je standardni alat za njihovo upravljanje, pa je to važno praktičko znanje.

Problem koji rješava je stvaran: tipična aplikacija ima nekoliko servisa (web aplikacija, baza podataka, cache, eventualno red čekanja za poruke), a ručno pokretanje svakog zasebnom `docker run` naredbom — konfiguriranje portova, mreža, volumena, varijabli okruženja i redoslijeda pokretanja — je dosadno, sklono greškama i teško za reproduciranje ili dijelenje. **Compose** to rješava definiranjem **cijelog multi-kontejner stacka u jednoj deklarativnoj YAML datoteci** i pokretanjem svega jednom naredbom (`docker compose up`), čineći multi-kontejner aplikacije laganima za pokretanje, reproduciranje i dijelenje.

Razumijevanje strukture `docker-compose.yml` (definiranje servisa s njihovim slikama/gradnjama, portovima, okruženjima, volumenima i ovisnostima, sa servisima automatski umreženim i dostupnim po imenu) i ključnim naredbama (`up`, `down`, `ps`, `logs`) je praktično, svakodnevno znanje za razvoj i pokretanje aplikacija s više servisa.

Compose je posebno vrijedan za **lokalna razvojna okruženja** (pokretanje aplikacije s njezinom bazom podataka i ovisnostima jednom naredbom) i za deklarativno definiranje application stackova.

Budući da su prave aplikacije obično multi-kontejner, a budući da je Docker Compose standardni, široko korišten alat za njihovo jednostavno definiranje i pokretanje (zamjenjujući dosadnu ručnu orkestraciju jednom deklarativnom datotekom i naredbom), razumijevanje Docker Composea — što rješava, struktura compose datoteke i naredbe — je vrijedno, često primjenjivano znanje za rad s multi-kontejner aplikacijama, gotovo neophodan pratilac Dockeru za bilo koju ne-trivialnu kontejneriziranu aplikaciju i sveprisutni alat u tokovima razvoja.