Kaj je Dockerfile in kako ga napišeš?

Question

Accepted Answer

**Dockerfile** je besedilna datoteka z navodili za **gradnjo Docker slike** — opisuje osnovno sliko, odvisnosti, datoteke za kopiranje in kako poganjati aplikacijo. Omogoča ponovljive in verzionske kontrolirane gradnje slik.

## 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čna navodila

```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 (pogosto zamenjano)

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

## Zakaj je to pomembno

Razumevanje Dockerfile-a je bistveno, ker je to način, na katerega se gradijo Docker slike, zato je pisanje Dockerfile-a temeljna, vsakodnevna Docker veščina.

Dockerfile zagotavlja **ponovljive, verzionsko nadzovane gradnje slik** — opisuje v kodi natanko, kako zgraditi sliko (osnovna slika, odvisnosti, datoteke, konfiguracija in ukaz za zagon), tako da lahko kdorkoli gradi isto sliko dosledno, kar je osrednjega pomena za Dockerjevo vrednost ponovljivosti.

Razumevanje **ključnih navodil** — `FROM` (osnovna slika), `WORKDIR`, `COPY` (prinesemo datoteke), `RUN` (izvršavanje ukazov ob gradnji, kot je namestitev odvisnosti), `ENV`, `EXPOSE` in `CMD`/`ENTRYPOINT` (definira, kaj se zažene, ko se vsebnik zažene) — je potrebno za pisanje učinkovitih Dockerfile-ov za prave aplikacije.

Posebno pomembna in pogosto zamenjana razlika je **`RUN` vs `CMD` vs `ENTRYPOINT`**: `RUN` se izvršuje ob **gradnji** (gradnja slike, npr. namestitev paketov), medtem ko `CMD`/`ENTRYPOINT` definirata, kaj se zažene ob **zagonu vsebnika** (ukaz aplikacije) — razumevanje tega prepreči pogosto napake.

Znanje praktičnih vzorcev (kot je kopiranje datotek odvisnosti pred kodo za boljše predpomnenje plasti) odraža pisanje učinkovitih Dockerfile-ov.

Ker je gradnja slik temeljna za uporabo Dockerja (vsak Docker delovni tok vključuje slike in Dockerfile je način, na katerega se gradijo po meri narejene slike), in ker razumevanje navodil ter razlike med gradnjo in izvajanjem je potrebno za ustvarjanje pravilnih in učinkovitih slik, je razumevanje Dockerfile-a bistveno, pogosto uporabljano Docker znanje — temeljna veščina za vse, ki uporabljajo Docker, mehanizem, ki Dockerjevo obljubo ponovljivosti spremeni v prakso in skoraj univerzalna zahteva za kontejneriziranje aplikacij.