Check out what’s new from Firebase at Google I/O 2022. Learn more

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

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

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

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

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

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

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

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

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

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

Убедитесь, что вы настроили оповещения о бюджете для своего проекта Firebase.

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

  1. Перейдите на панель функций консоли Firebase.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Просмотр журналов для расширения

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

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

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

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

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

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

  1. Запустите команду extensions-list, чтобы получить идентификатор экземпляра расширения:

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

  2. Запустите команду обновления расширения:

    firebase ext:update extensionInstanceId --project=projectId-or-alias

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

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

  1. Запустите команду extensions-list, чтобы получить идентификатор экземпляра расширения:

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

  2. Запустите команду extension-configure:

    firebase ext:configure extensionInstanceId --project=projectId-or-alias --params=path/to/envFile

    Где --params — необязательный флаг для предоставления файла, который определяет значения настраиваемых пользователем параметров и позволяет вам обходить интерактивные подсказки терминала для этих значений. Определите свои значения в файле .env , который следует синтаксису dotenv .

  3. Если появится запрос (или вы не предоставили файл .env ), введите значения конфигурации, чтобы настроить расширение для своего проекта.

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

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

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

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

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

  1. Запустите команду extensions-list, чтобы получить идентификатор экземпляра расширения:

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

  2. Запустите команду удаления расширения:

    firebase ext:uninstall extensionInstanceId --project=projectId-or-alias