Quelltext der Seite Node.js und npm für Website-Builds verwenden

Node.js und npm werden bei vielen Websites nur benötigt, um CSS-, JavaScript- oder Theme-Dateien zu erzeugen. Das bedeutet nicht automatisch, dass auf dem Webspace dauerhaft ein öffentlicher Node.js-Server laufen muss.

== Voraussetzungen ==

Node.js muss im Tarif oder auf dem selbst verwalteten Server verfügbar sein. Prüfen Sie die vom Projekt verlangte Hauptversion und verwenden Sie ausschließlich vertrauenswürdige Paketquellen.

<syntaxhighlight lang="bash">
node --version
npm --version
</syntaxhighlight>

== Reproduzierbarer Build ==

Wenn eine geprüfte <code>package-lock.json</code> vorhanden ist, eignet sich für einen sauberen Build:

<syntaxhighlight lang="bash">
npm ci
npm run build
</syntaxhighlight>

<code>npm ci</code> erwartet eine zur <code>package.json</code> passende Lock-Datei und verändert diese nicht. Der genaue Build-Befehl steht in den Skripten der Anwendung.

== Sicherer Ablauf ==

# Prüfen Sie Repository und Lock-Datei.
# Führen Sie Builds bevorzugt in Entwicklung oder CI aus.
# Veröffentlichen Sie nur die benötigten Build-Artefakte.
# Prüfen Sie <code>npm audit</code>, bewerten Sie Funde aber anhand der tatsächlich produktiv verwendeten Pakete.
# Speichern Sie keine Registry-Tokens oder API-Schlüssel im Repository.
# Starten Sie keinen Entwicklungsserver öffentlich im Produktivbetrieb.

== Typische Fehler ==

; Falsche Node.js-Version
: Verwenden Sie die im Projekt dokumentierte Version. Eine neue Hauptversion kann Build-Werkzeuge brechen.

; Build funktioniert lokal, aber nicht auf dem Server
: Vergleichen Sie Node-Version, Betriebssystem, Lock-Datei, Umgebungsvariablen und verfügbaren Speicher.

; <code>node_modules</code> wird hochgeladen
: Plattformabhängige Module können unpassend sein. Besser ist ein reproduzierbarer Build in einer passenden Umgebung.

== Verwandte Artikel ==

* [[Abhängigkeiten, Updates und Supply-Chain-Risiken]]
* [[Website-Deployment mit Wartungsmodus und Rollback]]
* [[Umgebungsvariablen, .env und Zugangsdaten schützen]]

[[Category:Entwicklung und Deployment]]
[[Category:Webhosting, Dateien und PHP]]