Gerenciar extensões do Firebase instaladas

Para instalar ou gerenciar extensões, é necessário atribuir um destes papéis: Proprietário ou Editor ou Administrador do Firebase.

Listar as instâncias de extensões instaladas de um projeto

É possível listar todas as instâncias das extensões instaladas.

Execute o comando extensions-list:

firebase ext:list --project=projectId-or-alias

Monitorar uma instância de extensão instalada

No Console do Firebase, é possível monitorar a atividade de uma extensão instalada, incluindo verificações de integridade, uso e registros.

Definir alertas de orçamento

Definir alertas de orçamento é uma prática recomendada, em geral, mas os alertas podem ser especialmente importantes quando você precisa confiar no código de outra pessoa que será executado no projeto.

Certifique-se de configurar alertas de orçamento para seu projeto do Firebase.

Ver funções criadas por extensões

Acesse o painel do Functions do Console do Firebase.
Na guia Painel, é possível ver as funções das Extensões do Firebase (junto de outras funções implantadas no projeto).

As funções criadas por extensões têm nomes, no formato: ext-extension-instance-id-functionName

Por exemplo: ext-awesome-task-simplifier-onUserCreate

Conferir jobs do Cloud Scheduler criados por extensões

Abra a página Cloud Scheduler do projeto no console do Google Cloud.
Na lista de jobs, é possível conferir os jobs do Cloud Scheduler nas Extensões do Firebase (junto de outros jobs criados para o projeto).

Os jobs criados pelas extensões têm nomes no formato: firebase-ext-extension-instance-id-functionName

Por exemplo: firebase-ext-awesome-task-simplifier-doTask

Conferir e gerenciar as tarefas na fila de uma extensão

Algumas extensões usam tarefas do Cloud para executar tarefas de longa duração: normalmente, processar tarefas executadas em vários pontos no ciclo de vida de uma extensão: instalação, reconfiguração e depois dos upgrades.

Normalmente, essas tarefas são executadas e concluídas automaticamente sem a sua intervenção. No entanto, se você precisar gerenciar manualmente as tarefas na fila de uma extensão, por exemplo, para pausar a fila ou remover uma tarefa que ainda não foi iniciada, siga estas instruções:

Na seção Extensões do Console do Firebase, abra a página de detalhes da instância da extensão.
Na página de detalhes, abra a seção APIs e recursos. Se for uma extensão que usa o Cloud Tasks, haverá uma seção Filas de tarefas do Cloud com uma ou mais entradas.
Clique em Ver fila na você quer gerenciar. Isso vai abrir a página "Detalhes da fila" no console do Google Cloud, onde é possível conferir tarefas na fila, pausar a fila, remover tarefas da fila e assim por diante. Consulte Gerenciar filas e tarefas na documentação do Cloud Tasks.

Observação: é possível pausar uma fila, mas se ela ficar parada por muito tempo, as tarefas vão apresentar erros de autenticação quando você retomar a fila. A autenticação da tarefa expira uma hora depois dela entrar na fila.
Aviso: não exclua a fila, a extensão precisa dela para funcionar. Se você excluir acidentalmente a fila, faça o seguinte:
1. Instale uma nova instância da extensão.
2. Só desinstale a instância antiga depois de instalar a nova.

Conferir secrets do Cloud Secret Manager criados por extensões

Abra a página Gerenciador de secrets do projeto no Console do Google Cloud.
Na lista de secrets, você vê aqueles que foram criados para Extensões do Firebase (junto de outros secrets criados para o projeto).

Os secrets criados pelas extensões têm nomes neste formato: ext-extension-instance-id-paramnName

Por exemplo: ext-awesome-task-simplifier-API_KEY

Os secrets são marcados com a chave firebase-extensions-managed. Não remova esse identificador, a menos que você queira impedir o Firebase de gerenciar o secret.

Verificar se uma extensão instalada está íntegra

