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

Ver detalhes e a configuração de uma instância de extensão instalada

  1. Acesse o painel do Firebase Extensions no console do Firebase.

  2. No card da instância de extensão instalada, clique em Gerenciar.

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

  1. Acesse o painel do Functions do Console do Firebase.

  2. Na guia Painel, é possível ver as funções das Firebase Extensions (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 Cloud Scheduler criados por extensões

  1. Abra a página Cloud Scheduler do seu projeto. no console Google Cloud.

  2. Na lista de jobs, é possível visualizar os jobs Cloud Scheduler de Firebase Extensions (junto a outras tarefas que você criou para seu 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:

  1. Na seção Extensões do Console do Firebase, abra a página de detalhes da instância da extensão.

  2. 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.

  3. 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.x Consulte Gerenciar filas e tarefas na documentação do Cloud Tasks.

Visualizar secrets do Cloud Secret Manager criados por extensões

  1. Abra a página Secret Manager do projeto no console do Google Cloud.

  2. Na lista de secrets, você vê aqueles que foram criados para Firebase Extensions (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

Você pode analisar todos os erros das funções (incluindo os criados pelo Firebase Extensions) no console.

  1. 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.

  2. 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

  1. Na guia Painel do painel do Functions, localize a função específica da extensão do Firebase Extension que você quer verificar.

  2. Clique em (menu flutuante) no lado direito da entrada e selecione Estatísticas de uso detalhadas.

  3. 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.

  1. Acesse o painel do Firebase Extensions e, em seguida, no no card da instância de extensão, clique em Gerenciar.

  2. No canto superior direito, clique em Atualizar extensão.

    Se a extensão não tiver uma nova versão disponível, a página de detalhes não terá um botão de atualização.

  3. Verifique o que a atualização traz de novo e configure a extensão (se necessário).

  4. Clique em Atualizar extensão.

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.

  1. Acesse o painel do Firebase Extensions e, em seguida, no card da instância de extensão, clique em Gerenciar.

  2. No canto superior direito, clique em Reconfigurar extensão.

  3. Siga as instruções na tela para reconfigurar os valores dos parâmetros da extensão.

  4. Clique em Salvar.

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:

  1. Acesse o painel do Firebase Extensions e, em seguida, no card da instância de extensão, clique em Gerenciar.

  2. Na parte inferior da tela, clique em Desinstalar extensão.

  3. Analise o que será excluído e clique em Desinstalar extensão para confirmar a exclusão.