Participe do Firebase Summit on-line e presencialmente em 18 de outubro de 2022. Veja como usar o Firebase pode ajudar você a acelerar o desenvolvimento de apps, a lançar seu aplicativo com confiança e a fazer o escalonamento com facilidade. Inscreva-se agora

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, é necessário atribuir uma destas funções: 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

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

  2. Na guia Painel, é possível ver as funções de Extensões do Firebase (junto com 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

Visualizar jobs do Cloud Scheduler criados por extensões

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

  2. Na lista de jobs, é possível visualizar os jobs do Cloud Scheduler das Extensões do Firebase (junto a 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

Visualizar secrets do Cloud Secret Manager criados por extensões

  1. Abra a página Gerenciador de secrets do projeto no Console do Google Cloud.

  2. Na lista de secrets, você vê aqueles que foram criados para Extensões do Firebase (junto com 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.

  1. Na guia Integridade do painel do Functions, é possível ter uma visão 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 superior 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 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, poder ver os registros das funções em execução no projeto é algo útil.

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ê vai receber notificações sobre qualquer alteração na nova versão e poderá especificar valores para novos parâmetros.

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

  1. Para reconfigurar uma extensão de maneira interativa no manifesto, execute este comando de configuração:

    firebase ext:configure extensionInstanceId
  2. 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:

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

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

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