Puedes instalar (y administrar) cualquiera de las extensiones oficiales de Firebase con Firebase console, Firebase CLI (una interfaz de línea de comandos) o un SDK generado automáticamente.
Asegúrate de revisar las diferencias en las acciones admitidas para cada método de instalación.
Para instalar o administrar extensiones, debes tener asignada una de estas funciones: Propietario o Editor, o bien Administrador de Firebase.
Si quieres instalar una extensión, tu proyecto debe tener el plan Blaze (pago por uso). Aunque la instalación es sin cargo, es posible que se te cobre por el uso de los servicios de Firebase o los servicios de Cloud como Cloud Secret Manager si tu uso sobrepasa el nivel gratuito de los servicios.
Antes de comenzar
Si aún no lo has hecho, agrega Firebase a tu proyecto y cámbialo al plan Blaze (pago por uso).
Paso 1: Revisa los detalles de la extensión
Este paso es opcional, pero muy recomendable.
Antes de instalar una Firebase Extension, te recomendamos revisar la información detallada sobre la extensión, incluido lo siguiente:
- El funcionamiento y los detalles de la extensión y las tareas previas a la instalación
- Información general de identificación y descripción
- Si se necesita una cuenta de facturación para las tareas de la extensión
- Los servicios de Google (API) y las funciones de acceso necesarios para el funcionamiento
- Los recursos creados para la extensión (como las funciones)
- Descripciones de los parámetros configurables por los usuarios
Para ver la información detallada de una extensión, debes hacer lo siguiente:
Explora las extensiones oficiales de Firebase en Extensions Hub.
Haz clic en la tarjeta de una extensión para realizar lo siguiente:
Mostrar la información detallada de la extensión
Busca el vínculo al código fuente de la extensión en el repositorio de código fuente de Firebase Extensions.
Puedes ver esta información detallada en
README, en el directorio de la extensión.
Paso 2: Instala una extensión
Durante el proceso de instalación, se te solicitará que revises las especificaciones básicas de la extensión (como las API habilitadas, los recursos creados, el acceso otorgado, etc.). Se te notificará sobre los requisitos de facturación y también se te solicitará que especifiques los valores para los parámetros configurables de la extensión.
Explora las extensiones oficiales de Firebase en Extensions Hub.
Haz clic en la tarjeta de una extensión y, luego, revisa la información detallada que aparece allí; esta puede incluir instrucciones de uso específicas y tareas previas a la instalación.
Haz clic en Instalar y sigue las instrucciones en pantalla para instalar la extensión.
Paso 3: Completa la configuración posterior a la instalación
Algunas extensiones tienen pasos opcionales u obligatorios que debes completar antes de usarlas. Encontrarás estas instrucciones en la página de detalles posteriores a la instalación de la extensión en el panel Extensions de Firebase console (el vínculo específico al panel se muestra en la terminal después de la instalación).
También puedes encontrar estas instrucciones en el archivo POSTINSTALL.md incluido en
el directorio del código fuente de la extensión.
Crea recursos de Firebase
Si configuraste la extensión para usar los recursos de Firebase (colecciones de Cloud Firestore, rutas de acceso de Realtime Database y buckets de Cloud Storage) que aún no existen, créalos antes de usar la extensión.
Crea controladores de eventos de Eventarc
Algunas extensiones se publican en Eventarc cuando ocurren eventos importantes durante la ejecución. Si una extensión publica eventos y habilitaste los eventos durante la instalación, puedes escribir funciones que reaccionen a ellos con tu propia lógica personalizada. Por ejemplo, esto puede ser útil para notificar a los usuarios cuando se completan tareas de larga duración o para procesar posteriormente el resultado de una función de extensión.
Consulta la documentación de la extensión para obtener una lista de los eventos que publica (si los hay). Por ejemplo, consulta los tipos de eventos de la extensión Run Payments with Stripe.
Luego, consulta Activadores de eventos personalizados y obtén información para escribir controladores de eventos de Eventarc.
Instala varias instancias de extensiones
Puedes instalar la misma extensión más de una vez en el mismo proyecto. Cada instancia instalada puede tener su propia configuración personalizada y sus propios recursos de extensión. Identificas cada instancia instalada y haces referencia a ellas mediante el ID de instancia, que es único dentro de tu proyecto.
Se te pedirá que confirmes o edites el ID de instancia de cada instancia adicional de la extensión que instales.
Próximos pasos
Consulta los detalles y la configuración de la extensión instalada en Firebase console.
Supervisa la actividad de la extensión que instalaste, incluidas las verificaciones de estado, uso y registros.
Usa Firebase console para administrar la extensión instalada. En el caso de las extensiones oficiales de Firebase, puedes volver a configurarlas o desinstalarlas, así como actualizarlas a la versión más reciente.
Como práctica recomendada para todos los proyectos, asegúrate de configurar alertas de presupuesto y de supervisar el panel Uso y facturación en Firebase console.