Firebase App Hosting utilise Cloud Build pour transformer le code source de votre application en un format conteneurisé adapté au déploiement sur Cloud Run.
Le processus de compilation se déroule en plusieurs étapes clés :
ubuntu : initialisation de l'espace de travail.
preparer : rassemble le code source et la configuration de votre application.
pre-buildpack : prépare l'environnement du buildpack.
build : installe les dépendances et compile votre application.
publisher : finalise le conteneur de production Cloud Run.
Ces cinq étapes correspondent directement aux étapes de compilation affichées dans Cloud Build dans la console Google Cloud :

Initialisation de l'espace de travail
Cette étape correspond à l'étape de compilation Ubuntu. Il initialise l'espace de travail de compilation, en s'assurant que les autorisations de fichiers appropriées sont définies pour les répertoires utilisés par les étapes de compilation suivantes.
Préparateur
Cette étape est chargée de gérer la logique de pré-compilation. Il lit, nettoie et écrit les variables d'environnement définies par l'utilisateur. Il déréférence et épingle également tous les secrets spécifiés dans le fichier apphosting.yaml.
Pre-buildpack
Cette étape prépare l'environnement pour le cycle de vie des Cloud Native Buildpacks. Cela implique d'exécuter un shim qui traduit les configurations et les variables d'environnement préparées à l'étape précédente au format attendu par les outils CNB.
Développement
Il s'agit du cœur du processus de compilation, chargé de générer une image de conteneur exécutable et un fichier bundle.yaml définissant votre configuration de compilation.
Il utilise les packs de création cloud natifs et le binaire du créateur de cycle de vie pour empaqueter l'application efficacement. Pour en savoir plus sur le fichier bundle.yaml, consultez GitHub.
Les buildpacks sont chargés de transformer le code source de votre application en images de conteneurs prêtes pour la production. Firebase App Hosting enchaîne plusieurs buildpacks pour terminer le processus de compilation :
- Buildpack d'exécution : garantit que tous les composants nécessaires à l'exécution d'une application Node.js de base sont inclus et que les dépendances sont installées.
- Buildpack Monorepo : configure les buildpacks suivants pour gérer différents scénarios de monorepo.
Buildpack de framework : installe l'adaptateur de framework approprié (comme Angular ou Next.js) et prépare les buildpacks suivants.
Les adaptateurs de framework sont chargés d'exécuter la commande de compilation de production et de mapper toutes les valeurs de configuration spécifiques au framework à un format standard lisible par App Hosting.
Buildpack du gestionnaire de packages : exécute l'installation des dépendances et compile l'application à l'aide de npm, yarn ou pnpm.
Buildpack de bundle de sortie : définit la commande d'exécution et prépare le bundle de sortie pour l'exécution.
Éditeur
Cette dernière étape empaquette toutes les informations extraites du code source de l'application ainsi que l'image de conteneur de compilation, puis les envoie au backend App Hosting. Le backend App Hosting utilise ensuite ces informations pour configurer Cloud Run avec les paramètres appropriés.
Règle de nettoyage des builds
Firebase App Hosting applique une règle automatisée de conservation et de nettoyage des builds. En vertu de cette règle, App Hosting conserve vos builds réussis et leurs révisions Cloud Run associées des 14 derniers jours. De plus, pour vous assurer de toujours disposer d'un build vers lequel effectuer un rollback, App Hosting conserve vos cinq builds et déploiements réussis les plus récents, quel que soit leur âge.
App Hosting ne supprime pas une compilation qui se trouve actuellement dans votre répartition du trafic active ou qui est associée à un déploiement en cours.
Lorsque les anciennes versions dépassent ces limites de conservation, leur état interne est mis à jour sur EXPIRED. Vous ne pouvez pas effectuer de rollback instantané sur un build EXPIRED, et l'option permettant de revenir à ces builds sera supprimée de la console Firebase. À la place, vous devez créer une compilation ciblant la même source (un commit Git, un conteneur dans Artifact Registry ou un bucket Google Cloud Storage) et la déployer.
Pour préserver les ressources de compilation, vous pouvez contrôler la fréquence à laquelle vous déclenchez des déploiements automatiques. Consultez Gérer les déploiements automatiques.
En savoir plus
L'ensemble du processus de compilation App Hosting est Open Source.
- Le code du buildpack se trouve dans le dépôt des buildpacks Google Cloud.
- Le code des adaptateurs de framework se trouve dans le dépôt apphosting-adapters.
- En savoir plus sur les buildpacks Cloud Native et Cloud Build