Build context nedir ve neden .dockerignore dosyası kullanılır?

Question

Accepted Answer

`docker build` komutunu çalıştırdığınızda, Docker **build context**'i (build dizinindeki dosyalar) daemon'a gönderir. **.dockerignore** dosyası bu context'ten gereksiz dosyaları hariç tutar — build'leri hızlandırır, image boyutunu küçültür ve hassas dosyaların sızmasını önler.

## 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**, Docker'ın image'i oluşturmak için daemon'a gönderdiği dosya kümesidir. Build dizinindeki her şey hariç tutulmadığı sürece dahil edilir — bu nedenle şişkin bir context her build'i yavaşlatır.

## .dockerignore — gereksiz dosyaları hariç tutun

```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` `.gitignore` gibi çalışır ve dosyaları build context'ten hariç tutar.

## Neden önemli (üç fayda)

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

## Neden önemli

Build context'i ve `.dockerignore`'u anlamak, **verimli ve güvenli Docker build'leri** için değerlidir, bu nedenle pratik olarak faydalı bir bilgidir.

Birçok geliştirici, `docker build .` komutunun build'e başlamadan önce **tüm build-context dizinini daemon'a gönderdiğini** fark etmez — bu nedenle şişkin bir context (`node_modules`, `.git`, build artifacts, büyük dosyalar içeren) **her build'i daha yavaş hale getirir** (daha fazla veri transfer ve işlenme) ve istenmeyen dosyaların image'e kopyalanması riskini taşır.

**.dockerignore** dosyası (`.gitignore` gibi çalışarak) bunu üç somut faydayla giderir: **daha hızlı build'ler** (daha küçük bir context daha hızlı transfer ve işlenir, ayrıca `COPY . .` ilgisiz dosyalardaki değişikliklerle geçersiz kılınmayacağı için layer caching'i iyileştirir), **daha küçük image'ler** (hariç tutulan dosyalar kopyalanmaz — örneğin zaten yeniden yüklenen yerel `node_modules`'ün bundle edilmemesi), ve kritik olarak **güvenlik** (**`.env` dosyaları, anahtarlar ve kimlik bilgileri gibi sırları build context'ten ve image'ten uzak tutmak** — çünkü geniş kapsamlı `COPY . .` aksi takdirde `.env`'yi image'e kopyalardı, bu gerçek ve yaygın bir kimlik bilgisi sızıntısı riskidir).

Bu güvenlik faydası özellikle önemlidir, çünkü yanlışlıkla sırları veya hassas dosyaları geniş kapsamlı kopyalama yoluyla image'lere dahil etmek, `.dockerignore`'un önlenmesine yardımcı olduğu gerçek bir hatadır.

Build'ler sürekli gerçekleştiğinden ve build verimliliği, image boyutu ve sır sızıntılarından kaçınmak önemli olduğundan, ve build context'i ve `.dockerignore`'u anlamak ve kullanmak bu üçünü de doğrudan iyileştirdiğinden, build context'i ve `.dockerignore`'u anlamak değerli, pratik olarak ilgili Docker bilgisidir — hızlı, dar ve güvenli build'ler için basit ancak önemli bir uygulama olup, göz ardı edilmesi kolay ancak anlamlı bir şekilde etkilidir, özellikle de image'lere sırların yanlışlıkla dahil edilmesini önlemek için.