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

Чтобы устанавливать расширения или управлять ими, вам должна быть назначена одна из этих ролей: владелец, редактор или администратор Firebase .

Консоль Firebase Firebase CLI Автогенерируемый SDK

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

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

Запустите команду списка расширений:

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 и ресурсы . Если расширение использует облачные задачи, будет раздел очередей облачных задач с одной или несколькими записями.

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

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

   1. Установите новый экземпляр расширения.
   2. Только после установки нового экземпляра удалите старый экземпляр.

Просмотр секретов 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, полезно просмотреть журналы функций, выполняемых в вашем проекте.

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

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

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

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

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

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

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

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

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

3. Просмотрите, что нового в обновлении, и настройте расширение (при необходимости).

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

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

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

Примечание. Если вы установили расширение с помощью автоматически созданного SDK, используйте тот же метод для его перенастройки, а не с помощью консоли или интерфейса командной строки.

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

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

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

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

Примечание. Сохранение изменений расширения может занять у системы 3–5 минут.

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

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

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

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

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

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

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

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

Примечание. Если вы установили расширение с помощью автоматически созданного SDK, обязательно удалите конфигурацию экземпляра из кода Cloud Functions.