Çfarë është një Dockerfile dhe si e shkruani atë?

Question

Accepted Answer

Një **Dockerfile** është një skedar teksti me udhëzime për **ndërtimin e një imazhi Docker** — ai përshkruan imazhin bazë, varësitë, skedarët për të kopjuar dhe si të ekzekutohet aplikacioni. Ai e bën ndërtimin e imazheve të përsëritshëm dhe të kontrolluar për version.

## Një Dockerfile bazik

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

## Udhëzime kryesore

```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 (zakonisht ngatërruesit)

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

## Pse ka rëndësi

Komprensimi i Dockerfile është thelbësor sepse është mënyra se si ndërtohen imazhet Docker, kështu që shkrimi i tij është një aftësi themelore, përditore Docker.

Një Dockerfile siguron **ndërtimin e imazheve të përsëritshëm, të kontrolluar për version** — duke përshkruar në kod saktësisht se si të ndërtoni një imazh (imazhi bazë, varësitë, skedarët, konfigurimi dhe komanda ekzekutimi), kështu që këdo mund të ndërtojë të njëjtin imazh në mënyrë të qëndrueshme, e cila është qendrore për vlerën e Docker të përsëritshëmrisë.

Komprensimi i **udhëzimeve kryesore** — `FROM` (imazhi bazë), `WORKDIR`, `COPY` (sjelljet e skedarëve), `RUN` (ekzekutimi i komandave ndërtime si instalimi i varësive), `ENV`, `EXPOSE` dhe `CMD`/`ENTRYPOINT` (përcaktimi se çfarë ekzekutohet kur konteneri fillon) — është i nevojshëm për të shkruar Dockerfile efektive për aplikacione reale.

Një dallim veçanërisht i rëndësishëm dhe zakonisht i ngatërruar është **`RUN` vs `CMD` vs `ENTRYPOINT`**: `RUN` ekzekutohet në **kohën e ndërtimit** (ndërtimi i imazhit, p.sh. instalimi i paketave), ndërsa `CMD`/`ENTRYPOINT` përcaktojnë se çfarë ekzekutohet në **fillimin e kontenerit** (komanda e aplikacionit) — komprensimi i kësaj parandalon gabimet e zakonshme.

Pazarimi i modeleve praktike (si kopjimi i skedarëve të varësisë para kodit për cache të më mirë të shtresës) pasqyron shkrimin e Dockerfile efikas.

Sepse ndërtimi i imazheve është themelor për përdorimin e Docker (çdo rrjedh Docker përfshin imazhe, dhe Dockerfile është se si ndërtohen imazhe të personaluar), dhe sepse komprensimi i udhëzimeve dhe dallimi ndërmjet kohës-ndërtim-versus-kohës-ekzekutimi është i nevojshëm për të krijuar imazhe të saktë dhe efikase, komprensimi i Dockerfile është thelbësor, shpesh-aplikuar njohuri Docker — një aftësi bazë për këdo që përdor Docker, mekanizmi që e kthen premtimin e përsëritshëmrisë të Docker në praktikë dhe një kërkesë pothuajse universale për kontejnerizimin e aplikacioneve.