Per installare o gestire le estensioni, ti deve essere assegnato uno di questi ruoli: Proprietario o Editor oppure Amministratore Firebase.
Visualizza i dettagli e la configurazione di un'istanza di un'estensione installata
Vai alla dashboard di Firebase Extensions nella console Firebase.
Nella scheda dell'istanza dell'estensione installata, fai clic su Gestisci.
Monitorare l'istanza di un'estensione installata
Nella console Firebase, puoi monitorare l'attività di un l'estensione, inclusi i controlli di integrità, utilizzo e log.
Imposta avvisi per il budget
L'impostazione di avvisi relativi al budget è una buona prassi in generale, ma gli avvisi possono essere è particolarmente importante quando ti fidi dell'esecuzione del codice di un'altra parte progetto.
Assicurati di configurare gli avvisi sul budget per il tuo progetto Firebase.
Visualizza le funzioni create dalle estensioni
Vai alla dashboard Funzioni della console Firebase.
Nella scheda Dashboard puoi visualizzare le funzioni da Firebase Extensions (insieme a qualsiasi altra funzione di cui hai eseguito il deployment per il tuo progetto).
Le funzioni create dalle estensioni hanno nomi nel formato:
ext-extension-instance-id-functionName
Ad esempio:
ext-awesome-task-simplifier-onUserCreate
Visualizza Cloud Scheduler job creati dalle estensioni
Aprire la pagina Cloud Scheduler del progetto nella console Google Cloud.
Nell'elenco dei job, puoi visualizzare Cloud Scheduler job da Firebase Extensions (insieme a eventuali altri job che hai creato per progetto).
I job creati dalle estensioni hanno nomi nel formato:
firebase-ext-extension-instance-id-functionName
Ad esempio:
firebase-ext-awesome-task-simplifier-doTask
Visualizza e gestisci Cloud Tasks accodato dalle 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.
Di solito, queste attività vengono eseguite e completate automaticamente, senza il tuo intervento. Tuttavia, se dovessi avere la necessità di gestire manualmente le estensioni in coda attività, ad esempio per mettere in pausa la coda o rimuovere dalla coda un'attività non è ancora iniziato, procedi nel seguente modo:
Nella console Firebase Estensioni apri la pagina dei dettagli dell'istanza dell'estensione.
Nella pagina dei dettagli, apri la sezione API e risorse. Se utilizza Cloud Tasks, sarà presente la sezione Coda di Cloud Tasks con una o più voci.
Fai clic su Visualizza coda per la coda da gestire. Si aprirà Pagina dei dettagli della coda nella console Google Cloud, da cui puoi visualizzare attività in coda, mettere in pausa la coda, rimuovere attività dalla coda e così via. Consulta Gestire code e attività nella documentazione di Cloud Tasks.
Visualizza i secret di Cloud Secret Manager creati dalle estensioni
Apri la pagina Secret Manager del tuo progetto nella console Google Cloud.
Nell'elenco dei secret, puoi visualizzare i secret creati per Firebase Extensions (insieme a tutti gli altri secret che hai creato per il progetto).
I secret creati dalle estensioni hanno nomi 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 Firebase Extensions) nella console.
Nella scheda Salute della dashboard Funzioni, puoi: visualizzare una panoramica degli errori e informazioni sulle prestazioni per tutte le funzioni in del progetto.
Per visualizzare le informazioni relative a un'estensione specifica, utilizza il filtro nella parte superiore di nella pagina per selezionare una funzione specifica.
Controllare la frequenza di esecuzione di un'estensione installata
Nella scheda Dashboard della dashboard Funzioni, individua la funzione specifica per Firebase Extension che che vuoi controllare.
Fai clic su
(il menu extra) su all'estrema destra della voce e seleziona Statistiche dettagliate sull'utilizzo.Nella console Google Cloud visualizzata, puoi visualizzare in dettaglio vari a una funzione e anche di ispezionare il suo codice sorgente.
Visualizza i log per un'estensione
Se stai tentando di eseguire il debug del tuo progetto o di inviare una segnalazione di bug a Firebase, utile per visualizzare i log delle funzioni in esecuzione nel progetto.
Nella scheda Log della dashboard Funzioni, utilizza il filtro in corrispondenza nella parte superiore della pagina per selezionare le funzioni create dalla tua estensione.
Aggiorna l'istanza di un'estensione installata alla versione più recente
Puoi aggiornare l'istanza installata di un'estensione all'ultima release completamente gestita. Ti consigliamo di aggiornare un'istanza installata perché è sono già in esecuzione o configurati nel flusso di lavoro di test, progetto o app.
Quando aggiorni un'istanza, tutte le risorse specifiche dell'estensione dell'istanza viene sovrascritta 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 dashboard di Firebase Extensions, quindi sull'app scheda dell'istanza dell'estensione, fai clic su Gestisci.
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.
Controlla le novità dell'aggiornamento e configura l'estensione (se necessario).
Fai clic su Aggiorna estensione.
Riconfigura l'istanza di un'estensione installata
Puoi modificare i valori dei parametri configurati dall'utente per un dell'estensione. Questi nuovi valori verranno utilizzati in tutti gli trigger futuri dell'istanza, ma tutti gli elementi strutturali o gli elementi precedenti creati dall'estensione (come le immagini archiviate o i bucket di archiviazione esistenti) non verranno modificati.
Vai alla dashboard di Firebase Extensions, quindi all'estensione installata dell'istanza, fai clic su Gestisci.
Nell'angolo in alto a destra, fai clic su Riconfigura estensione.
Segui le istruzioni sullo schermo per riconfigurare i valori dei parametri per l'estensione.
Fai clic su Salva.
Disinstallare un'istanza di estensione
Puoi disinstallare l'istanza di un'estensione dal progetto Firebase. Questa azione elimina il account di servizio e tutte le risorse (come un insieme di funzioni) creato da Firebase appositamente per l'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 Cloud Storage bucket. Anche se l'estensione ha interagito con queste altre risorse, non sono specifiche per le estensioni, pertanto non vengono eliminate se l'estensione viene disinstallata.
Per 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.
Controlla che cosa verrà eliminato, quindi fai clic su Disinstalla estensione per confermare. l'eliminazione.