Kaj je kontekst gradnje in zakaj uporabiti datoteko .dockerignore?

Question

Accepted Answer

Ko zaženete `docker build`, Docker pošlje **kontekst gradnje** (datoteke v direktoriju gradnje) daemonu. Datoteka **.dockerignore** izključi nepotrebne datoteke iz tega konteksta — pospešuje gradnje, zmanjšuje velikost slike in preprečuje puščanje občutljivih datotek.

## Kontekst gradnje

```bash
docker build -t myapp .     # the "." is the build context — the directory sent to the daemon
# → Docker tarballs the ENTIRE context directory and sends it to the daemon BEFORE building
# → a big context (node_modules, .git, large files) = slow builds, more data transferred
```

**Kontekst gradnje** je nabor datotek, ki jih Docker pošlje daemonu za gradnjo slike. Vse v direktoriju gradnje je vključeno, razen če je izključeno — zato preplavljeni kontekst upočasni vsako gradnjo.

## .dockerignore — izključitev nepotrebnih datotek

```text
# .dockerignore (like .gitignore, for the build context)
node_modules        # don't send local deps (they're installed in the image anyway)
.git                # don't send version history
*.log
.env                # ⚠️ don't send SECRETS into the build context/image
Dockerfile
dist
.vscode
```

`.dockerignore` deluje kot `.gitignore`, izključuje datoteke iz konteksta gradnje.

## Zakaj je to pomembno (tri prednosti)

```text
✓ FASTER builds — a smaller context transfers faster; fewer files to process
  (also helps caching: COPY . . won't be invalidated by irrelevant file changes)
✓ SMALLER images — excluded files (node_modules, .git) don't get COPYed into the image
✓ SECURITY — keep SECRETS (.env, keys, credentials) out of the context AND the image
  (a COPY . . could otherwise copy a .env file into the image — a real leak risk)
```

## Zakaj je to pomembno

Razumevanje konteksta gradnje in `.dockerignore` je dragoceno za **učinkovite in varne Docker gradnje**, zato je to praktično uporabno znanje.

Mnogi razvijalci se ne zavedajo, da `docker build .` pošlje **celoten direktorij konteksta gradnje daemonu** pred gradnjo — tako da preplavljeni kontekst (vsebina `node_modules`, `.git`, gradilnih artefaktov, velikih datotek) naredi **vsako gradnjo počasnejšo** (več podatkov za prenos in obdelavo) in tvega kopiranje neželjenih datotek v sliko.

Datoteka **`.dockerignore`** (ki deluje kot `.gitignore`) to rešuje s tremi konkretnimi prednostmi: **hitrejše gradnje** (manjši kontekst se hitreje prenese in obdela, poleg tega izboljša predpomnenje plasti, ker `COPY . .` ne bo razveljavljena s spremembami nepomembnih datotek), **manjše slike** (izključene datoteke se ne kopirajo — npr. ne paketiranje lokalnega `node_modules`, ki se tako ali tako ponovno namesti), in ključno **varnost** (ohranitev **skrivnosti, kot so `.env` datoteke, ključi in poverilnice izven konteksta gradnje in slike** — saj bi `COPY . .` sicer kopirala `.env` v sliko, kar je prava in pogosta tveganja puščanja poverilnic).

Ta varnostna prednost je posebno pomembna, saj je slučajno pečenje skrivnosti ali občutljivih datotek v slike preko preplavljenega kopiranja prava napaka, ki jo `.dockerignore` pomaga preprečiti.

Ker se gradnje dogajajo stalno in so učinkovitost gradnje, velikost slike ter izogibanje puščanju skrivnosti vse pomembne, in ker razumevanje konteksta gradnje in uporaba `.dockerignore` neposredno izboljšata vse tri, je razumevanje konteksta gradnje in `.dockerignore` dragoceno, praktično relevantno Docker znanje — enostavna, a pomembna praksa za hitre, vitke in varne gradnje, ki je enostavno spregledati, a smiselno učinkovita, zlasti za preprečevanje slučajnega vključevanja skrivnosti v slike.