Ce este Docker Compose și de ce să-l folosești?

Question

Accepted Answer

**Docker Compose** este un instrument pentru definirea și rularea **aplicațiilor multi-container** folosind un singur fișier YAML. În loc să rulezi manual multe comenzi `docker run`, descrii toate serviciile tale (aplicație, bază de date, cache) în `docker-compose.yml` și le pornești împreună cu o singură comandă.

## Problema pe care Compose o rezolvă

```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 fișier definește toate serviciile, imaginile/build-urile, porturile, variabilele de mediu, volumele și dependențele — și acestea partajează o rețea (ajungând una la alta prin numele serviciului, de ex. `db`).

## Rularea stack-ului

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

## De ce este important

Înțelegerea Docker Compose este valoroasă deoarece aplicațiile reale implică aproape întotdeauna **multiple containere**, iar Compose este instrumentul standard pentru gestionarea lor, deci este o cunoaștere practică importantă.

Problema pe care o rezolvă este reală: o aplicație tipică are mai multe servicii (o aplicație web, o bază de date, un cache, poate o coadă de mesaje), și rularea manuală a fiecăreia cu comenzi separate `docker run` — configurând porturi, rețele, volume, variabile de mediu și ordinea de pornire — este plictisitoare, predispusă la erori și greu de reprodus sau împărtășit. **Compose** abordează aceasta prin definirea **întregului stack multi-container într-un singur fișier YAML declarativ** și pornirea tuturor cu o singură comandă (`docker compose up`), făcând aplicațiile multi-container ușor de rulat, reprodus și împărtășit.

Înțelegerea structurii `docker-compose.yml` (definind servicii cu imaginile/build-urile, porturile, variabilele de mediu, volumele și dependențele lor, cu serviciile automaticamente în rețea și accesibile după nume) și comenzile cheie (`up`, `down`, `ps`, `logs`) este o cunoaștere practică, cotidiană pentru dezvoltare și rularea aplicațiilor multi-servicii.

Compose este deosebit de valoros pentru **mediile locale de dezvoltare** (pornind o aplicație cu baza sa de date și dependențele într-o singură comandă) și pentru definirea stack-urilor de aplicații reproducibil.

Deoarece aplicațiile reale sunt de obicei multi-container, și deoarece Docker Compose este instrumentul standard, utilizat pe scară largă pentru definirea și rularea lor simplu (înlocuind orkestrarea manuală plictisitoare cu un singur fișier și comandă declarative), înțelegerea Docker Compose — ceea ce rezolvă, structura fișierului compose și comenzile — este o cunoaștere valoroasă, frecvent aplicată pentru lucrul cu aplicații multi-container, o companion aproape esențial pentru Docker pentru orice aplicație containerizată netrivială și un instrument omniprezent în fluxurile de lucru de dezvoltare.