Esegui il deployment nei canali di anteprima e in quelli pubblicati tramite le richieste di pull di GitHub

Puoi integrare i deployment su Firebase Hosting tramite un'azione GitHub. Ecco cosa può fare questa azione GitHub per te:

  • Crea un nuovo canale di anteprima (e l'URL di anteprima associato) per ogni PR nel tuo repository GitHub.

  • Aggiunge un commento al PR con l'URL di anteprima in modo che tu e ogni revisore possiate visualizzare e testare le modifiche del PR in una versione di "anteprima" della tua app.

    immagine del commento della richiesta di pull di GitHub Action con URL di anteprima

  • Aggiorna l'URL di anteprima con le modifiche apportate da ogni commit eseguendo il deployment automatico nel canale di anteprima associato. L'URL non cambia a ogni nuovo commit.

  • (Facoltativo) Esegui il deployment dello stato corrente del tuo repository GitHub nel canale attivo quando la PR viene unita.

Promemoria: quando utilizzi gli URL di anteprima, la tua app interagisce con le risorse di backend reali del tuo progetto Firebase.

Configura l'azione GitHub per il deployment su Firebase Hosting

  1. Crea un repository GitHub (pubblico o privato) o utilizzane uno esistente. Devi disporre delle autorizzazioni di amministratore per il repository.

  2. In una versione locale del tuo repository, configura Firebase Hosting utilizzando il comando firebase init.

    • Se NON hai configurato Hosting, esegui questa versione del comando dalla radice della tua directory locale:

      firebase init hosting
    • Se hai GIÀ configurato Hosting, devi solo configurare la parte GitHub Action di Hosting. Esegui questa versione del comando dalla directory radice della directory locale:

      firebase init hosting:github
  3. Segui i prompt della CLI e il comando si occuperà automaticamente della configurazione dell'azione GitHub:

    • Crea un account di servizio nel progetto Firebase con l'autorizzazione per eseguire il deployment in Firebase Hosting.

    • Crittografa la chiave JSON dell'account di servizio e la carica nel repository GitHub specificato come secret GitHub.

    • Scrive i file di configurazione del flusso di lavoro di GitHub yaml che fanno riferimento al segreto appena creato. Questi file configurano l'azione GitHub per il deployment su Firebase Hosting.

  4. In GitHub, crea un nuovo ramo e esegui il commit dei file yaml del flusso di lavoro creati dalla CLI.

  5. Pubblica il ramo nel tuo repository GitHub.

  6. Unisci il ramo.

Ecco fatto. Qualsiasi PR successiva in questo repository GitHub avrà automaticamente il proprio "URL di anteprima".

Scopri di più sull'azione GitHub

  • Firebase mantiene l'azione GitHub "Deploy to Firebase Hosting" come progetto open source. Visualizza il codice sorgente.

  • L'azione GitHub "Esegui il deployment in Firebase Hosting" consente di eseguire ulteriori configurazioni, ad esempio personalizzare la data di scadenza di un canale di anteprima o impostare un canale non pubblicato su cui eseguire il deployment quando viene unita una PR. Scopri le opzioni di configurazione disponibili.

  • Scopri di più su GitHub Actions in generale.