Administrar las extensiones de Firebase instaladas

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

Ver detalles y configuración de una instancia de extensión instalada

  1. Vaya a su panel de Firebase Extensions en Firebase console.

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

Monitorear una instancia de extensión instalada

En Firebase console, puedes monitorear la actividad de una extensión instalada, incluidas comprobaciones de su estado, uso y registros.

Establecer alertas de presupuesto

Configurar alertas de presupuesto es una buena práctica en general, pero las alertas pueden ser especialmente importantes cuando confías en el código de otra parte para ejecutarse en tu proyecto.

Asegúrese de configurar alertas de presupuesto para su proyecto de Firebase.

Ver funciones creadas por extensiones

  1. Vaya al panel de Funciones de Firebase console.

  2. En la pestaña Panel , puede ver las funciones de Firebase Extensions (junto con cualquier otra función que haya implementado para su proyecto).

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

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

Ver trabajos de Cloud Scheduler creados por extensiones

  1. Abra la página Cloud Scheduler de su proyecto en la consola de Google Cloud.

  2. En la lista de Trabajos, puede ver los trabajos de Cloud Scheduler desde Firebase Extensions (junto con cualquier otro trabajo que haya creado para su proyecto).

    Los trabajos creados por extensiones tienen nombres en el formato: firebase-ext- extension-instance-id - functionName

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

Ver y administrar Cloud Tasks en cola por extensiones

Algunas extensiones usan Cloud Tasks para ejecutar tareas de mayor duración: más comúnmente, tareas de procesamiento que se ejecutan en varios puntos del ciclo de vida de una extensión: instalación, reconfiguración y después de las actualizaciones.

Normalmente, estas tareas se ejecutan y completan automáticamente, sin su intervención. Sin embargo, si alguna vez necesita administrar manualmente las tareas en cola de una extensión (por ejemplo, pausar la cola o eliminar de la cola una tarea que aún no ha comenzado), siga estos pasos:

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

  2. En la página de detalles, abra la sección API y recursos . Si la extensión utiliza Cloud Tasks, habrá una sección de colas de Cloud Task con una o más entradas.

  3. Haga clic en Ver cola para la cola que desea administrar. Esto abrirá la página Detalles de la cola en la consola de Google Cloud, desde la cual puede ver las tareas en cola, pausar la cola, eliminar tareas de la cola, etc. Consulte Administrar colas y tareas en la documentación de Cloud Tasks.

Ver secretos de Cloud Secret Manager creados por extensiones

  1. Abra la página Secret Manager de su proyecto en la consola de Google Cloud.

  2. En la lista de Secretos, puede ver los secretos creados para Firebase Extensions (junto con cualquier otro secreto que haya creado para su proyecto).

    Los secretos creados por extensiones tienen nombres en el formato: ext- extension-instance-id - paramnName

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

    Los secretos están etiquetados con la clave firebase-extensions-managed . No elimines esta etiqueta a menos que quieras evitar que Firebase administre el secreto.

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

Puede revisar todos los errores de las funciones (incluidos los creados por Firebase Extensions) en la consola.

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

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

Compruebe con qué frecuencia se ejecuta una extensión instalada

  1. En la pestaña Panel de su panel de Funciones , ubique la función específica para la extensión de Firebase que desea verificar.

  2. Haga clic en (el menú adicional) en el extremo derecho de la entrada, luego seleccione Estadísticas de uso detalladas .

  3. En la consola de Google Cloud que se muestra, puede profundizar en varias invocaciones de una función e incluso inspeccionar su código fuente.

Ver los registros de una extensión

Si estás intentando depurar tu proyecto o enviar un informe de error a Firebase, es útil ver los registros de las funciones que se ejecutan en tu proyecto.

En la pestaña Registros de su panel de Funciones , use el filtro en la parte superior de la página para seleccionar las funciones creadas por su extensión.

Actualizar una instancia de extensión instalada a la última versión

Puede actualizar una instancia instalada de una extensión a su última versión publicada. Es posible que desee actualizar una instancia instalada porque la instancia ya se está ejecutando o configurando activamente en su flujo de trabajo de prueba, proyecto o aplicación.

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

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

  1. Vaya a su panel de Firebase Extensions y luego, en la tarjeta de la instancia de extensión instalada, haga clic en Administrar .

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

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

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

  4. Haga clic en Actualizar extensión .

Reconfigurar una instancia de extensión instalada

Puede cambiar los valores de los parámetros configurados por el usuario para una instancia de extensión instalada. Estos nuevos valores se utilizarán en cualquier activación futura de la instancia, pero todos los artefactos o elementos estructurales anteriores creados por la extensión (como imágenes almacenadas o depósitos de almacenamiento existentes) no se cambiarán.

  1. Vaya a su panel de Firebase Extensions y luego, en la tarjeta de la instancia de extensión instalada, haga clic en Administrar .

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

  3. Siga las instrucciones que aparecen en pantalla para reconfigurar los valores de los parámetros para su extensión.

  4. Clic en Guardar .

Desinstalar una instancia de extensión

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

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

  • Cualquier otro recurso en su proyecto, como una instancia de base de datos o un depósito 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 eliminan si se desinstala la extensión.

A continuación se explica cómo desinstalar una extensión:

  1. Vaya a su panel de Firebase Extensions y luego, en la tarjeta de la instancia de extensión instalada, haga clic en Administrar .

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

  3. Revise lo que se eliminará y luego haga clic en Desinstalar extensión para confirmar la eliminación.