Što je build kontekst i zašto koristiti .dockerignore datoteku?

Question

Accepted Answer

Kada pokrenete `docker build`, Docker šalje **build kontekst** (datoteke u direktoriju za izgradnju) daemonu. Datoteka **.dockerignore** isključuje nepotrebne datoteke iz ovog konteksta — ubrzavajući izgradnje, smanjujući veličinu slike i sprječavajući curenje osjetljivih datoteka.

## Build kontekst

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

**Build kontekst** je skup datoteka koje Docker šalje daemonu za izgradnju slike. Sve datoteke u direktoriju za izgradnju su uključene osim ako nisu isključene — pa prepunjen kontekst usporava svaku izgradnju.

## .dockerignore — isključite nepotrebne datoteke

```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` funkcionira kao `.gitignore`, isključujući datoteke iz build konteksta.

## Zašto je to važno (tri koristi)

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

## Zašto je to važno

Razumijevanje build konteksta i `.dockerignore` je vrijedno za **učinkovite i sigurne Docker izgradnje**, pa je to praktično korisno znanje.

Mnogi razvijatelji ne shvaćaju da `docker build .` šalje **cijeli direktorij build-konteksta daemonu** prije izgradnje — pa prepunjen kontekst (koji sadrži `node_modules`, `.git`, artefakte izgradnje, velike datoteke) čini **svaku izgradnju sporijijom** (više podataka za prijenos i obradu) i rizikuje kopiranje neželjenih datoteka u sliku.

Datoteka **`.dockerignore`** (funkcionira kao `.gitignore`) to rješava s tri konkretne koristi: **brže izgradnje** (manji kontekst se brže prenosi i obrađuje, te poboljšava keširanje slojeva jer `COPY . .` neće biti nevalidiran promjenama u irelevantnim datotekama), **manje slike** (isključene datoteke se ne kopiraju — npr. ne pakirajući lokalni `node_modules` koji se ionako ponovno instaliraju), i važno **sigurnost** (čuvajući **tajne poput `.env` datoteka, ključeva i kredencijala van build konteksta i slike** — jer bi inače `COPY . .` kopirala `.env` u sliku, stvaran i čest rizik curenja kredencijala).

Ova sigurnosna korist je posebno važna, jer slučajno ugrađivanje tajni ili osjetljivih datoteka u slike kroz previše široku kopiju je prava greška koju `.dockerignore` pomaže spriječiti.

Budući da izgradnje happening konstantno i učinkovitost izgradnje, veličina slike i izbjegavanje curenja tajni su važni, i budući da razumijevanje build konteksta i korištenje `.dockerignore` direktno poboljšavaju sva tri aspekta, razumijevanje build konteksta i `.dockerignore` je vrijedno, praktično relevantno Docker znanje — jednostavna ali važna praksa za brze, vitke i sigurne izgradnje koja je lako previdjeti ali značajno utjecajna, osobito za sprječavanje slučajnog uključivanja tajni u slike.