Çfarë janë ndërtimët me shumë faza dhe përse t'i përdorni ato?

Question

Accepted Answer

**Ndërtimët me shumë faza** përdorin shumë faza `FROM` në një Dockerfile — ndërtojnë aplikacionin në një fazë (me të gjithë mjetet e ndërtimit) dhe kopjojnë vetëm artefaktet përfundimtare në një fazë përfundimtare të pastër, minimale. Kjo prodhon imazhe prodhimi **shumë më të vogla, më të sigurta**.

## Problemi: mjetet e ndërtimit e fryrë imazhin

```text
Building an app needs build tools (compilers, dev dependencies, SDKs), but the
FINAL image shouldn't include them:
  → they bloat the image (larger size, slower deploys)
  → they increase the attack surface (more software = more vulnerabilities)
→ You want only the built artifact + its runtime in the final image.
```

## Ndërtim me shumë faza

```dockerfile
# STAGE 1: "build" — has all the build tools (compile/bundle the app)
FROM node:20 AS build
WORKDIR /app
COPY package*.json ./
RUN npm install              # includes dev dependencies, build tools
COPY . .
RUN npm run build            # produces /app/dist

# STAGE 2: final — a clean, minimal image with ONLY the built artifact
FROM nginx:alpine
COPY --from=build /app/dist /usr/share/nginx/html   # copy ONLY the build output
# → the final image has NO build tools, no dev dependencies — just nginx + the built files
```

`--from=build` kopjon artefaktet nga faza e ndërtimit në imazhin përfundimtar. Imazhi përfundimtar **përjashton gjithçka nga faza e ndërtimit përveç asaj që kopjoni në mënyrë eksplicite** — kështu që mjetet e ndërtimit, varësitë e zhvillimit dhe kodi burimor nuk përfundojnë në prodhim.

## Përfitimet

```text
✓ SMALLER images — only the runtime + artifacts (often 10x+ smaller)
✓ More SECURE — fewer packages = smaller attack surface (no compilers/build tools)
✓ Faster deploys/pulls (smaller images transfer faster)
✓ One Dockerfile — build and final image together (no separate build scripts)
→ Common for compiled languages (Go, Rust, Java) and Node/frontend builds.
```

## Përse është i rëndësishëm

Kuptimi i ndërtimeve me shumë faza është i vlefshëm për **prodhimin e imazheve të vogla, të sigurta të prodhimit**, kështu që është njohuri praktike e rëndësishme për ndërtimin e imazheve Docker të cilësisë prodhimi.

Problemi që zgjidh është i vërtetë dhe i zakonshëm: ndërtimi i një aplikacioni kërkon **mjete ndërtimi** (kompajlatorë, SDK-në, varësi zhvillimi) që **imazhi përfundimtar i prodhimit nuk duhet të përmbajë** — përfshirja e tyre e fryn imazhin (madhësi më e madhe, shpërndarja më e ngadaltë dhe tërhiqjet) dhe rrit **sipërfaqen e sulmit** (më shumë software i instaluar do të thotë më shumë zranueshmëri të mundshme). **Ndërtimët me shumë faza** zgjidhin këtë elegantisht duke përdorur shumë faza `FROM`: ndërtimi i aplikacionit në një fazë me të gjithë mjetet, pastaj **kopjimi vetëm i artefakteve përfundimtare** (`--from=build`) në një fazë përfundimtare të pastër, minimale që përjashton gjithçka tjetër.

Kjo prodhon imazhe që janë **dramatikisht më të vogla** (shpesh 10x+ më të vogla — vetëm runtime dhe artefaktet) dhe **më të sigurta** (pa mjete ndërtimi ose paketa të panevojshme për të shfrytëzuar), ndërsa e mbajnë gjithçka në një Dockerfile (pa script të veçantë ndërtimi).

Ky model është standard për gjuhët e kompajluara (Go, Rust, Java, ku kompajlatori nuk nevojitet në runtime) dhe për ndërtimet frontend/Node (ku mjetet e ndërtimit dhe kodi burimor nuk janë të nevojshëm në prodhim).

Meqë imazhet e vogla, të sigurta të prodhimit kanë rëndësi për shpejtësinë e shpërndarjes, ruajtjen dhe sigurinë, dhe meqë ndërtimët me shumë faza janë teknika standarde, efektive për t'i arritur ato (ndarjen e mjedisit të ndërtimit nga imazhi i barlogs i lean), kuptimi i ndërtimeve me shumë faza — problemi i fryrjes/sigurisë që zgjidhin, si funksionojnë dhe përfitimet e tyre — është njohuri e vlefshme, e zbatuar shpesh për ndërtimin e imazheve Docker të cilësisë prodhimi, një praktikë më e mirë e përdorur gjerësisht në Dockerfiles në botën reale dhe një aftësi kyçe për prodhimin e aplikacioneve efikase, të sigurta të kontejnerizuara.