Introdução ao Cloud Functions para Firebase (2nd gen)

Nesta página, descrevemos as etapas para configurar o Cloud Functions para Firebase (2nd gen). Se você ainda não conhece o fluxo geral para configurar o Cloud Functions para Firebase, consulte a introdução da 1ª geração e o guia para iniciantes.

Usar um projeto no plano Blaze

Como o Cloud Functions para Firebase (2nd gen) é executado no Cloud Run, é necessário fornecer uma forma de faturamento para começar. O Cloud Run tem um nível sem custos de 2 milhões de solicitações por mês. Veja mais detalhes nos preços do Cloud Run.

Instale o SDK

A biblioteca do Cloud Functions para Firebase (2nd gen) está disponível no npm. Todo o trabalho feito na biblioteca também está disponível publicamente no GitHub.

Para ativar o Cloud Functions para Firebase (2nd gen), execute os seguintes comandos na CLI do Firebase:

# Install the latest version of the Firebase CLI
npm install -g firebase-tools

# Initialize a project, if necessary
firebase init functions

Importe o SDK do firebase-functions

O SDK do Cloud Functions para Firebase (2nd gen) está na exportação do pacote v2. É possível importar subpacotes (recomendado) ou importar um monolítico em firebase-functions/v2, conforme mostrado:

// import from a specific subpackage
const {onRequest} = require('firebase-functions/v2/https');

// import the entire v2 monolith
const functionsV2 = require('firebase-functions/v2');

Importar o SDK de 1ª geração (opcional)

O SDK original do Cloud Functions para Firebase agora será conhecido como 1ª geração. Ainda é possível importar esse SDK como antes. Ou, para melhorar a legibilidade, agora você também pode importar esse SDK do namespace v1.

const functions = require('firebase-functions/v1');
// alternatively:
// const functions = require('firebase-functions');

As funções gravadas com o SDK de 1ª geração serão implantadas no Cloud Functions (1st gen). Para facilitar a migração para a 2ª geração, o Cloud Functions permite que uma única base de código contenha as funções de 1ª e 2ª geração.

Próximas etapas

Consulte os guias e o exemplo de código de cada tipo de gatilho suportado, incluindo os novos tipos, Gatilhos de alertas do Firebase e gatilhos de evento personalizados para Extensões do Firebase, assim como funções da fila de tarefas. Consulte também as orientações fundamentais sobre como: