Condivisione delle risorse di progetto tra più siti

Puoi configurare uno o più siti Firebase Hosting in un singolo progetto Firebase. Poiché i siti si trovano tutti nello stesso progetto Firebase, tutti possono accedere alle altre risorse Firebase del progetto.

• Ogni sito ha la propria configurazione di hosting.
• Ogni sito ospita la propria raccolta di contenuti.
• Ogni sito può avere uno o più domini associati.

Configurando più siti Hosting nello stesso progetto Firebase, puoi condividere più facilmente le risorse Firebase tra siti e app correlati. Ad esempio, se configuri il tuo blog, il pannello di amministrazione e l'app pubblica come siti individuali nello stesso progetto Firebase, tutti possono condividere lo stesso database utenteFirebase Authentication, pur avendo i propri domini o contenuti unici.

Importante: per eseguire il mirroring degli ambienti di flusso di lavoro (ad es. Dev, Q1, Q2, Prod), ti consigliamo di creare un progetto Firebase distinto per ogni ambiente anziché creare più siti in un singolo progetto Firebase. In genere, non è consigliabile utilizzare risorse Firebase dell'ambiente di produzione (come i dati dei clienti in un Realtime Database) in un ambiente di sviluppo. Valuta la possibilità di utilizzare la configurazione automatica dell'SDK per eseguire il mirroring di più ambienti utilizzando un singolo codebase.

La funzionalità multisito supporta un massimo di 36 siti per progetto Firebase.

Passaggio 1: aggiorna la versione dell'interfaccia a riga di comando di Firebase

Accedi alle funzionalità di Firebase Hosting più recenti effettuando l'aggiornamento all'ultima versione dell'interfaccia a riga di comando di Firebase.

Passaggio 2: aggiungi altri siti

Aggiungi altri siti a un progetto Firebase utilizzando uno dei seguenti metodi:

• Utilizza il flusso di lavoro nella pagina Hosting della console Firebase

• Utilizza il comando dell'interfaccia a riga di comando Firebase: firebase hosting:sites:create SITE_ID

• Utilizza l'API REST Hosting: projects.sites.create

Per ognuno di questi metodi, specificherai un SITE_ID che viene utilizzato per creare i sottodomini predefiniti forniti da Firebase per il sito:

• SITE_ID.web.app
• SITE_ID.firebaseapp.com

Per questi URL viene utilizzato SITE_ID, pertanto l'ID sito ha i seguenti requisiti:

• Deve essere un'etichetta del nome host valida, il che significa che non può contenere ., _ e così via.
• Deve contenere al massimo 30 caratteri
• Deve essere univoco a livello globale in Firebase

Se vuoi, per ogni sito puoi anche aggiungere domini personalizzati per pubblicare gli stessi contenuti e configurare più URL.

Nota: se hai creato più istanze Firebase Realtime Database nel tuo progetto Firebase prima di agosto 2018, Firebase ha eseguito automaticamente il provisioning di un sito corrispondente per ogni istanza di database. Se non hai bisogno di questi siti aggiuntivi, puoi eliminarli senza influire sulle istanze del database.

Eliminare un sito secondario

Elimina i siti indesiderati da un progetto Firebase utilizzando uno dei seguenti metodi:

• Utilizza il flusso di lavoro nella pagina Hosting della console Firebase

• Utilizza il comando dell'interfaccia a riga di comando Firebase: firebase hosting:sites:delete SITE_ID

• Utilizza l'API REST Hosting: projects.sites.delete

Tieni presente che non puoi eliminare il sito predefinito, che ha lo stesso SITE_ID del tuo ID progetto Firebase.

Attenzione: l'eliminazione di un sito è un'azione permanente. Se elimini un sito, Firebase non mantiene i record dei file di cui è stato eseguito il deployment o della cronologia del deployment e il SITE_ID non può essere riattivato da te o da altri.

Passaggio 3: configura i target di deployment per i tuoi siti

Quando hai più siti ed esegui i comandi di deployment dell'Firebase CLI, l'interfaccia a riga di comando deve avere un modo per comunicare quali impostazioni devono essere implementate in ogni sito. Con i target di deployment puoi identificare in modo univoco un sito specifico con un TARGET_NAME nel firebase.json file di configurazione e nei Firebase comandi CLI per il test o il deployment sui tuoi siti.

