Per installare o gestire le estensioni, devi disporre di uno dei seguenti ruoli: Proprietario o Editor o Amministratore Firebase.
Elenca le istanze di estensioni installate di un progetto
Puoi elencare ogni istanza delle estensioni che hai installato.
Esegui il comando extensions-list:
firebase ext:list --project=projectId-or-alias
Visualizzare i dettagli e la configurazione di un'istanza dell'estensione installata
Vai alla dashboard di Firebase Extensions nella console Firebase.
Nella scheda dell'istanza dell'estensione installata, fai clic su Gestisci.
Monitorare un'istanza di un'estensione installata
Nella console Firebase puoi monitorare l'attività di un'estensione installata, inclusi i controlli relativi a integrità, utilizzo e log.
Imposta avvisi per il budget
L'impostazione di avvisi sul budget è una buona prassi in generale, ma gli avvisi possono essere particolarmente importanti quando consenti l'esecuzione del codice di terze parti nel tuo progetto.
Assicurati di configurare avvisi relativi al budget per il progetto Firebase.
Visualizza le funzioni create dalle estensioni
Vai alla dashboard Funzioni della console Firebase.
Nella scheda Dashboard puoi visualizzare le funzioni di Firebase Extensions (insieme a tutte le altre funzioni di cui hai eseguito il deployment per il progetto).
Le funzioni create dalle estensioni hanno nomi nel formato:
ext-extension-instance-id-functionName
Ad esempio:
ext-awesome-task-simplifier-onUserCreate
Visualizza i job Cloud Scheduler creati dalle estensioni
Apri la pagina Cloud Scheduler del progetto nella console Google Cloud.
Nell'elenco Job, puoi visualizzare i job Cloud Scheduler di Firebase Extensions (insieme a tutti gli altri job che hai creato per il tuo progetto).
I job creati dalle estensioni hanno nomi nel formato:
firebase-ext-extension-instance-id-functionName
Ad esempio:
firebase-ext-awesome-task-simplifier-doTask
Visualizzare e gestire le attività Cloud Tasks in coda per le estensioni
Alcune estensioni utilizzano Cloud Tasks per eseguire attività che richiedono più tempo: in genere, attività di elaborazione che vengono eseguite in vari punti del ciclo di vita di un'estensione, come installazione, ricoconfigurazione e dopo gli upgrade.
In genere, queste attività vengono eseguite e completate automaticamente, senza il tuo intervento. Tuttavia, se devi gestire manualmente le attività in coda di un'estensione, ad esempio per mettere in pausa la coda o rimuovere dalla coda un'attività che non è ancora iniziata, segui questi passaggi:
Nella sezione Estensioni della console Firebase, apri la pagina dei dettagli dell'istanza dell'estensione.
Nella pagina dei dettagli, apri la sezione API e risorse. Se l'estensione utilizza Cloud Tasks, sarà presente una sezione Coda di Cloud Tasks con una o più voci.
Fai clic su Visualizza coda per la coda che vuoi gestire. Si aprirà la pagina Dettagli coda nella console Google Cloud, da cui puoi visualizzare le attività in coda, mettere in pausa la coda, rimuovere le attività dalla coda e così via. Vedi Gestire code e attività nella documentazione di Cloud Tasks.
Visualizzare i secret di Cloud Secret Manager creati dalle estensioni
Apri la pagina Gestore dei segreti del progetto nella console Google Cloud.
Nell'elenco Secret, puoi visualizzare i secret creati per Firebase Extensions (insieme a eventuali altri secret che hai creato per il tuo progetto).
I nomi dei secret creati dalle estensioni sono nel formato:
ext-extension-instance-id-paramnName
Ad esempio:
ext-awesome-task-simplifier-API_KEY
I secret sono etichettati con la chiave
firebase-extensions-managed
. Non rimuovere questa etichetta, a meno che tu non voglia impedire a Firebase di gestire il secret.
Verificare se un'estensione installata è in stato di esecuzione
Puoi esaminare tutti gli errori delle funzioni (inclusi quelli creati da Firebase Extensions) nella console.
Nella scheda Integrità della dashboard Funzioni, puoi visualizzare una panoramica degli errori e delle informazioni sulle prestazioni di tutte le funzioni del progetto.
Per visualizzare le informazioni relative a un'estensione specifica, utilizza il filtro in alto nella pagina per selezionare una funzione specifica.
Controllare la frequenza di esecuzione di un'estensione installata
Nella scheda Dashboard della dashboard di Functions, locate la funzione specifica per il Firebase Extension che vuoi controllare.
Fai clic su
(il menu extra) in fondo a destra nella voce e seleziona Statistiche dettagliate sull'utilizzo.Nella console Google Cloud visualizzata, puoi visualizzare in dettaglio le varie invocazioni di una funzione e persino ispezionarne il codice sorgente.
Visualizza i log per un'estensione
Se stai tentando di eseguire il debug del progetto o di inviare una segnalazione di bug a Firebase, è utile visualizzare i log delle funzioni in esecuzione nel progetto.
Nella scheda Log della dashboard di Funzioni, utilizza il filtro nella parte superiore della pagina per selezionare le funzioni create dall'estensione.
Aggiornare un'istanza dell'estensione installata all'ultima versione
Puoi aggiornare l'istanza installata di un'estensione all'ultima versione rilasciata. Potresti voler aggiornare un'istanza installata perché è già in esecuzione o configurata nel flusso di lavoro di test, progetto o app.
Quando aggiorni un'istanza, tutte le risorse e la logica specifiche dell'estensione dell'istanza vengono sovrascritte per utilizzare il codice sorgente e i file della nuova versione. L'ID istanza e l'account di servizio dell'estensione non cambieranno.
Durante la procedura di aggiornamento, riceverai una notifica di eventuali modifiche alla nuova versione e potrai specificare i valori per i nuovi parametri.
Vai alla tua dashboard Firebase Extensions, quindi fai clic su Gestisci nella scheda dell'istanza dell'estensione installata.
Nell'angolo in alto a destra, fai clic su Aggiorna estensione.
Se non è disponibile una nuova versione dell'estensione, nella pagina dei dettagli non sarà presente un pulsante di aggiornamento.
Esamina le novità dell'aggiornamento e configura l'estensione (se necessario).
Fai clic su Aggiorna estensione.
Riconfigurare un'istanza dell'estensione installata
Puoi modificare i valori dei parametri configurati dall'utente per un'istanza dell'estensione installata. Questi nuovi valori verranno utilizzati in qualsiasi trigger futuro dell'istanza, ma tutti gli artefatti o gli elementi strutturali precedenti creati dall'estensione (come immagini archiviate o bucket di archiviazione esistenti) non verranno modificati.
Vai alla dashboard di Firebase Extensions, quindi fai clic su Gestisci nella scheda dell'istanza dell'estensione installata.
Nell'angolo in alto a destra, fai clic su Riconfigura estensione.
Segui le istruzioni sullo schermo per riconfigurare i valori parametro per l'estensione.
Fai clic su Salva.
Disinstallare un'istanza di estensione
Puoi disinstallare un'istanza di un'estensione dal tuo progetto Firebase. Questa azione elimina l'account di servizio e tutte le risorse (ad esempio un insieme di funzioni) che Firebase ha creato appositamente per quell'istanza dell'estensione. Tuttavia, i seguenti elementi non vengono eliminati:
Eventuali artefatti creati dall'estensione (come le immagini archiviate).
Qualsiasi altra risorsa nel progetto, ad esempio un'istanza di database o un bucket Cloud Storage. Anche se l'estensione ha interagito con queste altre risorse, esse non sono specifiche per l'estensione, pertanto non vengono eliminate se l'estensione viene disinstallata.
Ecco come disinstallare un'estensione:
Vai alla dashboard di Firebase Extensions, quindi fai clic su Gestisci nella scheda dell'istanza dell'estensione installata.
Nella parte inferiore dello schermo, fai clic su Disinstalla estensione.
Rivedi gli elementi che verranno eliminati, quindi fai clic su Disinstalla estensione per confermare l'eliminazione.