Mikä on build-konteksti ja miksi käyttää .dockerignore-tiedostoa?

Question

Accepted Answer

Kun suoritat `docker build`, Docker lähettää **build-kontekstin** (build-hakemiston tiedostot) daemonille. **.dockerignore**-tiedosto jättää pois tarpeettomat tiedostot tästä kontekstista — nopeuttaa rakentamista, pienentää kuvan kokoa ja estää arkaluontoisten tiedostojen vuotamisen.

## Build-konteksti

```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-konteksti** on joukko tiedostoja, joita Docker lähettää daemonille kuvan rakentamista varten. Kaikki build-hakemistossa olevat tiedostot sisällytetään, ellei niitä poisteta — joten paisunut konteksti hidastaa jokaista rakentamista.

## .dockerignore — jätä pois tarpeettomat tiedostot

```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` toimii kuten `.gitignore`, jättäen tiedostot pois build-kontekstista.

## Miksi se on tärkeää (kolme hyötyä)

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

## Miksi se on tärkeää

Build-kontekstin ja `.dockerignore`-tiedoston ymmärtäminen on arvokasta **tehokkaille ja turvallisille Docker-rakennuksille**, joten se on käytännöllinen tieto.

Monet kehittäjät eivät ymmärrä, että `docker build .` lähettää **koko build-konteksti-hakemiston daemonille** ennen rakentamista — joten paisunut konteksti (sisältäen `node_modules`, `.git`, rakennusartefaktit, suuret tiedostot) tekee **jokaisen rakentamisen hitaammaksi** (enemmän dataa siirrettäväksi ja käsiteltäväksi) ja riskeeraaa kopioida ei-toivottuja tiedostoja kuvaan.

**.dockerignore**-tiedosto (toimii kuten `.gitignore`) ratkaisee tämän kolmella konkreettisella hyödyllä: **nopeammat rakentamiset** (pienempi konteksti siirtyy ja käsitellään nopeammin, ja parantaa myös kerrosvälimuistoa koska `COPY . .` ei valistu asiattomien tiedostojen muutoksiin), **pienemmät kuvat** (poissuljetut tiedostot eivät kopioidu — esim. paikallista `node_modules`-hakemistoa ei niputeta, se asennetaan joka tapauksessa uudelleen), ja erityisen tärkeää **turvallisuus** (pitää **salaisuudet kuten `.env`-tiedostot, avaimet ja tunnistetiedot pois build-kontekstista ja kuvasta** — koska `COPY . .` muuten kopioisi `.env`-tiedoston kuvaan, todellinen ja yleinen tunnistetietojen vuotoriski).

Tämä turvallisuusetu on erityisen tärkeä, koska salaisuuksien tai arkaluontoisten tiedostojen vahingossa paistaminen kuviin liian laajalla kopiolla on oikea virhe, jonka `.dockerignore` auttaa estämään.

Koska rakentamisia tapahtuu jatkuvasti ja rakentamisen tehokkuus, kuvan koko ja salaisuuksien vuotamisen välttäminen kaikki ovat tärkeitä, ja koska build-kontekstin ja `.dockerignore`-tiedoston ymmärtäminen ja käyttäminen parantaa suoraan kaikkia kolmea, build-kontekstin ja `.dockerignore`-tiedoston ymmärtäminen on arvokasta, käytännöllistä Docker-tietoa — yksinkertainen mutta tärkeä käytäntö nopeisiin, kevyisiin ja turvallisiin rakennuksiin, joka on helppo sivuuttaa mutta merkityksellisesti vaikuttava, erityisesti salaisuuksien vahingossa pääsemisen estämisessä kuviin.