Administra las Extensiones de Firebase instaladas

Para instalar o administrar extensiones, debes tener asignada una de estas funciones: Propietario o Editor, o bien Administrador de Firebase.


Genera una lista de las instancias de extensión instaladas de un proyecto

Puedes enumerar todas las instancias de las extensiones que instalaste.

Para ello, ejecuta el comando extensions-list:

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

Consulta los detalles y la configuración de una instancia de extensión instalada

  1. Ve a tu panel de Firebase Extensions en la consola de Firebase.

  2. En la tarjeta de la instancia de extensión instalada, haz clic en Administrar.

Supervisa una instancia de 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 presupuesto para tu proyecto de Firebase.

Consulta las funciones creadas por las extensiones

  1. Ve al panel Functions de Firebase console.

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

    Los nombres de las funciones que crearon las extensiones tienen el siguiente formato: ext-extension-instance-id-functionName

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

Cómo ver los trabajos de Cloud Scheduler creados por extensiones

  1. Abre la página Cloud Scheduler de tu proyecto en la consola de Google Cloud.

  2. En la Lista de trabajos, puedes ver los trabajos de Cloud Scheduler provenientes de Firebase Extensions (junto con cualquier otro trabajo que hayas creado en tu proyecto).

    Los nombres de los trabajos que crearon las extensiones tienen el siguiente formato: firebase-ext-extension-instance-id-functionName

    Por ejemplo: firebase-ext-awesome-task-simplifier-doTask.

Consulta y administra las tareas de Cloud Tasks puestas en cola por las extensiones

Algunas extensiones usan Cloud Tasks para ejecutar tareas con un tiempo de ejecución más prolongado, que por lo general son tareas de procesamiento que se ejecutan en varios puntos del ciclo de vida de una extensión, como la instalación, la reconfiguración y después de las actualizaciones.

Estas tareas suelen ejecutarse y completarse automáticamente sin que tengas que intervenir. Sin embargo, si necesitas administrar manualmente las tareas en cola de una extensión, como pausar la cola o quitar de esta una tarea que aún no comienza, sigue estos pasos:

  1. En la sección Extensiones de Firebase console, abre la página de detalles de la instancia de la extensión.

  2. En la página de detalles, abre la sección API y recursos. Si la extensión usa Cloud Tasks, habrá una sección de Lista de tareas en cola de Cloud con una o más entradas.

  3. Haz clic en Ver cola en la cola que quieras administrar. Esta acción abrirá la página de detalles de cola en la consola de Google Cloud, donde podrás ver las tareas en cola, pausar la cola, quitar tareas de la cola, etcétera. Consulta Administrar colas y tareas en la documentación de Cloud Tasks.

Consulta los Secrets de Cloud Secret Manager que crearon las extensiones

  1. Abre la página Secret Manager de tu proyecto. en la consola de Google Cloud.

  2. En la lista Secrets, puedes ver los Secrets creados para Firebase Extensions (junto con cualquier otro Secret que hayas creado en tu proyecto).

    Los Secrets que crearon las extensiones tienen el siguiente formato: ext-extension-instance-id-paramnName

    Por ejemplo: ext-awesome-task-simplifier-API_KEY.

    Los Secrets se etiquetan con la clave firebase-extensions-managed. No quites esta etiqueta, a menos que quieras que Firebase deje de administrar el Secret.

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

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

  1. En la pestaña Estado del panel Functions, 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 del panel Functions, busca la función específica de la extensión de Firebase Extension 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, puedes desglosar varias invocaciones de una función y hasta 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 Functions, usa el filtro en la parte superior de la página para seleccionar las funciones que creó tu extensión.

Actualiza una instancia de 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. Recomendamos que actualices las instancias instaladas si ya se están ejecutando de forma activa o si están configuradas 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. No cambiarán el ID de instancia ni la cuenta de servicio de la extensió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. Ve al panel de Firebase Extensions y, luego, en la tarjeta de la instancia de extensión instalada, haz clic en Administrar.

  2. En la esquina superior derecha, haz clic en Actualizar extensión.

    Si la extensión no tiene una versión nueva disponible, la página de detalles no tendrá un botón de actualización.

  3. Revisa las novedades de la actualización y configura la extensión (si es necesario).

  4. Haz clic en Actualizar extensión.

Vuelve a configurar una instancia de extensión instalada

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

  1. Ve al panel de Firebase Extensions y, luego, en la tarjeta de la instancia de extensión instalada, haz clic en Administrar.

  2. En la esquina superior derecha, haz clic en Volver a configurar la extensión.

  3. Sigue las instrucciones en pantalla para volver a configurar los valores de los parámetros de la extensión.

  4. Haz clic en Guardar.

Desinstala una instancia de extensión

Puedes desinstalar una instancia de 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 bucket de Cloud 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. Ve al panel de Firebase Extensions y, luego, en la tarjeta de la instancia de extensión instalada, haz clic en Administrar.

  2. En la parte inferior de la pantalla, haz clic en Desinstalar extensión.

  3. Revisa el contenido que se borrará y, luego, haz clic en Desinstalar extensión para confirmar la eliminación.