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.
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.
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.
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.
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 \ |
Esegue il deployment dei contenuti e della configurazione di Hosting del sito Hosting predefinito in un URL di anteprima |
firebase hosting:channel:deploy \ |
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 |