É possível analisar todos os erros das funções (incluindo aquelas criadas por Extensões do Firebase) no console.

Na guia Integridade do painel do Functions, é possível conferir um aspecto geral dos erros e das informações de desempenho de todas as funções do projeto.
Para ver informações de uma extensão específica, use o filtro na parte de cima da página para selecionar uma função específica.

Verificar com que frequência uma extensão instalada está em execução

Na guia Painel do painel do Functions, localize a função específica da extensão do Firebase que você quer verificar.
Clique em (menu flutuante) no lado direito da entrada e selecione Estatísticas de uso detalhadas.
No Console do Google Cloud exibido, é possível detalhar várias invocações de uma função e até mesmo inspecionar o código-fonte.

Ver os registros de uma extensão

Se você estiver tentando depurar seu projeto ou enviar um relatório de bugs para o Firebase, vai ser importante poder ver os registros das funções em execução no projeto.

Na guia Registros do painel do Functions, use o filtro na parte superior da página para selecionar as funções criadas por sua extensão.

Atualizar uma instância de extensão instalada para a versão mais recente

Você pode atualizar uma instância instalada de uma extensão para a versão mais recente. Atualize uma instância instalada porque ela já está ativamente em execução ou configurada no fluxo de trabalho de teste, projeto ou app.

Quando você atualiza uma instância, todos os recursos e a lógica específicos da extensão são substituídos para usar o código-fonte e os arquivos da nova versão. O código da instância e a conta de serviço da extensão não serão alterados.

Durante o processo de atualização, você será notificado sobre qualquer alteração na nova versão e poderá especificar valores para novos parâmetros.

Para atualizar uma instância no manifesto de extensões para a versão mais recente, execute o comando de atualização:
```
firebase ext:update extensionInstanceId
```
Se você quiser atualizar para uma versão específica, informe isso:
```
firebase ext:update extensionInstanceId versionNumber
```
Em seguida, para implantar em um projeto do Firebase as extensões no manifesto, execute:
```
firebase deploy --only extensions --project=projectId-or-alias
```

Reconfigurar uma instância de extensão instalada

É possível alterar os valores dos parâmetros configurados pelo usuário para uma instância de extensão instalada. Esses novos valores vão ser usados em qualquer gatilho futuro da instância, mas todos os artefatos ou elementos estruturais anteriores criados pela extensão (como imagens armazenadas ou buckets de armazenamento) não serão alterados.

Para reconfigurar uma extensão de maneira interativa no manifesto, execute este comando de configuração:
```
firebase ext:configure extensionInstanceId
```
Observação: todas as solicitações usam como padrão os valores atuais da extensão instalada em vez dos valores padrão disponíveis durante a instalação inicial (aqueles listados como padrões no arquivo extension.yaml).
Em seguida, para implantar em um projeto do Firebase as extensões no manifesto, execute:
```
firebase deploy --only extensions --project=projectId-or-alias
```

Desinstalar uma instância de extensão instalada

É possível desinstalar a instância de uma extensão do projeto do Firebase. Essa ação exclui a conta de serviço e todos os recursos (como um conjunto de funções) que o Firebase criou especificamente para essa instância da extensão. No entanto, os itens a seguir não são excluídos:

Todos os artefatos criados pela extensão (como imagens armazenadas).
Todos os outros recursos no projeto, como uma instância de banco de dados ou um bucket do Cloud Storage. Mesmo que a extensão tenha interagido com esses outros recursos, eles não são específicos da extensão. Portanto, não serão excluídos se a extensão for desinstalada.

Veja como desinstalar uma extensão:

Para remover uma instância do manifesto de extensões, execute este comando de desinstalação:
```
firebase ext:uninstall extensionInstanceId
```
Em seguida, para implantar em um projeto do Firebase as alterações no manifesto, execute:
```
firebase deploy --only extensions --project=projectId-or-alias
```