Çfarë është Docker Compose dhe pse ta përdorim atë?

Question

Accepted Answer

**Docker Compose** është një mjet për të përcaktuar dhe drejtuar **aplikacione me shumë kontejnerë** duke përdorur një fichier të vetëm YAML. Në vend që të ekzekutoni shumë komanda `docker run` me dorë, përshkruani të gjitha shërbimet tuaja (aplikacion, bazë të dhënash, cache) në `docker-compose.yml` dhe i nisni të gjitha me një komandë.

## Problemi që zgjidh 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.
```

## Një 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:
```

Një fichier përcakton të gjitha shërbimet, imazhet/ndërtimet e tyre, portat, mjedisin, volumet dhe varësitë — dhe ato ndajnë një rrjet (arrijnë njëri-tjetrin sipas emrit të shërbimit, p.sh. `db`).

## Ekzekutimi i stack-ut

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

## Pse ka rëndësi

Përnjohuringen e Docker Compose është e vlefshme sepse aplikacionet reale pothuajse gjithmonë përfshijnë **shumë kontejnerë**, dhe Compose është mjeti standard për t'i menaxhuar ato, kështu që është njohuri praktike e rëndësishme.

Problemi që zgjidh është real: një aplikacion tipik ka disa shërbime (një aplikacion në web, një bazë të dhënash, një cache, ndoshta një radhë mesazhi), dhe ekzekutimi manual i secilit me komanda të veçanta `docker run` — konfigurimi i portave, rrjeteve, volumeve, variablave të mjedisit dhe rendit të nisjes — është i lodhshëm, i ndjeshëm ndaj gabimeve dhe i vështirë për tu riprodukuar ose ndarë. **Compose** e adresson këtë duke përcaktuar **të gjithë stack-un me shumë kontejnerë në një fichier deklarativ YAML të vetëm** dhe i nisen të gjithë me një komandë të vetme (`docker compose up`), duke e bërë aplikacionet me shumë kontejnerë të lehta për t'u ekzekutuar, riprodukuar dhe ndarë.

Përnjohuringen e strukturës `docker-compose.yml` (përcaktimi i shërbimeve me imazhet/ndërtimet, portat, mjedisin, volumet dhe varësitë e tyre, me shërbime të rrjetëzuara automatikisht dhe të arritshme sipas emrit) dhe komandat kryesore (`up`, `down`, `ps`, `logs`) është njohuri praktike, përditësore për zhvillimin dhe për ekzekutimin e aplikacioneve me shumë shërbime.

Compose është veçanërisht i vlefshëm për **mjediset lokale të zhvillimit** (nisja e një aplikacioni me bazën e tij të dhënash dhe varësitë në një komandë) dhe për të përcaktuar stack-et e aplikacioneve në mënyrë të përsëritshme.

Duke qenë se aplikacionet reale janë zakonisht me shumë kontejnerë, dhe duke qenë se Docker Compose është mjeti standard, i përdorur gjerësisht për t'i përcaktuar dhe drejtuar ato thjesht (duke zëvendësuar orkestrimin e lodhshëm manual me një fichier dhe komandë deklarativi), të kuptuarit e Docker Compose — çfarë zgjidh, struktura e fichierit compose dhe komandat — është njohuri e vlefshme, e aplikuar shpesh për të punuar me aplikacione me shumë kontejnerë, një shoqërues pothuajse përbindës i Docker-it për çdo aplikacion të kontejnerizuar jo-trivial dhe një mjet i përhapje në flukset e punës zhvillim.