Управление установленными расширениями Firebase

Для установки или управления расширениями вам должна быть назначена одна из следующих ролей: Владелец, Редактор или Администратор Firebase .


Отобразить список установленных экземпляров расширений проекта.

Вы можете перечислить все установленные вами расширения.

Выполните команду extensions-list:

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

Просмотр сведений и настроек установленного экземпляра расширения.

  1. Перейдите в панель управления Firebase Extensions в консоли Firebase .

  2. На карточке установленного расширения нажмите «Управление» .

Отслеживание установленного экземпляра расширения

В консоли Firebase можно отслеживать активность установленного расширения, включая проверку его работоспособности, использования и журналы.

Настройте оповещения о бюджете

Настройка оповещений о бюджете — это, как правило, хорошая практика, но оповещения могут быть особенно важны, когда вы доверяете выполнение кода другой стороны в вашем проекте.

Обязательно настройте оповещения о бюджете для вашего проекта Firebase.

Просмотр функций, созданных расширениями.

  1. Перейдите на панель управления Functions в консоли Firebase .

  2. На вкладке «Панель управления» вы можете просмотреть функции из Firebase Extensions (а также любые другие функции, которые вы развернули для своего проекта).

    Функции, созданные расширениями, имеют имена в формате: ext- extension-instance-id - functionName

    Например: ext-awesome-task-simplifier-onUserCreate

Просмотр заданий Cloud Scheduler , созданных расширениями.

  1. Откройте страницу Cloud Scheduler вашего проекта в консоли Google Cloud .

  2. В списке заданий вы можете просмотреть задания Cloud Scheduler из Firebase Extensions (а также любые другие задания, созданные вами для вашего проекта).

    Задания, созданные расширениями, имеют имена в формате: firebase-ext- extension-instance-id - functionName

    Например: firebase-ext-awesome-task-simplifier-doTask

Просмотр и управление облачными задачами, поставленными в очередь расширениями.

Некоторые расширения используют Cloud Tasks для выполнения длительных задач: чаще всего это задачи обработки, которые выполняются на разных этапах жизненного цикла расширения — при установке, перенастройке и после обновлений.

Обычно эти задачи выполняются и завершаются автоматически, без вашего вмешательства. Однако, если вам когда-либо потребуется вручную управлять задачами расширения, находящимися в очереди — например, приостановить очередь или удалить из очереди задачу, которая еще не началась, — выполните следующие действия:

  1. В разделе «Расширения» консоли Firebase откройте страницу с подробными сведениями об экземпляре расширения.

  2. На странице с подробной информацией откройте раздел «API и ресурсы» . Если расширение использует Cloud Tasks, там будет раздел « Очереди Cloud Task» с одной или несколькими записями.

  3. Нажмите «Просмотреть очередь» для очереди, которой вы хотите управлять. Это откроет страницу «Подробности очереди» в консоли Google Cloud , где вы можете просматривать задачи в очереди, приостанавливать очередь, удалять задачи из очереди и так далее. См. раздел «Управление очередями и задачами» в документации Cloud Tasks.

Просмотрите секреты Cloud Secret Manager, созданные расширениями.

  1. Откройте страницу Secret Manager вашего проекта в консоли Google Cloud .

  2. В списке «Секреты» вы можете просмотреть секреты, созданные для Firebase Extensions (а также любые другие секреты, созданные вами для вашего проекта).

    Секреты, создаваемые расширениями, имеют имена в формате: ext- extension-instance-id - paramnName

    Например: ext-awesome-task-simplifier-API_KEY

    Секреты помечаются меткой firebase-extensions-managed . Не удаляйте эту метку, если не хотите, чтобы Firebase перестал управлять секретом.

Проверьте работоспособность установленного расширения.

В консоли можно просмотреть все ошибки, возникающие в функциях (включая ошибки, созданные Firebase Extensions ).

  1. На вкладке «Состояние» панели управления функциями вы можете просмотреть обзор ошибок и информацию о производительности всех функций в вашем проекте.

  2. Для просмотра информации по конкретному расширению используйте фильтр в верхней части страницы, чтобы выбрать определенную функцию.

Проверьте, как часто запускается установленное расширение.

  1. На вкладке «Панель управления» панели «Функции» найдите конкретную функцию Firebase Extension , которую вы хотите проверить.

  2. Нажмите кнопку (вкладка "Дополнительное меню") в правом верхнем углу записи, затем выберите "Подробная статистика использования" .

  3. В отображаемой консоли Google Cloud вы можете детально изучить различные вызовы функции и даже просмотреть ее исходный код.

Просмотрите журналы для получения информации о расширении.

Если вы пытаетесь отладить свой проект или отправить отчет об ошибке в Firebase, полезно просмотреть логи функций, работающих в вашем проекте.

На вкладке «Журналы» панели управления функциями используйте фильтр в верхней части страницы, чтобы выбрать функции, созданные вашим расширением.

Обновите установленное расширение до последней версии.

Вы можете обновить установленный экземпляр расширения до последней выпущенной версии. Это может потребоваться, если установленный экземпляр уже активно запущен или настроен в вашем процессе тестирования, проекта или приложения.

При обновлении экземпляра все ресурсы и логика, специфичные для расширения, перезаписываются исходным кодом и файлами новой версии. Идентификатор экземпляра расширения и учетная запись службы остаются неизменными.

В процессе обновления вы получите уведомление обо всех изменениях в новой версии, и сможете указать значения для любых новых параметров.

  1. Перейдите в панель управления Firebase Extensions , затем на карточке установленного экземпляра расширения нажмите «Управление» .

  2. В правом верхнем углу нажмите «Обновить расширение» .

    Если для расширения нет доступной новой версии, на странице с подробной информацией не будет кнопки обновления.

  3. Ознакомьтесь с нововведениями в обновлении и настройте расширение (при необходимости).

  4. Нажмите «Обновить расширение» .

Перенастройте установленный экземпляр расширения.

Вы можете изменить значения параметров, заданных пользователем, для установленного экземпляра расширения. Эти новые значения будут использоваться во всех будущих триггерах экземпляра, но все предыдущие артефакты или структурные элементы, созданные расширением (например, сохраненные изображения или существующие хранилища), останутся без изменений.

  1. Перейдите в панель управления Firebase Extensions , затем на карточке установленного экземпляра расширения нажмите «Управление» .

  2. В правом верхнем углу нажмите «Перенастроить расширение» .

  3. Следуйте инструкциям на экране, чтобы изменить значения параметров вашего расширения.

  4. Нажмите « Сохранить ».

Удалить экземпляр расширения

Вы можете удалить экземпляр расширения из своего проекта Firebase. Это действие удаляет учетную запись службы и все ресурсы (например, набор функций), которые Firebase создал специально для этого экземпляра расширения. Однако следующие элементы не удаляются:

  • Любые артефакты, созданные расширением (например, сохраненные изображения).

  • Любые другие ресурсы в вашем проекте, такие как экземпляр базы данных или хранилище Cloud Storage . Даже если расширение взаимодействовало с этими другими ресурсами, они не являются специфичными для расширения , поэтому они не удаляются при удалении расширения.

Вот как удалить расширение:

  1. Перейдите в панель управления Firebase Extensions , затем на карточке установленного экземпляра расширения нажмите «Управление» .

  2. В нижней части экрана нажмите «Удалить расширение» .

  3. Просмотрите список удаляемых файлов, затем нажмите «Удалить расширение» , чтобы подтвердить удаление.