Što je Dockerfile i kako se piše?

Question

Accepted Answer

**Dockerfile** je tekstualna datoteka s uputama za **izgradnju Docker slike** — opisuje osnovnu sliku, ovisnosti, datoteke za kopiranje i kako pokrenuti aplikaciju. Čini izgradnju slike ponovljivom i kontroliranom verzijom.

## Osnovni 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"]
```

## Ključne upute

```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 (često zbunjujuće)

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

## Zašto je to važno

Razumijevanje Dockerfilea je neophodno jer se Docker slike grade na osnovu njega, pa je pisanje Dockerfilea temeljna, svakodnevna Docker vještina.

Dockerfile omogućava **ponovljive, verziju kontrolirane gradnje slika** — opisuje u kodu točno kako konstruirati sliku (osnovnu sliku, ovisnosti, datoteke, konfiguraciju i naredbu za pokretanje), tako da svatko može dosljedno graditi istu sliku, što je srž Dockerove vrijednosti reproducibilnosti.

Razumijevanje **ključnih uputa** — `FROM` (osnovna slika), `WORKDIR`, `COPY` (unošenje datoteka), `RUN` (izvršavanje naredbi tijekom gradnje kao što je instalacija ovisnosti), `ENV`, `EXPOSE` i `CMD`/`ENTRYPOINT` (određivanje što se pokreće kada se kontejner pokrene) — neophodno je za pisanje učinkovitih Dockerfilea za stvarne aplikacije.

Osobito važna i često zbunjujuća razlika je **`RUN` vs `CMD` vs `ENTRYPOINT`**: `RUN` se izvršava u **vremenu gradnje** (konstruiranje slike, npr. instalacija paketa), dok `CMD`/`ENTRYPOINT` određuju što se pokreće pri **pokretanju kontejnera** (naredba aplikacije) — razumijevanje toga sprječava česte greške.

Znanje praktičnih uzoraka (kao što je kopiranje datoteka ovisnosti prije koda za bolji cache slojeva) odražava pisanje učinkovitih Dockerfilea.

Budući da je gradnja slika temeljna za korištenje Dockera (svaki Docker tijek rada uključuje slike, a Dockerfile je kako se grade prilagođene slike), i budući da je razumijevanje uputa i razlike između vremena gradnje i izvođenja potrebno za stvaranje ispravnih i učinkovitih slika, razumijevanje Dockerfilea je neophodno, često primjenjivano Docker znanje — temeljna vještina za svakoga tko koristi Docker, mehanizam koji Dockerovu objeću reproducibilnosti pretvara u praksu i gotovo univerzalni zahtjev za kontejnerizacijom aplikacija.