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 il relativo URL di anteprima) per ogni PR nel tuo repository GitHub.

  • Aggiunge un commento alla RP con l'URL di anteprima in modo che tu e ogni revisore possiate visualizzare e testare le modifiche della RP 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 di ogni commit eseguendo automaticamente il deployment nel canale di anteprima associato. L'URL non cambia con 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 eseguire il deployment in 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 di GitHub Action di Hosting. Esegui questa versione del comando dalla directory principale della tua directory locale:

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

    • Crea un account di servizio nel tuo 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 da eseguire 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 gestisce l'azione GitHub "Esegui il deployment in 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.