Primeros pasos con Cloud Functions para Firebase (2ª gen.)

En esta página, se describen los pasos que debes seguir a fin de configurar Cloud Functions para Firebase (2ª gen.). Si aún no te has familiarizado con el flujo general a fin de configurar Cloud Functions para Firebase, consulta la introducción y la guía de introducción de la 1ª gen.

Usa un proyecto en el plan Blaze

Debido a que Cloud Functions para Firebase (2ª gen.) se ejecuta en Cloud Run, deberás proporcionar un instrumento de facturación para comenzar. Cloud Run tiene un nivel gratuito de 2 millones de solicitudes por mes. Revisa más detalles sobre los precios de Cloud Run.

Instala el SDK

La biblioteca de Cloud Functions para Firebase (2ª gen.) está disponible en npm. Todo el trabajo que se realiza en la biblioteca también es público en GitHub.

Si quieres habilitar Cloud Functions para Firebase (2ª gen.) ejecuta los siguientes comandos en Firebase CLI:

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

# Initialize a project, if necessary
firebase init functions

Importa el SDK de firebase-functions

El SDK de Cloud Functions para Firebase (2ª gen.) se encuentra en la exportación del paquete v2. Puedes importar subpaquetes (recomendado) o una aplicación monolítica en firebase-functions/v2, como se muestra a continuación:

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

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

Importa el SDK de 1ª gen. (opcional)

El SDK original de Cloud Functions para Firebase ahora se conocerá como 1ª gen., pero aún puedes importarlo como de costumbre. O bien, para mejorar la legibilidad, ahora también puedes importar el SDK de 1ª gen. desde el espacio de nombres v1.

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

Las funciones escritas con el SDK de 1ª gen. se implementarán en Cloud Functions de 1ª gen.. Para facilitar la migración a la 2ª gen., Cloud Functions permite que una sola base de código contenga funciones de 1ª y 2ª gen.

Próximos pasos

Consulta las guías y el código de muestra para cada tipo de activador compatible, incluidos los nuevos, los activadores de Alertas de Firebase, los activadores de eventos personalizados para las extensiones de Firebase y las funciones de lista de tareas en cola. También, revisa la orientación fundamental para realizar las siguientes acciones: