Per installare o gestire le estensioni, devi disporre di uno dei seguenti ruoli: Proprietario o Editor o Amministratore Firebase.
Elencare le istanze di estensione installate di un progetto
Puoi elencare ogni istanza delle estensioni installate.
Esegui il comando extensions-list:
firebase ext:list --project=projectId-or-alias
Visualizzare i dettagli e la configurazione di un'istanza di estensione installata
Vai alla tua Firebase Extensions dashboard nella Firebase console.
Nella scheda dell'istanza di estensione installata, fai clic su Gestisci.
Monitorare un'istanza di estensione installata
Nella console Firebase, puoi monitorare l'attività di un'estensione installata , inclusi i controlli su integrità, utilizzo e log.
Impostare avvisi per il budget
L'impostazione di avvisi per il budget è una buona pratica in generale, ma gli avvisi potrebbero essere particolarmente importanti quando affidi l'esecuzione del codice di terze parti nel tuo progetto.
Assicurati di configurare gli avvisi per il budget per il tuo progetto Firebase.
Visualizzare le funzioni create dalle estensioni
Vai alla dashboard delle funzioni della console Firebase.
Nella scheda Dashboard, puoi visualizzare le funzioni da Firebase Extensions (insieme a tutte le altre funzioni di cui hai eseguito il deployment per il tuo progetto).
Le funzioni create dalle estensioni hanno nomi nel formato:
ext-extension-instance-id-functionNameAd esempio:
ext-awesome-task-simplifier-onUserCreate
Visualizzare i job Cloud Scheduler creati dalle estensioni
Apri la pagina Cloud Scheduler del tuo progetto nella console Google Cloud.
Nell'elenco Job, puoi visualizzare i job Cloud Scheduler da 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-functionNameAd esempio:
firebase-ext-awesome-task-simplifier-doTask
Visualizzare e gestire le attività di Cloud Tasks inserite in coda dalle estensioni
Alcune estensioni utilizzano Cloud Tasks per eseguire attività di lunga durata: in genere, attività di elaborazione eseguite in vari punti del ciclo di vita di un'estensione: installazione, riconfigurazione 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 Firebase console Estensioni apri la pagina dei dettagli dell'istanza di estensione.
Nella pagina dei dettagli, apri la sezione API e risorse. Se l'estensione utilizza Cloud Tasks, sarà presente una sezione Code di attività di Cloud Tasks con una o più voci.
Fai clic su Visualizza coda per la coda che vuoi gestire. Viene visualizzata la pagina dei dettagli della coda nella Google Cloud console, da cui puoi visualizzare le attività in coda, mettere in pausa la coda, rimuovere le attività dalla coda e così via. Consulta Gestire code e attività nella documentazione di Cloud Tasks.
Visualizzare i secret di Cloud Secret Manager creati dalle estensioni
Apri la pagina Secret Manager del tuo progetto nella console Google Cloud.
Nell'elenco Secret, puoi visualizzare i secret creati per Firebase Extensions (insieme a tutti gli altri secret che hai creato per il tuo progetto).
I secret creati dalle estensioni hanno nomi nel formato:
ext-extension-instance-id-paramnNameAd esempio:
ext-awesome-task-simplifier-API_KEYI 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 è integra
Puoi esaminare tutti gli errori delle funzioni (incluse quelle create da Firebase Extensions) nella console.
Nella scheda Integrità della dashboard delle funzioni, puoi visualizzare una panoramica degli errori e delle informazioni sulle prestazioni di tutte le funzioni del tuo progetto.
Per visualizzare le informazioni relative a un'estensione specifica, utilizza il filtro nella parte superiore della pagina per selezionare una funzione specifica.
Verificare la frequenza di esecuzione di un'estensione installata
Nella scheda Dashboard della dashboard delle funzioni, individua la funzione specifica per Firebase Extension che vuoi controllare.
Fai clic su (il menu overflow) all' estrema destra della voce, quindi seleziona Statistiche di utilizzo dettagliate.
Nella console Google Cloud visualizzata, puoi visualizzare in dettaglio le varie invocazioni di una funzione e persino ispezionare il relativo codice sorgente.
Visualizzare i log di un'estensione
Se stai cercando di eseguire il debug del tuo progetto o di inviare una segnalazione di bug a Firebase, è utile visualizzare i log delle funzioni in esecuzione nel tuo progetto.
Nella scheda Log della dashboard delle funzioni, utilizza il filtro nella parte superiore della pagina per selezionare le funzioni create dall'estensione.
Aggiornare un'istanza di estensione installata all'ultima versione
Puoi aggiornare un'istanza installata di un'estensione all'ultima versione rilasciata. Potresti voler aggiornare un'istanza installata perché è già in esecuzione attiva 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 per la nuova versione e potrai specificare i valori per tutti i nuovi parametri.
Vai alla dashboard Firebase Extensions, quindi fai clic su Gestisci nella scheda dell'istanza di estensione installata.
Nell'angolo in alto a destra, fai clic su Aggiorna estensione.
Se l'estensione non ha una nuova versione disponibile, la pagina dei dettagli non avrà un pulsante di aggiornamento.
Esamina le novità dell'aggiornamento e configura l'estensione (se necessario).
Fai clic su Aggiorna estensione.
Riconfigurare un'istanza di estensione installata
Puoi modificare i valori dei parametri configurati dall'utente per un'istanza di estensione installata. Questi nuovi valori verranno utilizzati in tutti i trigger futuri dell'istanza, ma tutti gli artefatti o gli elementi strutturali precedenti creati dall'estensione (come le immagini archiviate o i bucket di archiviazione esistenti) non verranno modificati.
Vai alla dashboard Firebase Extensions, quindi fai clic su Gestisci nella scheda dell'istanza di estensione installata.
Nell'angolo in alto a destra, fai clic su Riconfigura estensione.
Segui le istruzioni sullo schermo per riconfigurare i valori dei parametri dell'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 (come un insieme di funzioni) che Firebase ha creato appositamente per quell'istanza dell'estensione. Tuttavia, i seguenti elementi non vengono eliminati:
Tutti gli artefatti creati dall'estensione (ad esempio le immagini archiviate).
Qualsiasi altra risorsa nel tuo progetto, come un'istanza di database o Cloud Storage bucket. Anche se l'estensione ha interagito con queste altre risorse, non sono specifiche dell'estensione, quindi non vengono eliminate se l'estensione viene disinstallata.
Ecco come disinstallare un'estensione:
Vai alla dashboard Firebase Extensions, quindi fai clic su Gestisci nella scheda dell'istanza di estensione installata.
Nella parte inferiore dello schermo, fai clic su Disinstalla estensione.
Esamina gli elementi che verranno eliminati, quindi fai clic su Disinstalla estensione per confermare l'eliminazione.