Firebase App Hosting è la soluzione ideale per le app web dinamiche create con l'SDK Firebase JavaScript e Firebase Admin SDK per Node.js. In un'app web completa, gli SDK Firebase come Authentication, Cloud Firestore e App Check svolgono un ruolo importante. Questa guida descrive alcune strategie chiave per ottimizzare gli SDK Firebase e iniziare a creare Firebase nella tua app web su Firebase App Hosting.
Inizializza automaticamente gli SDK Firebase Admin SDK e web
Gli ambienti Google come Firebase App Hosting forniscono un'inizializzazione semplificata delle app tramite una chiamata al costruttore senza argomenti in fase di build e di runtime. Questa è una funzionalità sia dell'Firebase Admin SDK per Node.js, un SDK lato server che sblocca un'ampia area di funzionalità di Firebase e può essere molto utile nella tua app web, sia dell'SDK Firebase JavaScript.
Con initializeApp(), puoi consentire a Firebase App Hosting di compilare automaticamente la configurazione dell'app web, mantenendo comunque l'opzione di controllo granulare su valori specifici se vuoi eseguire l'override dei valori predefiniti.
Inizializza senza argomenti
Per inizializzare l'SDK Firebase Admin SDK o Firebase JavaScript con i valori di configurazione predefiniti, utilizza initializeApp() senza fornire argomenti.
Admin SDK
import { initializeApp } from 'firebase-admin/app';
const app = initializeApp();
Per Admin SDK, questa strategia di inizializzazione funziona in App Hosting e in altri ambienti server di Google, tra cui Cloud Run, App Engine e funzioni Cloud Run.
SDK JavaScript
import { initializeApp } from 'firebase/app';
const app = initializeApp();
Per l'SDK JavaScript, questa strategia di inizializzazione funziona in App Hosting.
Esegui l'override dei valori compilati automaticamente
Puoi eseguire l'override della configurazione predefinita che viene inserita automaticamente. Tieni presente che queste opzioni sono diverse tra l'SDK Admin SDK e l'SDK JavaScript.
Admin SDK override
Per specificare facoltativamente opzioni di inizializzazione personalizzate per servizi come Realtime Database, Cloud Storage o Cloud Functions, utilizza la variabile di ambiente FIREBASE_CONFIG. Se i contenuti della variabile FIREBASE_CONFIG iniziano con un carattere {, verranno analizzati come oggetto JSON. In caso contrario, l'SDK presuppone che la stringa sia il percorso di un file JSON contenente le opzioni.
# apphosting.yaml
env:
- variable: FIREBASE_CONFIG
value: '{"databaseURL":"https://project-id-default-rtdb.firebaseio.com","projectId":"my-project-id"}'
Override dell'SDK JavaScript
Per eseguire l'override dei valori FIREBASE_WEBAPP_CONFIG predefiniti che App Hosting inserisce per l'inizializzazione dell'SDK JavaScript, puoi specificare i valori in apphosting.yaml:
# apphosting.yaml
env:
- variable: FIREBASE_WEBAPP_CONFIG
value: '{"apiKey":"myApiKey","appId":"app:123","authDomain":"project-id.firebaseapp.com","databaseURL":"https://project-id-default-rtdb.firebaseio.com","messagingSenderId":"0123456789","projectId":"project-id","storageBucket":"project-id.firebasestorage.app"}'
Utilizzo dell'inizializzazione automatica in altri ambienti
L'inizializzazione automatica viene configurata con uno script npm postinstall quando installi l'SDK Firebase JavaScript. Lo script postinstall cerca la variabile di ambiente FIREBASE_WEBAPP_CONFIG, che viene impostata automaticamente nell'ambiente Cloud Build App Hosting.
Se installi l'SDK JS al di fuori di Cloud Build, dovrai impostare questa variabile di ambiente manualmente quando installi l'SDK Firebase JavaScript.
Per configurare l'ambiente manualmente durante l'installazione:
Copia l'oggetto di configurazione dell'app web Firebase dalla console Firebase.
Da un terminale, imposta la variabile di ambiente
FIREBASE_WEBAPP_CONFIGprima di eseguire il comandonpm install.
FIREBASE_WEBAPP_CONFIG="{...}" npm install firebase
Ogni volta che modifichi il progetto Firebase o l'app web, esegui nuovamente questo comando. Potrebbe essere necessario svuotare anche le cache intermedie (come .next/cache).
Utilizza FirebaseServerApp per l'SSR
Se hai lavorato con l'SDK Firebase JS o altri SDK client Firebase nello sviluppo della tua app web, probabilmente hai familiarità con l'interfaccia FirebaseApp e con il modo in cui utilizzarla per configurare le istanze dell'app. Per facilitare operazioni simili sul lato server, Firebase fornisce FirebaseServerApp.
FirebaseServerApp è una variante di FirebaseApp da utilizzare negli ambienti di rendering lato server (SSR). Include strumenti per continuare le sessioni Firebase che si estendono oltre la divisione tra rendering lato client (CSR) e rendering lato server.
Usa FirebaseServerApp per:
- Eseguire il codice lato server nel contesto utente, a differenza di Firebase Admin SDK, che dispone di diritti amministrativi completi.
- Attiva l'utilizzo di App Check negli ambienti SSR.
- Continuare una sessione di Firebase Auth creata nel client.
Per i dettagli completi sull'utilizzo di FirebaseServerApp per questi scopi, consulta Utilizza Firebase nelle app web dinamiche con SSR.
Attiva App Check nella tua app web
Puoi utilizzare App Check per rafforzare la sicurezza della tua app web dinamica su App Hosting. Implementando alcune delle strategie specifiche lato server descritte in Utilizza Firebase nelle app web dinamiche con SSR, puoi proteggere i tuoi backend App Hosting da comportamenti illeciti.