Importante: l'utilizzo dei target di deployment è il modo consigliato per configurare i deployment per più siti Hosting.
Se in precedenza hai configurato il file firebase.json facendo riferimento esplicito a SITE_ID, devi modificare la configurazione di firebase.json e i comandi CLI per utilizzare i target di deployment.

Per creare un target di deployment e applicare un TARGET_NAME a un sito Hosting, esegui il seguente comando CLI dalla radice della directory del progetto:

firebase target:apply hosting TARGET_NAME RESOURCE_IDENTIFIER

dove i parametri sono:

• TARGET_NAME: un nome univoco (che hai definito personalmente) per il sito Hosting in cui stai eseguendo l'implementazione

• RESOURCE_IDENTIFIER: il SITE_ID per il sito Hosting come elencato nel tuo progetto Firebase

Ad esempio, se hai creato due siti (myapp-blog e myapp-app) nel tuo progetto Firebase, puoi applicare un TARGET_NAME univoco (blog e app, rispettivamente) a ogni sito eseguendo i seguenti comandi:

firebase target:apply hosting blog myapp-blog

firebase target:apply hosting app myapp-app

Le impostazioni per i target di deployment sono memorizzate nel file .firebaserc nella directory del progetto, quindi devi configurare i target di deployment una sola volta per progetto.

Passaggio 4: definisci la configurazione di hosting per ogni sito

Utilizza il TARGET_NAME applicato a un sito quando definisci la configurazione di hosting nel file firebase.json.

• Se il file firebase.json definisce la configurazione per più siti, utilizza un formato array:

  {
    "hosting": [ {
        "target": "blog",  // "blog" is the applied TARGET_NAME for the Hosting site "myapp-blog"
        "public": "blog/dist",  // contents of this folder are deployed to the site "myapp-blog"
  
        // ...
      },
      {
        "target": "app",  // "app" is the applied TARGET_NAME for the Hosting site "myapp-app"
        "public": "app/dist",  // contents of this folder are deployed to the site "myapp-app"
  
        // ...
  
        "rewrites": [...]  // You can define specific Hosting configurations for each site
      }
    ]
  }

• Se il file firebase.json definisce la configurazione per un solo sito, non è necessario utilizzare un formato array:

  {
    "hosting": {
        "target": "blog",
        "public": "dist",
  
        // ...
  
        "rewrites": [...]
    }
  }

Passaggio 5: esegui test locali, visualizza l'anteprima delle modifiche ed esegui il deployment sui tuoi siti

Esegui uno dei seguenti comandi dalla directory principale del progetto locale.

Comando	Descrizione
firebase emulators:start --only hosting	Emula i contenuti e la configurazione di Hosting del sito Hosting predefinito su un URL ospitato localmente
firebase emulators:start --only hosting:TARGET_NAME	Emula i contenuti e la configurazione Hosting del sito Hosting specificato in un URL ospitato localmente
firebase hosting:channel:deploy \ CHANNEL_ID	Esegue il deployment dei contenuti e della configurazione di Hosting del sito Hosting predefinito in un URL di anteprima
firebase hosting:channel:deploy \ CHANNEL_ID --only TARGET_NAME	Esegue il deployment dei contenuti e della configurazione di Hosting del sito Hosting specificato in un URL di anteprima
firebase deploy --only hosting	Esegue il deployment dei contenuti e della configurazione di Hosting sul canale dal vivo di tutti i siti Hosting configurati in firebase.json
firebase deploy --only hosting:TARGET_NAME	Esegue il deployment dei contenuti e della configurazione di Hosting sul canale dal vivo del sito Hosting specificato

Comando	Descrizione
(non consigliato; usa invece emulators:start) firebase serve --only hosting	Pubblica i contenuti e la configurazione di Hosting del sito Hosting predefinito su un URL ospitato localmente
(non consigliato; utilizza emulators:start) firebase serve --only hosting:TARGET_NAME	Pubblica i contenuti e la configurazione del sito Hosting specificato su un URL ospitato localmente

Nota: se esegui comandi con il flag --only hosting, emuli o esegui il deployment solo dei contenuti e della configurazione Hosting. Se anche vuoi emulare o eseguire il deployment di altre risorse o configurazioni del progetto (ad esempio funzioni o regole del database), esegui i comandi con un elenco separato da virgole nel flag (ad esempio --only hosting,functions).

Per i deployment nei canali di anteprima, non devi specificare hosting nel flag --only perché questi comandi possono eseguire solo il deployment dei contenuti e della configurazione Hosting.