Ein Build ist der Vorgang, der aus dem Quellcode ein lauffähiges Ergebnis macht, und mit demselben Wort auch dieses Ergebnis. Bei einer Website gehören dazu die Abhängigkeiten, die gebündelten Dateien für den Browser und die vorbereiteten Zwischenspeicher.
- Build
Der Vorgang, der aus dem Quellcode ein lauffähiges Ergebnis macht, und dieses Ergebnis selbst.
Beispiel: „Der Build brach ab, weil eine Abhängigkeit eine neuere PHP-Fassung verlangte.“Wörtlich bauen. Gezählt wird oft fortlaufend, als Build-Nummer; in Pipelines steht sie neben dem Commit, aus dem der Build entstand.
Abgrenzung zur Build-Pipeline: Diese ist der eingerichtete Ablauf, der Build der einzelne Durchgang darin.
Was in einem Build passiert
Vier Schritte. Composer holt die Pakete für PHP, der Paketmanager des Frontends die für JavaScript, ein Bündler wie Vite macht aus Quelldateien die wenigen Dateien für den Browser, und zuletzt werden Konfiguration und Routen in Zwischenspeicher geschrieben.
Was dabei herauskommt, enthält keinen Entwicklungsballast mehr: Testwerkzeuge und Werkzeuge für die Entwicklung bleiben draußen, weil sie auf dem Zielserver nichts zu suchen haben.
Warum ein Build wiederholbar sein muss
Weil sonst zwei Server verschiedene Fassungen derselben Website ausliefern. Dafür sorgen die Sperrdateien von Composer und npm: Sie halten jede Paketfassung genau fest, statt beim nächsten Lauf die neuere zu nehmen.
Daraus folgt die Regel, diese Dateien mitzuversionieren. Ein Projekt ohne sie baut heute anders als morgen, und der Fehler liegt dann in einem Paket, das niemand bewusst aktualisiert hat.
Woran ein Build scheitert
Meist an der Umgebung. Eine andere PHP- oder Node-Fassung als auf dem eigenen Rechner, ein fehlendes Modul, ein Speicherlimit, das beim Bündeln greift: Die Meldung nennt das Paket, nicht den Grund.
Der schnellste Weg führt über die Ausgabe des Laufs von unten nach oben. Die erste Fehlermeldung zählt; alles darunter sind Folgefehler, siehe Server-Logs.