Firebase App Hosting verwendet Cloud Build, um den Quellcode Ihrer Anwendung in ein Containerformat umzuwandeln, das für die Bereitstellung in Cloud Run geeignet ist.
Der Build-Prozess umfasst die folgenden Hauptphasen:
ubuntu: Workspace-Initialisierung.
preparer: Erfasst den Quellcode und die Konfiguration Ihrer Anwendung.
pre-buildpack: Bereitet die Buildpack-Umgebung vor.
build: Installiert Abhängigkeiten und erstellt Ihre Anwendung.
publisher: Schließt den Produktionscontainer Cloud Run ab.
Diese fünf Schritte entsprechen direkt den Build-Schritten, die in Cloud Build in der Google Cloud Console angezeigt werden:

Arbeitsbereich initialisieren
Diese Phase entspricht dem Ubuntu-Build-Schritt. Der Build-Arbeitsbereich wird initialisiert und die richtigen Dateiberechtigungen für die Verzeichnisse werden festgelegt, die in den nachfolgenden Build-Schritten verwendet werden.
Ersteller
Diese Phase ist für die Verarbeitung der Pre-Build-Logik verantwortlich. Sie liest, bereinigt und schreibt benutzerdefinierte Umgebungsvariablen. Außerdem werden alle in der Datei apphosting.yaml angegebenen Secrets dereferenziert und angepinnt.
Pre-Buildpack
In diesem Schritt wird die Umgebung für den Lebenszyklus von Cloud Native Buildpacks vorbereitet. Dazu wird ein Shim ausgeführt, der die in der vorherigen Phase vorbereiteten Konfigurationen und Umgebungsvariablen in das von den CNB-Tools erwartete Format übersetzt.
Build
Dies ist der Kern des Build-Prozesses, der für die Erstellung eines ausführbaren Container-Images und einer bundle.yaml-Datei verantwortlich ist, die Ihre Build-Konfiguration definiert.
Es verwendet die Cloud Native Buildpacks und die Binärdatei lifecycle creator, um die Anwendung effizient zu verpacken. Weitere Informationen zur Datei bundle.yaml finden Sie auf GitHub.
Buildpacks sind dafür verantwortlich, den Quellcode Ihrer Anwendung in produktionsreife Container-Images umzuwandeln. Firebase App Hosting verkettet mehrere Buildpacks, um den Build-Prozess abzuschließen:
- Laufzeit-Buildpack: Sorgt dafür, dass alle erforderlichen Komponenten zum Ausführen einer einfachen Node.js-Anwendung enthalten sind und Abhängigkeiten installiert werden.
- Monorepo-Buildpack: Konfiguriert nachfolgende Buildpacks für verschiedene Monorepo-Szenarien.
Framework-Buildpack: Installiert den richtigen Framework-Adapter (z. B. Angular oder Next.js) und bereitet nachfolgende Buildpacks vor.
Framework-Adapter sind dafür verantwortlich, den produktionsreifen Build-Befehl auszuführen und alle relevanten frameworkspezifischen Konfigurationswerte einem Standardformat zuzuordnen, das von App Hosting gelesen werden kann.
Package Manager Buildpack: Führt die Installation von Abhängigkeiten aus und erstellt die Anwendung mit npm, yarn oder pnpm.
Output Bundle Buildpack: Definiert den Ausführungsbefehl und bereitet das Ausgabebundle für die Ausführung vor.
Publisher
In dieser letzten Phase werden alle aus dem Anwendungsquellcode extrahierten Informationen sowie das Build-Container-Image verpackt und an das App Hosting-Backend gesendet. Das App Hosting-Backend verwendet diese Informationen dann, um Cloud Run mit den richtigen Konfigurationen einzurichten.
Build-Bereinigungsrichtlinie
Firebase App Hosting erzwingt eine automatisierte Aufbewahrungs- und Bereinigungsrichtlinie für Builds. Gemäß dieser Richtlinie werden in App Hosting Ihre erfolgreichen Builds und die zugehörigen Cloud Run-Überarbeitungen der letzten 14 Tage aufbewahrt. Damit Sie immer einen Build haben, zu dem Sie zurückkehren können, speichert App Hosting außerdem Ihre fünf letzten erfolgreichen Builds und Roll-outs, unabhängig von ihrem Alter.
App Hosting löscht oder entfernt keinen Build, der sich derzeit in der aktiven Aufteilung des Traffics befindet oder mit einem laufenden Roll-out verknüpft ist.
Wenn ältere Builds diese Aufbewahrungslimits überschreiten, wird ihr interner Status auf EXPIRED aktualisiert. Sie können kein sofortiges Rollback für einen EXPIRED-Build ausführen. Die Option zum Rollback auf diese Builds wird aus der Firebase-Konsole entfernt. Stattdessen müssen Sie einen neuen Build für dieselbe Quelle erstellen (entweder einen Git-Commit, einen Container in Artifact Registry oder einen Google Cloud Storage-Bucket) und diesen dann bereitstellen.
Eine Möglichkeit, Build-Ressourcen zu sparen, besteht darin, zu steuern, wie oft Sie automatische Roll-outs auslösen. Weitere Informationen finden Sie unter Automatische Roll-outs verwalten.
Weitere Informationen
Der gesamte App Hosting-Build-Prozess ist Open Source.
- Der Buildpack-Code befindet sich im Google Cloud-Buildpacks-Repository.
- Der Code für Framework-Adapter befindet sich im apphosting-adapters-Repository.
- Weitere Informationen zu Cloud Native Buildpacks und Cloud Build