La procedura di compilazione di App Hosting

Firebase App Hosting utilizza Cloud Build per trasformare il codice sorgente dell'applicazione in un formato containerizzato adatto per il deployment su Cloud Run.

Il processo di compilazione prevede le seguenti fasi chiave:

  1. Importazione: raccoglie il codice sorgente e la configurazione dell'applicazione.

  2. Compilazione: installa le dipendenze e compila l'applicazione.

  3. Trasferimento: completa il contenitore Cloud Run di produzione.

Questi tre passaggi corrispondono direttamente ai passaggi di compilazione 1, 2 e 3 visualizzati inCloud Build nella console Google Cloud:

Uno screenshot di una visualizzazione della console Google Cloud dei passaggi di Cloud Build

Fase di importazione

Questa fase è responsabile della gestione della logica di pre-compilazione. Legge, esegue la sanitizzazione e scrive le variabili di ambiente definite dall'utente. Inoltre, dereferizza e blocca tutti i segreti specificati nel file apphosting.yaml.

Fase di compilazione

Questo è il nucleo del processo di compilazione, responsabile della generazione di un'immagine container eseguibile e di un file bundle.yaml che definisce la configurazione di compilazione. Utilizza Buildpacks cloud-native per impacchettare l'applicazione in modo efficiente. Puoi trovare maggiori informazioni sul file bundle.yaml su GitHub.

I buildpack sono responsabili della trasformazione del codice sorgente dell'applicazione in immagini container pronte per la produzione. Firebase App Hosting collega insieme diversi buildpack per completare il processo di compilazione:

  1. Buildpack di runtime: garantisce che tutti i componenti necessari per eseguire un'applicazione Node.js di base siano inclusi e che le dipendenze siano installate.
  2. Buildpack monorepo: configura i buildpack successivi per gestire diversi scenari monorepo.

  3. Buildpack del framework: installa l'adattatore del framework corretto (ad esempio Angular o Next.js) e prepara i buildpack successivi.

    Gli adattatori del framework sono incaricati di eseguire il comando di compilazione in produzione e di mappare eventuali valori di configurazione specifici del framework a un formato standard leggibile da App Hosting.

  4. Package Manager Buildpack: esegue l'installazione delle dipendenze e compila l'app utilizzando npm, yarn o pnpm.

  5. Buildpack del bundle di output: definisce il comando di esecuzione e prepara il bundle di output per l'esecuzione.

Fase di passaggio

Questa fase finale pacchettizza tutte le informazioni estratte dal codice sorgente dell'applicazione, oltre all'immagine del contenitore di compilazione, e le invia al backend App Hosting. Il backend di App Hosting utilizza queste informazioni per configurare Cloud Run con le configurazioni appropriate.

Scopri di più

L'intera procedura di compilazione di App Hosting è open source.