Gestisci le estensioni Firebase installate

Per installare o gestire le estensioni, devi essere assegnato a uno di questi ruoli: Proprietario o Editor o Amministratore Firebase .

Elenca le istanze di estensione 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

Monitorare un'istanza di estensione installata

Nella console di Firebase, puoi monitorare l'attività di un'estensione installata, inclusi controlli sulla sua integrità, utilizzo e registri.

Imposta avvisi di budget

L'impostazione degli avvisi di budget è una buona pratica in generale, ma gli avvisi possono essere particolarmente importanti quando ritieni che il codice di un'altra parte venga eseguito nel tuo progetto.

Assicurati di impostare gli avvisi di 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 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 lavori di Cloud Scheduler creati dalle estensioni

Apri la pagina Cloud Scheduler del tuo progetto in Google Cloud Console.
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 che vengono 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 hai 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, procedi nel seguente modo:

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 delle code di Cloud Task con una o più voci.
Fare clic su Visualizza coda per la coda che si desidera gestire. Verrà aperta la pagina Dettagli coda in 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.
Nota: puoi mettere in pausa una coda, ma se la lasci in pausa troppo a lungo, le attività potrebbero non riuscire con errori di autenticazione quando riprendi la coda. (L'autenticazione dell'attività scade un'ora dopo l'aggiunta alla coda.)
Attenzione: non eliminare la coda; l'estensione ne ha bisogno per funzionare. Se elimini accidentalmente la coda, dovrai fare quanto segue:
1. Installa una nuova istanza dell'estensione.
2. Solo dopo aver installato la nuova istanza, disinstallare la vecchia istanza.

Visualizza i segreti di Cloud Secret Manager creati dalle estensioni

Apri la pagina Secret Manager del tuo progetto in Google Cloud Console.
Nell'elenco Segreti, puoi visualizzare i segreti creati per Firebase Extensions (insieme a qualsiasi altro segreto che hai creato per il tuo progetto).
I secret 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 (inclusi quelli creati da Firebase Extensions) nella console.

Nella scheda Integrità del dashboard Funzioni , puoi visualizzare una panoramica degli errori e informazioni sulle prestazioni per tutte le funzioni nel tuo progetto.
Per visualizzare le informazioni per un'estensione specifica, utilizzare il filtro nella parte superiore della pagina per selezionare una funzione specifica.

Controlla la frequenza di esecuzione di un'estensione installata

Nella scheda Dashboard della dashboard Funzioni , individua la funzione specifica per l'estensione Firebase che desideri controllare.
Fai clic su (il menu di overflow) all'estrema destra della voce, quindi seleziona Statistiche di utilizzo dettagliate .
Nella Google Cloud Console visualizzata, puoi approfondire 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 tuo progetto o di inviare una segnalazione di bug a Firebase, è utile visualizzare i log delle funzioni in esecuzione nel tuo progetto.

Nella scheda Registri 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

È possibile aggiornare un'istanza installata di un'estensione all'ultima versione 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 sarai in grado di specificare i valori per eventuali nuovi parametri.

Per aggiornare un'istanza di estensione nel manifest delle estensioni alla versione più recente, esegui il comando extension update:
```
firebase ext:update extensionInstanceId
```
Per eseguire l'aggiornamento a una versione specifica, fornisci la versione a cui desideri eseguire l'aggiornamento:
```
firebase ext:update extensionInstanceId versionNumber
```
Quindi, per distribuire le estensioni nel tuo manifest su un progetto Firebase, esegui:
```
firebase deploy --only extensions --project=projectId-or-alias
```

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 qualsiasi trigger futuro 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.

Per riconfigurare in modo interattivo un'estensione nel tuo extensions manifest , esegui il comando extension configure :
```
firebase ext:configure extensionInstanceId
```
Nota: per impostazione predefinita, tutti i prompt utilizzano i valori correnti per l'estensione installata anziché i valori predefiniti disponibili durante l'installazione iniziale (quelli elencati come valori predefiniti nel file extension.yaml ).
Quindi, per distribuire le estensioni nel tuo manifest in un progetto Firebase, esegui:
```
firebase deploy --only extensions --project=projectId-or-alias
```

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 cancellati:

Eventuali artefatti creati dall'estensione (come le immagini memorizzate).
Qualsiasi altra risorsa nel tuo progetto, come un'istanza di database o un bucket di Cloud Storage. 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:

Per rimuovere un'istanza di estensione dal file manifest delle estensioni , esegui il comando extension uninstall:
```
firebase ext:uninstall extensionInstanceId
```
Quindi, per distribuire le modifiche al tuo manifest su un progetto Firebase, esegui:
```
firebase deploy --only extensions --project=projectId-or-alias
```