Puoi installare (e gestire ) qualsiasi estensione Firebase ufficiale utilizzando la console Firebase o l'interfaccia a riga di comando (interfaccia a riga di comando) di Firebase .
Assicurati di esaminare le differenze nelle azioni supportate per l'interfaccia a riga di comando di Firebase e la console Firebase.
Per installare o gestire le estensioni, devi essere assegnato a uno di questi ruoli: Proprietario o Editor o Amministratore Firebase .
Per installare un'estensione, il tuo progetto deve essere nel piano Blaze (a consumo). Sebbene non vi siano costi per l'installazione di un'estensione, potrebbe esserti addebitato l'utilizzo dei servizi Firebase o dei servizi cloud come Cloud Secret Manager , se il tuo utilizzo supera il livello gratuito dei servizi.
Prima di iniziare
Se non l'hai già fatto, aggiungi Firebase al tuo progetto e aggiorna il tuo progetto Firebase al piano Blaze (pagamento a consumo).
Passaggio 1 : visualizza informazioni dettagliate su un'estensione
Questo passaggio è facoltativo, ma fortemente consigliato.
Prima di installare un'estensione Firebase, ti consigliamo di rivedere le informazioni dettagliate sull'estensione, tra cui:
- Come funziona l'estensione, eventuali attività di pre-installazione e dettagli sull'estensione
- Informazioni generali di identificazione e descrizione
- Se le attività dell'estensione richiedono un account di fatturazione
- Servizi Google (API) e ruoli di accesso richiesti per il funzionamento
- Risorse create per l'estensione (come le funzioni)
- Descrizioni dei parametri configurabili dall'utente
Per visualizzare le informazioni dettagliate di un'estensione:
Sfoglia le estensioni Firebase ufficiali nell'Hub delle estensioni .
Fare clic sulla scheda di un'estensione per:
Visualizza le informazioni dettagliate per l'estensione.
Trova il link al codice sorgente dell'estensione nel repository dei sorgenti di Firebase Extensions .
Nella directory delle estensioni dell'estensione , puoi visualizzare queste informazioni dettagliate nel
README
.
Passaggio 2 : installa un'estensione
Durante il processo di installazione, ti verrà chiesto di rivedere le specifiche di base per l'estensione (come API abilitate, risorse create, accesso concesso, ecc.). Riceverai una notifica di eventuali requisiti di fatturazione e ti verrà anche richiesto di specificare i valori per i parametri configurabili dell'estensione.
Sfoglia le estensioni Firebase ufficiali nell'Hub delle estensioni .
Fare clic sulla scheda di un'estensione, quindi rivedere le informazioni dettagliate per l'estensione, che possono offrire istruzioni di utilizzo specifiche ed eventuali attività di pre-installazione.
Fare clic su Installa , quindi seguire le istruzioni sullo schermo per installare l'estensione.
Passaggio 3 : completare la configurazione post-installazione
Alcune estensioni prevedono passaggi obbligatori o facoltativi da completare prima di utilizzarle. Trova queste istruzioni nella pagina dei dettagli post-installazione dell'estensione nella dashboard Estensioni della console Firebase (il collegamento specifico alla dashboard viene visualizzato nel terminale dopo l'installazione).
Puoi anche trovare queste istruzioni nel file POSTINSTALL.md
incluso nella directory dei sorgenti dell'estensione .
Crea risorse Firebase
Se hai configurato l'estensione per utilizzare risorse Firebase (raccolte Cloud Firestore, percorsi Realtime Database, bucket Cloud Storage) che non esistono già, creale prima di utilizzare l'estensione.
Crea gestori di eventi Eventarc
Alcune estensioni pubblicano su Eventarc quando si verificano eventi importanti durante l'esecuzione. Se un'estensione pubblica eventi e hai abilitato gli eventi durante l'installazione, puoi scrivere funzioni che reagiscono a questi eventi con la tua logica personalizzata. Ciò può essere utile, ad esempio, per notificare agli utenti il completamento di attività di lunga durata o per post-elaborare l'output di una funzione di estensione.
Consulta la documentazione dell'estensione per un elenco di eventi (se presenti) che pubblica. Ad esempio, vedi i tipi di evento per l'estensione Esegui pagamenti con Stripe .
Quindi, consulta Trigger di eventi personalizzati per informazioni sulla scrittura di gestori di eventi Eventarc.
Installa più istanze di estensione
Puoi installare la stessa estensione più di una volta nello stesso progetto. Ogni istanza installata può avere la propria configurazione personalizzata e le proprie risorse di estensione. Identifichi e fai riferimento a ogni istanza installata utilizzando il relativo ID istanza , che è univoco all'interno del tuo progetto. Ti verrà chiesto di confermare o modificare l'ID istanza di ogni istanza aggiuntiva dell'estensione che installi.
Prossimi passi
Visualizza i dettagli e la configurazione dell'estensione installata nella console Firebase.
Monitora l'attività dell'estensione installata, inclusi controlli sulla sua integrità, utilizzo e registri.
Utilizzando la console Firebase, gestisci l'estensione installata. Per le estensioni Firebase ufficiali, puoi riconfigurare o disinstallare l'estensione, nonché aggiornarla all'ultima versione.
Come best practice per tutti i progetti, assicurati di impostare avvisi di budget per il tuo progetto e di monitorare la dashboard di utilizzo e fatturazione nella console di Firebase.