Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Gerenciar extensões do Firebase instaladas

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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 extensions-list:

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

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 ser executado em seu 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 de funções do console do Firebase.

  2. Na guia Dashboard , você pode visualizar as funções do Firebase Extensions (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 trabalhos do Cloud Scheduler criados por extensões

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

  2. Na lista de trabalhos, você pode visualizar os trabalhos do Cloud Scheduler das Extensões do Firebase (juntamente com quaisquer outros trabalhos que você criou para o seu projeto).

    Os trabalhos 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 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 atualizações posteriores.

Normalmente, essas tarefas são executadas e concluídas automaticamente, sem sua intervenção. No entanto, se você precisar gerenciar manualmente as tarefas enfileiradas 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 Firebase console, 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 de Cloud Task com uma ou mais entradas.

  3. Clique em Exibir fila para a fila que você deseja gerenciar. Isso abrirá a página Detalhes da fila no Console do Google Cloud, na qual você pode visualizar as 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.

Veja os 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 Secrets, você pode ver os segredos criados para Firebase Extensions (juntamente com quaisquer outros segredos que você criou para 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 de funções (incluindo aqueles criados por Firebase Extensions) no console.

  1. Na guia Integridade do painel de 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 as 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 Dashboard do seu painel de funções , localize a função específica para a extensão do Firebase que você deseja verificar.

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

Exibir os logs de uma extensão

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

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

Atualize 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 lançada mais recente. Talvez você queira atualizar uma instância instalada porque a instância 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 para a 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 extension update:

    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 em seu manifesto em um projeto 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 qualquer acionador futuro da instância, mas todos os artefatos anteriores ou elementos estruturais criados pela extensão (como imagens armazenadas ou compartimentos 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 em seu manifesto em um projeto 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 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 seguintes não são excluídos:

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

  • Quaisquer outros recursos em 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 , 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 em seu manifesto em um projeto do Firebase, execute:

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