Liema għażliet ta' deployement u outputs ta' build għal-Next.js?

Question

Accepted Answer

Next.js jissostnix diversi ta' għanajn ta' deployement, ikkontrollati parzjalment mill-konfigurazzjoni **`output`**. L-għażla t-tajba tiddipendi fuq jekk għandek bżonn server Node, kontenituri, jew hosting statiċu pur.

## Il-modi tal-output ta' build

```js
// next.config.js
module.exports = {
  // output: undefined  → default: needs a Node.js server (full features)
  // output: "standalone" → self-contained folder for Docker/containers
  // output: "export"     → pure static HTML/CSS/JS (no server)
};
```

## 1. Default (server Node) — funzjonalitajiet kumpleti

Itteħħel server Node.js, ħaż għandek **kollox**: SSR, ISR, Server Actions, Route Handlers, ottimizzazzjoni tal-immaġini, middleware. Din hi dak li jużaw il-pjattaformi bħal **Vercel** (il-manifattur ta' Next.js, zero-config) u l-hosts Node.

## 2. output: "standalone" — għal Docker / self-hosting

```dockerfile
# Next traces only the needed files into .next/standalone → a tiny, self-contained server
COPY --from=builder /app/.next/standalone ./
CMD ["node", "server.js"]
```

`standalone` jiprodott folder minimali bi biss id-dipendenzji li effettivament jintużaw, ideali għal immaġini Docker żgħar fuq AWS, GCP, is-servers tiegħek, eċċ. Inti żżomm il-funzjonalitajiet tas-server kollha.

## 3. output: "export" — totalment statiċ

```text
next build → out/  (plain HTML/CSS/JS, deployable to any static host: S3, GitHub Pages, Netlify CDN)
```

Esport statiċu tagħti l-hosting fejn inqas għal-ħlas u sempliċi iżda **itiddiżabbla l-funzjonalitajiet tas-server**: ebda SSR, ebda ISR, ebda Route Handlers, ebda Server Actions, ebda ottimizzazzjoni tal-immaġini on-the-fly. Adatts biss għal sit statiċi totalment.

## Il-għażla

```text
Need SSR/ISR/Server Actions, want zero-config → Vercel (or a Node host) — default output
Want containers / self-host with full features → output: "standalone" + Docker
Purely static content (docs, marketing)        → output: "export" → any static CDN
```

## Kunsiderazzjonijiet oħra

```text
- Runtime choice (Edge vs Node) affects where functions run
- Self-hosting ISR/caching needs persistent storage or a shared cache
- Image optimization on non-Vercel hosts may need a custom loader
```

## Għaliex dan importanti

Id-deployement mhix soluzzjoni waħda għal-kollox: il-modalità `output` tiddetermina liema funzjonalitajiet ta' Next.js jibqgħu.

L-għarfien li l-output **default/Node** iżżomm il-kapaċità tas-server kollha, **standalone** jimbaxxaja għal Docker/self-hosting, u **export** jiskambjja l-funzjonalitajiet tas-server kollha għal hosting statiċu pur iħallak tqabbel il-build mal-infrastruttura tiegħek — u tevita l-qerda ta' `output: "export"` li b'mod sieħeb talksa SSR/ISR/Server Actions.