Administra las Extensiones de Firebase instaladas

Para instalar o administrar extensiones, debes ser propietario del proyecto.

Enumera las extensiones instaladas de un proyecto

Puedes generar listas de todas las extensiones instaladas en un proyecto de Firebase y consultar el ID de instancia de cada extensión.

Para ello, ejecuta el comando extensions-list:

firebase ext:list --project=projectId-or-alias

Supervisa una extensión instalada

En Firebase console, puedes supervisar la actividad de una extensión instalada, incluidos el estado, el uso y los registros.

Configura alertas de presupuesto

En general, se recomienda configurar alertas de presupuesto, pero estas pueden ser especialmente importantes cuando permites que se ejecute el código de un tercero en tu proyecto.

Asegúrate de configurar alertas de facturación para tu proyecto de Firebase.

Consulta las funciones creadas por las extensiones

  1. Ve al panel Funciones de Firebase console.

  2. Puedes consultar las funciones de Extensiones de Firebase en la pestaña Panel (junto con cualquier otra función que hayas implementado para el proyecto).

    Las funciones creadas por extensiones tienen nombres en el formato ext-extension-instance-id-functionName.

    Por ejemplo: ext-awesome-task-simplifier-onUserCreate

Comprueba si una extensión instalada está en buen estado

Puedes revisar todos los errores de las funciones (incluidas las que crea Extensiones de Firebase) en la consola.

  1. En la pestaña Estado del panel Funciones, puedes ver una descripción general de los errores y la información de rendimiento de todas las funciones de tu proyecto.

  2. Para ver la información de una extensión específica, utiliza el filtro en la parte superior de la página a fin de seleccionar una función específica.

Comprueba la frecuencia con la que se ejecuta una extensión instalada

  1. En la pestaña Panel de la sección Funciones, busca la función específica de la extensión de Firebase que deseas verificar.

  2. Haz clic en (el menú ampliado) en el extremo derecho de la entrada y, luego, selecciona Estadísticas de uso detalladas.

  3. En la consola de Google Cloud Platform (GCP) que se muestra, puedes desglosar varias invocaciones de una función y, también, inspeccionar su código fuente.

Consulta los registros de una extensión

Si intentas depurar el proyecto o enviar un informe de errores a Firebase, es útil ver los registros de las funciones que se ejecutan en tu proyecto.

En la pestaña Registros del panel Funciones, usa el filtro en la parte superior de la página para seleccionar las funciones que creó tu extensión.

Actualiza una extensión instalada a la versión más reciente

Puedes actualizar una instancia instalada de una extensión a su versión más reciente. Es posible que quieras actualizar una instancia instalada porque ya se está ejecutando de forma activa o porque está configurada en el flujo de trabajo de prueba, o en los flujos de trabajo del proyecto o la app.

Cuando actualizas una instancia, todos sus recursos y la lógica específicos de la extensión se reemplazan para usar el código fuente y los archivos de la versión nueva. El ID de instancia y la cuenta de servicio de la extensión no cambiarán.

Durante el proceso de actualización, se te notificará sobre cualquier cambio que contenga la versión nueva y podrás especificar valores para cualquier parámetro nuevo.

  1. Ejecuta el comando extensions-list para obtener el ID de instancia de la extensión:

    firebase ext:list --project=projectId-or-alias
  2. Ejecuta el comando extension-update:

    firebase ext:update extensionInstanceId --project=projectId-or-alias

Vuelve a configurar una extensión instalada

Puedes cambiar los valores de los parámetros que configuró el usuario para una extensión instalada. Estos valores nuevos se usarán en cualquier activador futuro de la extensión, pero no se modificarán los artefactos o elementos estructurales anteriores que haya creado la extensión (como imágenes almacenadas o depósitos de almacenamiento existentes).

  1. Ejecuta el comando extensions-list para obtener el ID de instancia de la extensión:

    firebase ext:list --project=projectId-or-alias
  2. Ejecuta el comando extension-configure:

    firebase ext:configure extensionInstanceId --project=projectId-or-alias --params=path/to/envFile

    En este comando, --params es una marca opcional para proporcionar un archivo que define los valores de los parámetros configurables por el usuario, además te permite omitir los mensajes de la terminal interactiva correspondientes a esos valores. Define tus valores en un archivo .env que siga la sintaxis de dotenv.

  3. Si se te solicita (o no proporcionaste un archivo .env), ingresa los valores de configuración para personalizar la extensión de tu proyecto.

Desinstala una extensión

Puedes desinstalar una extensión desde tu proyecto de Firebase. Esta acción borra la cuenta de servicio y todos los recursos (como los conjuntos de funciones) que Firebase creó específicamente para esa instancia de la extensión. Sin embargo, no se borran los siguientes elementos:

  • Cualquier artefacto creado por la extensión (como imágenes almacenadas)

  • Cualquier otro recurso del proyecto, como una instancia de base de datos o un depósito de Storage. Incluso si la extensión interactuó con estos otros recursos, no son específicos de la extensión, por lo que no se borran si esta se desinstala.

A continuación, te indicamos cómo desinstalar una extensión:

  1. Ejecuta el comando extensions-list para obtener el ID de instancia de la extensión:

    firebase ext:list --project=projectId-or-alias
  2. Ejecuta el comando extension-uninstall:

    firebase ext:uninstall extensionInstanceId --project=projectId-or-alias