Instalar una extensión de Firebase

Puede instalar (y administrar ) cualquiera de las extensiones oficiales de Firebase utilizando Firebase console o Firebase CLI (interfaz de línea de comandos).

Asegúrese de revisar las diferencias en las acciones admitidas para Firebase CLI y Firebase console.


Para instalar o administrar extensiones, se le debe asignar uno de estos roles: Propietario o Editor o Administrador de Firebase .

Para instalar una extensión, su proyecto debe estar en el plan Blaze (pago por uso). Aunque no hay ningún cargo por instalar una extensión, es posible que se le cobre por el uso de los servicios de Firebase o de los servicios en la nube, como Cloud Secret Manager , si su uso excede el nivel gratuito de los servicios.

Antes de que empieces

  1. Si aún no lo has hecho, agrega Firebase a tu proyecto .

  2. Si aún no lo ha hecho, actualice su proyecto al plan Blaze (pago por uso).

  3. Instale o actualice a la última versión de Firebase CLI.

  4. Tome nota del ID de su proyecto de Firebase o del alias del proyecto configurado previamente.

Paso 1 : Ver información detallada sobre una extensión

Este paso es opcional, pero muy recomendable.

Antes de instalar una extensión de Firebase, le recomendamos que revise la información detallada sobre la extensión, que incluye:

  • Cómo funciona la extensión, tareas previas a la instalación y detalles sobre la extensión
  • Información general de identificación y descripción.
  • Si las tareas de la extensión requieren una cuenta de facturación
  • Servicios de Google (API) y roles de acceso necesarios para el funcionamiento
  • Recursos creados para la extensión (como funciones)
  • Descripciones de parámetros configurables por el usuario

Para ver la información detallada de una extensión:

  1. Asegúrese de haber configurado su entorno y seleccionado una extensión .

  2. Ejecute el comando extensión-info desde cualquier lugar de su computadora:

    firebase ext:info publisher-id/extension-id

    Los argumentos publisher-id y extension-id son obligatorios y se pueden encontrar en la página de detalles de preinstalación de la extensión .

Paso 2 : instalar una extensión

Durante el proceso de instalación, se le pedirá que revise las especificaciones básicas de la extensión (como las API habilitadas, los recursos creados, el acceso otorgado, etc.). Se le notificará sobre cualquier requisito de facturación y también se le pedirá que especifique valores para los parámetros configurables de la extensión.

  1. Asegúrese de haber configurado su entorno y seleccionado una extensión .

  2. Desde su directorio local de Firebase, ejecute el comando de instalación de extensión. Si se le solicita, ingrese valores de parámetros para personalizar la instancia de extensión.

    firebase ext:install publisher-id/extension-id --project=projectId-or-alias

    Los argumentos publisher-id y extension-id son obligatorios y se pueden encontrar en la página de detalles de preinstalación de la extensión .

    La ejecución de este comando agrega una instancia de extensión a su manifiesto de extensiones .

  3. Luego, para implementar las extensiones en su manifiesto en un proyecto de Firebase, ejecute:

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

Paso 3 : completar la configuración posterior a la instalación

Algunas extensiones tienen pasos obligatorios u opcionales que debes completar antes de usarlas. Encuentre estas instrucciones en la página de detalles posteriores a la instalación de su extensión en el panel de Extensiones de Firebase console (el enlace 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 fuente de la extensión .

Crear recursos de Firebase

Si configuró la extensión para usar recursos de Firebase (colecciones de Cloud Firestore, rutas de Realtime Database, depósitos de Cloud Storage) que aún no existen, créelos antes de usar la extensión.

Crear controladores de eventos Eventarc

Algunas extensiones publican en Eventarc cuando ocurren eventos importantes durante la ejecución. Si una extensión publica eventos y usted habilitó eventos durante la instalación, puede escribir funciones que reaccionen a estos eventos con su propia lógica personalizada. Esto puede resultar útil, por ejemplo, para notificar a los usuarios cuando se completan tareas de larga duración o para posprocesar el resultado de una función de extensión.

Consulte la documentación de la extensión para obtener una lista de eventos (si los hay) que publica. Por ejemplo, consulte los tipos de eventos para la extensión Ejecutar pagos con Stripe .

Luego, consulte Activadores de eventos personalizados para obtener información sobre cómo escribir controladores de eventos de Eventarc.

Instalar múltiples instancias de extensión

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. Usted identifica y hace referencia a cada instancia instalada utilizando su ID de instancia , que es único dentro de su proyecto. Se le pedirá que confirme o edite el ID de instancia de cada instancia adicional de la extensión que instale.

Próximos pasos

  • Vea los detalles y la configuración de su extensión instalada en Firebase console.

  • Supervise la actividad de su extensión instalada, incluidas comprobaciones de su estado, uso y registros.

  • Con Firebase CLI, administre su extensión instalada. Puede volver a configurar o desinstalar su extensión, así como actualizarla a la última versión.

  • Usando la consola Firebase, administre su extensión instalada. Para las extensiones oficiales de Firebase, puede reconfigurar o desinstalar su extensión, así como actualizarla a la última versión.

  • Como práctica recomendada para todos los proyectos, asegúrese de configurar alertas de presupuesto para su proyecto y monitorear su panel de Uso y facturación en Firebase console.