Kas yra kūrimo kontekstas ir kodėl naudoti .dockerignore failą?

Question

Accepted Answer

Kai paleisite `docker build`, Docker siunčia **kūrimo kontekstą** (failus kūrimo kataloge) demonui. **.dockerignore** failas išskiria nereikalingus failus iš šio konteksto — pagreitina kūrimą, sumažina vaizdo dydį ir neleidžia saugotiems failams pradūrti.

## Kūrimo kontekstas

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

**Kūrimo kontekstas** yra failų rinkinys, kurį Docker siunčia demonui vaizdo kūrimui. Visi failai kūrimo kataloge yra įtraukti, jei neatskleisti — todėl išpūstas kontekstas sulėtina kiekvieną kūrimą.

## .dockerignore — išskleisti nereikalingus failus

```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` veikia kaip `.gitignore`, išskleidžiant failus iš kūrimo konteksto.

## Kodėl tai svarbu (trys privalumai)

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

## Kodėl tai svarbu

Supratimas apie kūrimo kontekstą ir `.dockerignore` yra vertingas **efektyvų ir saugų Docker kūrimui**, todėl tai yra praktiškai naudinga žinotina.

Daug kūrėjų nežino, kad `docker build .` siunčia **visą kūrimo konteksto katalogą demonui** prieš kūrimą — todėl išpūstas kontekstas (kuriame yra `node_modules`, `.git`, kūrimo artefaktai, dideli failai) daro **kiekvieną kūrimą lėtesnį** (daugiau duomenų persiųsti ir apdoroti) ir rizikuoja į vaizdo kopijuoti nereikalingus failus.

**.dockerignore** failas (veikdamas kaip `.gitignore`) tai sprendžia trimis konkrečiais privalumais: **greitesni kūrimai** (mažesnis kontekstas persiųsti ir apdoroti greičiau, taip pat pagerina sluoksnio cache, nes `COPY . .` nebus nepatiklintas dėl irrelevantinių failų pokyčių), **mažesni vaizdai** (išskleidžiami failai nebus kopijuoti — pvz., neleidžiama supakavioti lokalaus `node_modules`, kuris ir taip bus iš naujo įdiegtas), ir svarbiausiai **saugumas** (laikyti **paslaptis kaip `.env` failai, raktai ir kredencialai iš kūrimo konteksto ir vaizdo** — nes `COPY . .` priešingu atveju nukopijuotų `.env` į vaizdo, realus ir dažnas kredencialų nuotėkio rizika).

Šis saugumo privalumas yra ypač svarbus, nes netyčia įbakinti paslaptis arba jautrius failus į vaizdus per per platų kopijuojimą yra tikra klaida, kurios `.dockerignore` padeda išvengti.

Kadangi kūrimai vyksta nuolat ir kūrimo efektyvumas, vaizdo dydis ir paslaptybių nuotėkio vengimas yra svarbūs, ir kadangi supratimas apie kūrimo kontekstą ir `.dockerignore` naudojimas tiesiogiai pagerina visus tris, supratimas apie kūrimo kontekstą ir `.dockerignore` yra vertingas, praktiškai aktualus Docker žinojimas — paprasta, bet svarbi praktika greitiems, kompaktiems ir saugiems kūrimams, kurią lengva nepastebėti, tačiau ji yra reikšmingai poveikinga, ypač norint išvengti netyčaus paslaptybių įtraukimo į vaizdus.