Gerenciar extensões do Firebase instaladas

Para instalar ou gerenciar extensões, você deve receber uma destas funções: Proprietário ou Editor ou Administrador do Firebase .

Listar as instâncias de extensão instaladas de um projeto

Você pode listar todas as instâncias das extensões instaladas.

Execute o comando da lista de extensões:

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

Monitorar uma instância de extensão instalada

No Console do Firebase, você pode 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 boa prática em geral, mas os alertas podem ser especialmente importantes quando você confia no código de outra parte para execução em seu projeto.

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

Ver funções criadas por extensões

  1. Vá para o painel de funções do console do Firebase.

  2. Na guia Painel , você pode visualizar as funções das Extensões do Firebase (juntamente com quaisquer outras funções que você implantou para seu projeto).

    Funções criadas por extensões possuem nomes no formato: ext- extension-instance-id - functionName

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

Ver jobs do Cloud Scheduler criados por extensões

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

  2. Na lista Jobs, você pode visualizar os jobs do Cloud Scheduler nas extensões do Firebase (juntamente com quaisquer outros jobs que você criou para seu projeto).

    Jobs criados por extensões têm nomes no formato: firebase-ext- extension-instance-id - functionName

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

Visualize e gerencie Cloud Tasks enfileiradas por extensões

Algumas extensões usam o Cloud Tasks para executar tarefas de execução mais longa: mais comumente, tarefas de processamento executadas em vários pontos do ciclo de vida de uma extensão: instalação, reconfiguração e após 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 da fila uma tarefa que ainda não foi iniciada), siga estas etapas:

  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 a extensão usar Cloud Tasks, haverá uma seção de filas do Cloud Task com uma ou mais entradas.

  3. Clique em Visualizar fila para a fila que você deseja gerenciar. Isso abrirá a página Detalhes da fila no console do Google Cloud, onde você pode visualizar tarefas enfileiradas, pausar a fila, remover tarefas da fila e assim por diante. Consulte Gerenciar filas e tarefas na documentação do Cloud Tasks.

Ver segredos do Cloud Secret Manager criados por extensões

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

  2. Na lista Segredos, você pode visualizar os segredos criados para extensões do Firebase (juntamente com quaisquer outros segredos criados para o seu projeto).

    Os segredos criados por extensões têm nomes no formato: ext- extension-instance-id - paramnName

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

    Os segredos são rotulados com a chave firebase-extensions-managed . Não remova esse rótulo, a menos que queira impedir que o Firebase gerencie o segredo.

Verifique se uma extensão instalada está íntegra

Você pode revisar todos os erros das funções (incluindo aqueles criados pelas extensões do Firebase) no console.

  1. Na guia Integridade do painel Funções , você pode visualizar uma visão geral dos erros e informações de desempenho de todas as funções do seu projeto.

  2. Para visualizar informações de uma extensão específica, use o filtro na parte superior da página para selecionar uma função específica.

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

  1. Na guia Painel do painel Funções , localize a função específica da extensão do Firebase que você deseja verificar.

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

  3. No console do Google Cloud exibido, você pode detalhar várias invocações de uma função e até mesmo inspecionar seu código-fonte.

Ver os registros de uma extensão

Se você estiver tentando depurar seu projeto ou enviar um relatório de bug ao Firebase, será útil visualizar os registros das funções em execução no seu projeto.

Na guia Logs do painel Funções , use o filtro na parte superior da página para selecionar as funções criadas pela 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 sua versão mais recente. Talvez você queira atualizar uma instância instalada porque ela já está em execução ou configurada ativamente em seu teste, projeto ou fluxo de trabalho do aplicativo.

Quando você atualiza uma instância, todos os recursos e lógica específicos da extensão da instância são substituídos para usar o código-fonte e os arquivos da nova versão. O ID 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 quaisquer alterações na nova versão e poderá especificar valores para quaisquer novos parâmetros.

  1. Para atualizar uma instância de extensão em seu manifesto de extensões para a versão mais recente, execute o comando de atualização de extensão:

    firebase ext:update extensionInstanceId

    Para atualizar para uma versão específica, forneça a versão para a qual deseja atualizar:

    firebase ext:update extensionInstanceId versionNumber
  2. Em seguida, para implantar as extensões do seu manifesto em um projeto do Firebase, execute:

    firebase deploy --only extensions --project=projectId-or-alias

Reconfigurar uma instância de extensão instalada

Você pode alterar os valores dos parâmetros configurados pelo usuário para uma instância de extensão instalada. Esses novos valores serão usados ​​em quaisquer acionadores futuros da instância, mas todos os artefatos ou elementos estruturais anteriores criados pela extensão (como imagens armazenadas ou buckets de armazenamento existentes) não serão alterados.

  1. Para reconfigurar interativamente uma extensão em seu manifesto de extensões , execute o comando extension configure:

    firebase ext:configure extensionInstanceId
  2. Em seguida, para implantar as extensões do seu manifesto em um projeto do Firebase, execute:

    firebase deploy --only extensions --project=projectId-or-alias

Desinstalar uma instância de extensão

Você pode desinstalar uma instância de uma extensão do seu projeto do Firebase. Esta 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, o seguinte não é excluído:

  • Quaisquer artefatos criados pela extensão (como imagens armazenadas).

  • Quaisquer outros recursos no seu projeto, como uma instância de banco de dados ou um intervalo do Cloud Storage. Mesmo que a extensão tenha interagido com esses outros recursos, eles não são específicos da extensão e, portanto, não serão excluídos se a extensão for desinstalada.

Veja como desinstalar uma extensão:

  1. Para remover uma instância de extensão do seu manifesto de extensões , execute o comando de desinstalação da extensão:

    firebase ext:uninstall extensionInstanceId
  2. Em seguida, para implantar as alterações do seu manifesto em um projeto do Firebase, execute:

    firebase deploy --only extensions --project=projectId-or-alias