Apa itu build context dan mengapa menggunakan file .dockerignore?

Question

Accepted Answer

Saat Anda menjalankan `docker build`, Docker mengirimkan **build context** (file-file dalam direktori build) ke daemon. File **.dockerignore** mengecualikan file-file yang tidak diperlukan dari konteks ini — mempercepat build, mengurangi ukuran image, dan mencegah kebocoran file sensitif.

## Build context

```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 context** adalah kumpulan file yang Docker kirimkan ke daemon untuk membangun image. Semua file dalam direktori build disertakan kecuali dikecualikan — sehingga konteks yang membengkak memperlambat setiap build.

## .dockerignore — mengecualikan file yang tidak diperlukan

```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` bekerja seperti `.gitignore`, mengecualikan file dari build context.

## Mengapa ini penting (tiga manfaat)

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

## Mengapa ini penting

Memahami build context dan `.dockerignore` berharga untuk **build Docker yang efisien dan aman**, sehingga ini adalah pengetahuan yang sangat praktis dan berguna.

Banyak developer tidak menyadari bahwa `docker build .` mengirimkan **seluruh direktori build-context ke daemon** sebelum membangun — sehingga konteks yang membengkak (berisi `node_modules`, `.git`, artefak build, file-file besar) membuat **setiap build lebih lambat** (lebih banyak data untuk ditransfer dan diproses) dan berisiko menyalin file-file yang tidak diinginkan ke dalam image.

File **`.dockerignore`** (bekerja seperti `.gitignore`) mengatasi hal ini dengan tiga manfaat konkret: **build lebih cepat** (konteks yang lebih kecil ditransfer dan diproses lebih cepat, dan juga meningkatkan caching layer karena `COPY . .` tidak akan dihilangkan oleh perubahan pada file-file yang tidak relevan), **image lebih kecil** (file-file yang dikecualikan tidak disalin — misalnya tidak membundel `node_modules` lokal yang akan dipasang ulang), dan yang paling penting **keamanan** (menjaga **rahasia seperti file `.env`, kunci, dan kredensial tetap keluar dari build context dan image** — karena `COPY . .` seharusnya menyalin `.env` ke dalam image, risiko kebocoran kredensial yang nyata dan umum terjadi).

Manfaat keamanan ini sangat penting, karena secara tidak sengaja memanggang rahasia atau file sensitif ke dalam image melalui copy yang terlalu luas adalah kesalahan nyata yang `.dockerignore` membantu mencegah.

Karena build terjadi secara konstan dan efisiensi build, ukuran image, dan menghindari kebocoran rahasia semuanya penting, dan karena memahami build context dan menggunakan `.dockerignore` secara langsung meningkatkan ketiganya, memahami build context dan `.dockerignore` adalah pengetahuan Docker yang berharga dan relevan secara praktis — praktik sederhana namun penting untuk build yang cepat, ringkas, dan aman yang mudah diabaikan namun berdampak signifikan, terutama untuk mencegah penyertaan rahasia yang tidak disengaja dalam image.