Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Administrar extensiones de Firebase instaladas

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Para instalar o administrar extensiones, debe tener asignado uno de estos roles: Propietario o Editor o Administrador de Firebase .

de Firebase

Enumerar las instancias de extensión instaladas de un proyecto

Puede enumerar cada instancia de las extensiones que instaló.

Ejecute el comando de lista de extensiones:

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

Supervisar una instancia de extensión instalada

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

Establecer alertas de presupuesto

Establecer alertas de presupuesto es una buena práctica en general, pero las alertas pueden ser especialmente importantes cuando confía en el código de otra parte para ejecutar su proyecto.

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

Ver funciones creadas por extensiones

  1. Vaya a su panel de Funciones de la consola de Firebase.

  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 de Cloud Scheduler de su proyecto en Google Cloud Console.

  2. En la lista de trabajos, puede ver los trabajos de Cloud Scheduler de 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, para 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 la extensión.

  2. En la página de detalles, abra la sección API y recursos . Si la extensión usa 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 Google Cloud Console, desde donde 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 los secretos de Cloud Secret Manager creados por extensiones

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

  2. En la lista 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 elimine esta etiqueta a menos que desee evitar que Firebase administre el secreto.

Comprobar 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 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 la 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.

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

  1. En la pestaña Panel de control de Funciones , busque la función específica para la Extensión de Firebase que desea verificar.

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

  3. En la Google Cloud Console 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 intenta depurar su proyecto o enviar un informe de error a Firebase, es útil ver los registros de las funciones que se ejecutan en su proyecto.

En la pestaña Registros de su panel 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 activamente o configurada 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 de la extensión y la cuenta de servicio no cambiarán.

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

  1. Para actualizar una instancia de extensión en su manifiesto de extensiones a la última versión, ejecute el comando de actualización de extensión:

    firebase ext:update extensionInstanceId

    Para actualizar a una versión específica, proporcione la versión a la que desea actualizar:

    firebase ext:update extensionInstanceId versionNumber
  2. Luego, para implementar las extensiones en su manifiesto en un proyecto de Firebase, ejecute:

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

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 usarán en futuros activadores de la instancia, pero todos los artefactos o elementos estructurales anteriores creados por la extensión (como imágenes almacenadas o cubos de almacenamiento existentes) no se cambiarán.

  1. Para reconfigurar de forma interactiva una extensión en su manifiesto de extensiones, ejecute el comando de configuración de la extensión:

    firebase ext:configure extensionInstanceId
  2. Luego, para implementar las extensiones en su manifiesto en un proyecto de Firebase, ejecute:

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

Desinstalar una instancia de extensión

Puede desinstalar una instancia de una extensión de su 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 tu 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.

Aquí se explica cómo desinstalar una extensión:

  1. Para eliminar una instancia de extensión de su manifiesto de extensiones, ejecute el comando de desinstalación de extensiones:

    firebase ext:uninstall extensionInstanceId
  2. Luego, para implementar los cambios en su manifiesto en un proyecto de Firebase, ejecute:

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