Dockerfile nedir ve nasıl yazılır?

Question

Accepted Answer

**Dockerfile**, bir Docker imajı oluşturmak için talimatlar içeren metin dosyasıdır — temel imajı, bağımlılıkları, kopyalanacak dosyaları ve uygulamanın nasıl çalıştırılacağını açıklar. İmaj derlemelerini yinelenebilir ve sürüm kontrolü altında hale getirir.

## Basit bir Dockerfile

```dockerfile
# FROM — the base image to build on
FROM node:20-alpine

# WORKDIR — set the working directory inside the image
WORKDIR /app

# COPY dependency files first (for better layer caching)
COPY package*.json ./
# RUN — execute a command during the BUILD (install dependencies)
RUN npm install

# COPY the rest of the application code
COPY . .

# EXPOSE — document the port the app listens on
EXPOSE 3000

# CMD — the command to run when a CONTAINER starts
CMD ["node", "server.js"]
```

## Önemli talimatlar

```text
FROM     → the base image (starting point) — REQUIRED, usually first
WORKDIR  → set the working directory for subsequent instructions
COPY/ADD → copy files from the host into the image
RUN      → execute a command at BUILD time (install packages, compile) → creates a layer
ENV      → set environment variables
EXPOSE   → document which port(s) the container listens on
CMD      → the default command to run when the container STARTS (one per Dockerfile)
ENTRYPOINT → the executable that runs (CMD provides default args to it)
ARG      → build-time variables
```

## RUN vs CMD vs ENTRYPOINT (sık karıştırılan)

```text
RUN        → runs at BUILD time (builds the image — e.g. install dependencies)
CMD        → runs at CONTAINER START (the default command; overridable at run)
ENTRYPOINT → the main executable at start (CMD becomes its default arguments)
→ RUN builds the image; CMD/ENTRYPOINT define what runs when it starts.
```

## Neden önemli

Dockerfile'ı anlamak önemlidir çünkü Docker imajları bu şekilde oluşturulur; bu nedenle bir Dockerfile yazmak temel, günlük bir Docker becerisidir.

Bir Dockerfile, **yinelenebilir, sürüm kontrolü altında imaj derlemeleri** sağlar — bir imajın nasıl oluşturulacağını kodda tam olarak açıklar (temel imaj, bağımlılıklar, dosyalar, yapılandırma ve çalıştırma komutu), böylece herkes aynı imajı tutarlı bir şekilde oluşturabilir; bu, Docker'ın yinelenebilirlik değerinin merkezindedir.

**Önemli talimatları** anlamak — `FROM` (temel imaj), `WORKDIR`, `COPY` (dosyaları içeri getirme), `RUN` (derleme zamanı komutlarını çalıştırma; örneğin bağımlılık yükleme), `ENV`, `EXPOSE` ve `CMD`/`ENTRYPOINT` (konteyner başladığında çalışacak komutu tanımlama) — gerçek uygulamalar için etkili Dockerfiles yazmak için gereklidir.

Özellikle önemli ve sık karıştırılan bir ayrım **`RUN` vs `CMD` vs `ENTRYPOINT`**'tir: `RUN` **derleme zamanında** yürütülür (imajı oluşturma; örneğin paketler yükleme), `CMD`/`ENTRYPOINT` ise **konteyner başladığında** ne çalışacağını tanımlar (uygulama komutu) — bu farkı anlamak yaygın hataları önler.

Praktik kalıpları bilmek (örneğin daha iyi katman önbelleği için bağımlılık dosyalarını kodu kopyalamadan önce kopyalamak) etkili Dockerfiles yazışını yansıtır.

Imaj derlemek Docker'ı kullanmanın temel bir öğesi olduğundan (her Docker iş akışı imajları içerir ve Dockerfile özel imajların nasıl oluşturulduğudur) ve talimatları ve derleme zamanı-çalışma zamanı ayrımını anlamak doğru, etkili imajlar oluşturmak için gerekli olduğundan, Dockerfile'ı anlamak sık uygulanan, gerekli Docker bilgisidir — Docker kullanan herkesin sahip olması gereken temel beceri; Docker'ın yinelenebilirlik vaadini pratiğe dönüştürme mekanizması ve uygulamaları konteynerleştirmenin neredeyse evrensel gereksinimi.