Gestisci le estensioni Firebase installate

Per installare o gestire le estensioni, è necessario che ti venga assegnato uno di questi ruoli: Proprietario o Editor o Amministratore Firebase .

Visualizza i dettagli e la configurazione di un'istanza di estensione installata

  1. Vai alla dashboard delle estensioni Firebase nella console Firebase.

  2. Sulla scheda dell'istanza dell'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 sulla sua integrità, utilizzo e registri.

Imposta avvisi sul budget

L'impostazione degli avvisi di budget è una buona pratica in generale, ma gli avvisi possono essere particolarmente importanti quando ti fidi dell'esecuzione del codice di un'altra parte nel tuo progetto.

Assicurati di impostare avvisi di budget per il tuo progetto Firebase.

Visualizza le funzioni create dalle estensioni

  1. Vai alla dashboard Funzioni della console Firebase.

  2. Nella scheda Dashboard , puoi visualizzare le funzioni di Firebase Extensions (insieme a qualsiasi altra funzione che hai distribuito 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 i processi Cloud Scheduler creati dalle estensioni

  1. Apri la pagina Cloud Scheduler del tuo progetto nella console Google Cloud.

  2. Nell'elenco dei lavori, puoi visualizzare i lavori di Cloud Scheduler da Firebase Extensions (insieme a qualsiasi altro lavoro che hai creato per il tuo progetto).

    I lavori creati dalle estensioni hanno nomi nel formato: firebase-ext- extension-instance-id - functionName

    Ad esempio: firebase-ext-awesome-task-simplifier-doTask

Visualizza e gestisci le attività Cloud accodate dalle estensioni

Alcune estensioni utilizzano Cloud Tasks per eseguire attività di lunga durata: più comunemente, attività di elaborazione eseguite in vari punti del ciclo di vita di un'estensione: installazione, riconfigurazione e dopo gli aggiornamenti.

Normalmente, queste attività vengono eseguite e completate automaticamente, senza il tuo intervento. Tuttavia, se avessi bisogno di 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:

  1. Nella sezione Estensioni della console Firebase, apri la pagina dei dettagli dell'istanza dell'estensione.

  2. Nella pagina dei dettagli, apri la sezione API e risorse . Se l'estensione utilizza Cloud Tasks, sarà presente una sezione relativa alle code di Cloud Task con una o più voci.

  3. Fai clic su Visualizza coda per la coda che desideri gestire. Verrà aperta la pagina Dettagli coda nella console Google Cloud, da cui potrai visualizzare le attività in coda, mettere in pausa la coda, rimuovere attività dalla coda e così via. Vedi Gestire code e attività nella documentazione di Cloud Tasks.

Visualizza i segreti di Cloud Secret Manager creati dalle estensioni

  1. Apri la pagina Secret Manager del tuo progetto nella console Google Cloud.

  2. Nell'elenco Segreti puoi visualizzare i segreti creati per Firebase Extensions (insieme a tutti gli altri segreti che hai creato per il tuo progetto).

    I segreti creati dalle estensioni hanno nomi nel formato: ext- extension-instance-id - paramnName

    Ad esempio: ext-awesome-task-simplifier-API_KEY

    I segreti sono etichettati con la chiave firebase-extensions-managed . Non rimuovere questa etichetta a meno che tu non voglia impedire a Firebase di gestire il segreto.

Controlla se un'estensione installata è integra

Puoi esaminare tutti gli errori delle funzioni (incluse quelle create da Firebase Extensions) nella console.

  1. Nella scheda Integrità del dashboard Funzioni , puoi visualizzare una panoramica degli errori e delle informazioni sulle prestazioni per tutte le funzioni del tuo progetto.

  2. Per visualizzare le informazioni per un'estensione specifica, utilizza il filtro nella parte superiore della pagina per selezionare una funzione specifica.

Controlla la frequenza con cui viene eseguita un'estensione installata

  1. Nella scheda Dashboard della dashboard Funzioni , individua la funzione specifica per l'estensione Firebase che desideri controllare.

  2. Fai clic su (il menu extra) all'estrema destra della voce, quindi seleziona Statistiche di utilizzo dettagliate .

  3. Nella console Google Cloud visualizzata, puoi approfondire 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 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 Funzioni , utilizza il filtro nella parte superiore della pagina per selezionare le funzioni create dalla tua estensione.

Aggiorna un'istanza di estensione installata alla versione più recente

Puoi aggiornare un'istanza installata di un'estensione alla versione più recente rilasciata. Potresti voler aggiornare un'istanza installata perché l'istanza è già attivamente 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 il processo di aggiornamento, riceverai una notifica di eventuali modifiche per la nuova versione e potrai specificare valori per eventuali nuovi parametri.

  1. Vai alla dashboard delle estensioni Firebase , quindi nella scheda dell'istanza dell'estensione installata fai clic su Gestisci .

  2. Nell'angolo in alto a destra, fai clic su Aggiorna estensione .

    Se per l'estensione non è disponibile una nuova versione, la pagina dei dettagli non avrà un pulsante di aggiornamento.

  3. Controlla le novità dell'aggiornamento e configura l'estensione (se necessario).

  4. Fai clic su Aggiorna estensione .

Riconfigurare un'istanza di estensione installata

È possibile modificare i valori dei parametri configurati dall'utente per un'istanza di estensione installata. Questi nuovi valori verranno utilizzati in eventuali trigger futuri 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.

  1. Vai alla dashboard delle estensioni Firebase , quindi nella scheda dell'istanza dell'estensione installata fai clic su Gestisci .

  2. Nell'angolo in alto a destra, fai clic su Riconfigura estensione .

  3. Segui le istruzioni visualizzate sullo schermo per riconfigurare i valori dei parametri per la tua estensione.

  4. Fare 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. Non vengono invece eliminati:

  • Eventuali artefatti creati dall'estensione (come le immagini archiviate).

  • Qualsiasi altra risorsa nel tuo progetto, come un'istanza di database o un bucket Cloud Storage. Anche se l'estensione ha interagito con queste altre risorse, queste non sono specifiche dell'estensione , quindi non vengono eliminate se l'estensione viene disinstallata.

Ecco come disinstallare un'estensione:

  1. Vai alla dashboard delle estensioni Firebase , quindi nella scheda dell'istanza dell'estensione installata fai clic su Gestisci .

  2. Nella parte inferiore dello schermo, fai clic su Disinstalla estensione .

  3. Controlla cosa verrà eliminato, quindi fai clic su Disinstalla estensione per confermare l'eliminazione.