Вы можете установить (и управлять ) любыми официальными расширениями Firebase , используя либо консоль Firebase , либо интерфейс командной строки Firebase (CLI ), либо автоматически сгенерированный SDK.
Обязательно ознакомьтесь с различиями в поддерживаемых действиях для каждого метода установки.
Для установки или управления расширениями вам должна быть назначена одна из следующих ролей: Владелец, Редактор или Администратор Firebase .
Для установки расширения ваш проект должен быть подключен к тарифному плану Blaze (оплата по мере использования). Хотя установка расширения бесплатна, с вас может взиматься плата за использование сервисов Firebase или облачных сервисов, таких как Cloud Secret Manager , если ваше использование превышает бесплатный уровень этих сервисов.
Прежде чем начать
Если вы еще этого не сделали, добавьте Firebase в свой проект и обновите свой проект Firebase до тарифного плана Blaze (оплата по мере использования).
Шаг 1 : Просмотрите подробную информацию о расширении.
Этот шаг необязателен, но настоятельно рекомендуется.
Перед установкой Firebase Extension мы рекомендуем ознакомиться с подробной информацией о расширении, включая:
- Как работает расширение, какие задачи необходимо выполнить перед установкой, и подробная информация о расширении.
- Общая идентификационная информация и описание
- Требуется ли для выполнения задач расширения платёжный аккаунт?
- Для работы требуются сервисы Google (API) и роли доступа .
- Ресурсы, созданные для расширения (например, функции).
- Описание параметров, настраиваемых пользователем.
Чтобы просмотреть подробную информацию о расширении:
Просмотрите официальные расширения Firebase в Extensions Hub .
Нажмите на карточку расширения, чтобы:
Отобразить подробную информацию о расширении.
Ссылка на исходный код расширения находится в репозитории исходного кода Firebase Extensions .
Подробную информацию об этом можно найти в файле
READMEв каталоге расширения.
Шаг 2 : Установите расширение
В процессе установки вам будет предложено ознакомиться с основными характеристиками расширения (например, включенными API, созданными ресурсами , предоставленным доступом и т. д.). Вы получите уведомление о требованиях к оплате, а также вам будет предложено указать значения для настраиваемых параметров расширения.
Просмотрите официальные расширения Firebase в Extensions Hub .
Щёлкните по карточке расширения, затем ознакомьтесь с подробной информацией о расширении, которая может содержать конкретные инструкции по использованию и любые задачи, необходимые перед установкой.
Нажмите «Установить» , затем следуйте инструкциям на экране, чтобы установить расширение.
Шаг 3 : Завершение настройки после установки.
Для некоторых расширений требуются обязательные или необязательные действия перед их использованием. Эти инструкции вы найдете на странице с подробной информацией о вашем расширении после установки в панели управления Extensions консоли Firebase (конкретная ссылка на панель управления отобразится в терминале после установки).
Эти инструкции также можно найти в файле POSTINSTALL.md который находится в исходном каталоге расширения .
Создание ресурсов Firebase
Если вы настроили расширение для использования ресурсов Firebase (коллекций Cloud Firestore , путей Realtime Database , сегментов Cloud Storage ), которые еще не существуют, создайте их перед использованием расширения.
Создайте обработчики событий Eventarc.
Некоторые расширения публикуют события в Eventarc , когда они происходят во время выполнения. Если расширение публикует события, и вы включили их при установке, вы можете написать функции, которые реагируют на эти события с помощью собственной пользовательской логики. Это может быть полезно, например, для уведомления пользователей о завершении длительных задач или для постобработки выходных данных функции расширения.
Список публикуемых им событий (если таковые имеются) см. в документации расширения. Например, см. типы событий для расширения Run Payments with Stripe .
Затем см. раздел «Пользовательские триггеры событий» для получения информации о написании обработчиков событий Eventarc.
Установите несколько экземпляров расширений.
В одном проекте можно установить одно и то же расширение несколько раз. Каждый установленный экземпляр может иметь собственную конфигурацию и собственные ресурсы расширения. Идентификация и ссылка на каждый установленный экземпляр осуществляется с помощью его идентификатора экземпляра (Install ID) , который является уникальным в рамках вашего проекта.
Вам будет предложено подтвердить или изменить идентификатор экземпляра каждого дополнительного экземпляра устанавливаемого вами расширения.
Следующие шаги
Просмотрите подробную информацию и конфигурацию установленного расширения в консоли Firebase .
Отслеживайте активность установленного расширения, включая проверку его работоспособности, использования и ведение журналов.
С помощью консоли Firebase вы можете управлять установленными расширениями. Для официальных расширений Firebase вы можете перенастроить или удалить расширение, а также обновить его до последней версии.
В качестве лучшей практики для всех проектов обязательно настройте оповещения о бюджете для вашего проекта и отслеживайте панель мониторинга использования и выставления счетов в консоли Firebase .