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

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


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

Вы можете составить список всех установленных вами расширений.

Запустите команду extensions-list:

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

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

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

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

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

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

Установить оповещения о бюджете

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

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

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

  1. Перейдите на панель управления «Функции» консоли 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

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

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

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

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

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

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

Просмотр секретов 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. Просмотрите, что будет удалено, затем нажмите «Удалить расширение» , чтобы подтвердить удаление.