Você pode instalar (e gerenciar ) qualquer uma das extensões oficiais do Firebase usando o Firebase console ou a Firebase CLI (interface de linha de comando).
Certifique-se de revisar as diferenças nas ações compatíveis com Firebase CLI e Firebase console.
Para instalar ou gerenciar extensões, você deve receber uma destas funções: Proprietário ou Editor ou Administrador do Firebase .
Para instalar uma extensão, seu projeto deve estar no plano Blaze (pay as you go). Embora não haja cobrança pela instalação de uma extensão, você pode ser cobrado pelo uso dos serviços Firebase ou Cloud, como o Cloud Secret Manager , se o uso exceder o nível gratuito dos serviços.
Antes de você começar
Se ainda não o fez, adicione o Firebase ao seu projeto e atualize seu projeto Firebase para o plano Blaze (pagamento conforme o uso).
Etapa 1 : visualizar informações detalhadas sobre uma extensão
Esta etapa é opcional, mas fortemente recomendada.
Antes de instalar uma extensão do Firebase, recomendamos que você revise as informações detalhadas sobre a extensão, incluindo:
- Como a extensão funciona, quaisquer tarefas de pré-instalação e detalhes sobre a extensão
- Informações gerais de identificação e descrição
- Se as tarefas da extensão exigem uma conta de cobrança
- Serviços do Google (APIs) e funções de acesso necessárias para a operação
- Recursos criados para a extensão (como funções)
- Descrições de parâmetros configuráveis pelo usuário
Para ver as informações detalhadas de uma extensão:
Navegue pelas extensões oficiais do Firebase no Marketplace de extensões .
Clique no cartão de uma extensão para:
Exiba as informações detalhadas da extensão.
Encontre o link para o código-fonte da extensão no repositório de origem do Firebase Extensions .
No diretório de extensões da extensão , você pode visualizar essas informações detalhadas no
README
.
Passo 2 : Instale uma extensão
Durante o processo de instalação, você será solicitado a revisar as especificações básicas da extensão (como APIs ativadas, recursos criados, acesso concedido, etc.). Você será notificado sobre quaisquer requisitos de cobrança e também será solicitado a especificar valores para os parâmetros configuráveis da extensão.
Navegue pelas extensões oficiais do Firebase no Marketplace de extensões .
Clique no cartão de uma extensão e revise as informações detalhadas da extensão, que podem oferecer instruções de uso específicas e quaisquer tarefas de pré-instalação.
Clique em Instalar e siga as instruções na tela para instalar a extensão.
Etapa 3 : Conclua a configuração pós-instalação
Algumas extensões têm etapas obrigatórias ou opcionais a serem concluídas antes de usá-las. Encontre essas instruções na página de detalhes de pós-instalação da sua extensão no painel Extensões do console do Firebase (o link específico para o painel é exibido no terminal após a instalação).
Você também pode encontrar essas instruções no arquivo POSTINSTALL.md
incluído no diretório de origem da extensão .
Criar recursos do Firebase
Se você configurou a extensão para usar recursos do Firebase (coleções do Cloud Firestore, caminhos do Realtime Database, buckets do Cloud Storage) que ainda não existem, crie-os antes de usar a extensão.
Criar manipuladores de eventos Eventarc
Algumas extensões publicam no Eventarc quando eventos importantes acontecem durante a execução. Se uma extensão publicar eventos e você ativar eventos durante a instalação, poderá escrever funções que reajam a esses eventos com sua própria lógica personalizada. Isso pode ser útil, por exemplo, para notificar os usuários quando tarefas de execução longa forem concluídas ou para pós-processar a saída de uma função de extensão.
Consulte a documentação da extensão para obter uma lista de eventos (se houver) que ela publica.
Em seguida, consulte acionadores de eventos personalizados para obter informações sobre como escrever manipuladores de eventos Eventarc.
Instalar várias instâncias de extensão
Você pode instalar a mesma extensão mais de uma vez no mesmo projeto. Cada instância instalada pode ter sua própria configuração personalizada e seus próprios recursos de extensão. Você identifica e refere-se a cada instância instalada usando seu ID de instância , que é exclusivo em seu projeto. Você será solicitado a confirmar ou editar o ID da instância de cada instância adicional da extensão instalada.
Próximos passos
Visualize os detalhes e a configuração de sua extensão instalada no console do Firebase.
Monitore a atividade de sua extensão instalada, incluindo verificações de integridade, uso e logs.
Usando o Firebase console, gerencie sua extensão instalada. Para extensões oficiais do Firebase, você pode reconfigurar ou desinstalar sua extensão, bem como atualizar sua extensão para a versão mais recente.
Como prática recomendada para todos os projetos, configure alertas de orçamento para seu projeto e monitore seu painel de uso e cobrança no Firebase console.
Você pode instalar (e gerenciar ) qualquer uma das extensões oficiais do Firebase usando o Firebase console ou a Firebase CLI (interface de linha de comando).
Certifique-se de revisar as diferenças nas ações compatíveis com Firebase CLI e Firebase console.
Para instalar ou gerenciar extensões, você deve receber uma destas funções: Proprietário ou Editor ou Administrador do Firebase .
Para instalar uma extensão, seu projeto deve estar no plano Blaze (pay as you go). Embora não haja cobrança pela instalação de uma extensão, você pode ser cobrado pelo uso dos serviços Firebase ou Cloud, como o Cloud Secret Manager , se o uso exceder o nível gratuito dos serviços.
Antes de você começar
Se ainda não o fez, adicione o Firebase ao seu projeto e atualize seu projeto Firebase para o plano Blaze (pagamento conforme o uso).
Etapa 1 : visualizar informações detalhadas sobre uma extensão
Esta etapa é opcional, mas fortemente recomendada.
Antes de instalar uma extensão do Firebase, recomendamos que você revise as informações detalhadas sobre a extensão, incluindo:
- Como a extensão funciona, quaisquer tarefas de pré-instalação e detalhes sobre a extensão
- Informações gerais de identificação e descrição
- Se as tarefas da extensão exigem uma conta de cobrança
- Serviços do Google (APIs) e funções de acesso necessárias para a operação
- Recursos criados para a extensão (como funções)
- Descrições de parâmetros configuráveis pelo usuário
Para ver as informações detalhadas de uma extensão:
Navegue pelas extensões oficiais do Firebase no Marketplace de extensões .
Clique no cartão de uma extensão para:
Exiba as informações detalhadas da extensão.
Encontre o link para o código-fonte da extensão no repositório de origem do Firebase Extensions .
No diretório de extensões da extensão , você pode visualizar essas informações detalhadas no
README
.
Passo 2 : Instale uma extensão
Durante o processo de instalação, você será solicitado a revisar as especificações básicas da extensão (como APIs ativadas, recursos criados, acesso concedido, etc.). Você será notificado sobre quaisquer requisitos de cobrança e também será solicitado a especificar valores para os parâmetros configuráveis da extensão.
Navegue pelas extensões oficiais do Firebase no Marketplace de extensões .
Clique no cartão de uma extensão e revise as informações detalhadas da extensão, que podem oferecer instruções de uso específicas e quaisquer tarefas de pré-instalação.
Clique em Instalar e siga as instruções na tela para instalar a extensão.
Etapa 3 : Conclua a configuração pós-instalação
Algumas extensões têm etapas obrigatórias ou opcionais a serem concluídas antes de usá-las. Encontre essas instruções na página de detalhes de pós-instalação da sua extensão no painel Extensões do console do Firebase (o link específico para o painel é exibido no terminal após a instalação).
Você também pode encontrar essas instruções no arquivo POSTINSTALL.md
incluído no diretório de origem da extensão .
Criar recursos do Firebase
Se você configurou a extensão para usar recursos do Firebase (coleções do Cloud Firestore, caminhos do Realtime Database, buckets do Cloud Storage) que ainda não existem, crie-os antes de usar a extensão.
Criar manipuladores de eventos Eventarc
Algumas extensões publicam no Eventarc quando eventos importantes acontecem durante a execução. Se uma extensão publicar eventos e você ativar eventos durante a instalação, poderá escrever funções que reajam a esses eventos com sua própria lógica personalizada. Isso pode ser útil, por exemplo, para notificar os usuários quando tarefas de execução longa forem concluídas ou para pós-processar a saída de uma função de extensão.
Consulte a documentação da extensão para obter uma lista de eventos (se houver) que ela publica.
Em seguida, consulte acionadores de eventos personalizados para obter informações sobre como escrever manipuladores de eventos Eventarc.
Instalar várias instâncias de extensão
Você pode instalar a mesma extensão mais de uma vez no mesmo projeto. Cada instância instalada pode ter sua própria configuração personalizada e seus próprios recursos de extensão. Você identifica e refere-se a cada instância instalada usando seu ID de instância , que é exclusivo em seu projeto. Você será solicitado a confirmar ou editar o ID da instância de cada instância adicional da extensão instalada.
Próximos passos
Visualize os detalhes e a configuração de sua extensão instalada no console do Firebase.
Monitore a atividade de sua extensão instalada, incluindo verificações de integridade, uso e logs.
Usando o Firebase console, gerencie sua extensão instalada. Para extensões oficiais do Firebase, você pode reconfigurar ou desinstalar sua extensão, bem como atualizar sua extensão para a versão mais recente.
Como prática recomendada para todos os projetos, configure alertas de orçamento para seu projeto e monitore seu painel de uso e cobrança no Firebase console.