Вы можете установить (и управлять ) любым официальным расширением 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 , когда во время выполнения происходят важные события. Если расширение публикует события и вы включили события во время установки, вы можете написать функции, реагирующие на эти события, с помощью собственной логики. Это может быть полезно, например, для уведомления пользователей о завершении длительных задач или для последующей обработки вывода функции расширения.
Список событий (если таковые имеются), которые оно публикует, см. в документации расширения. Например, см. типы событий для расширения «Выполнение платежей с помощью Stripe» .
Затем см. раздел Пользовательские триггеры событий для получения информации о написании обработчиков событий Eventarc.
Установите несколько экземпляров расширения
Вы можете установить одно и то же расширение несколько раз в одном проекте. Каждый установленный экземпляр может иметь собственную настроенную конфигурацию и собственные ресурсы расширения. Вы идентифицируете каждый установленный экземпляр и ссылаетесь на него, используя его идентификатор экземпляра , который уникален в рамках вашего проекта.
Вам будет предложено подтвердить или изменить идентификатор экземпляра каждого дополнительного экземпляра устанавливаемого вами расширения.
Следующие шаги
Просмотрите подробную информацию и конфигурацию установленного расширения в консоли Firebase .
Отслеживайте активность установленного расширения, включая проверку его работоспособности, использования и журналов.
Управляйте установленным расширением с помощью консоли Firebase . Для официальных расширений Firebase вы можете перенастроить или удалить расширение, а также обновить его до последней версии.
Рекомендуется для всех проектов обязательно настроить оповещения о бюджете для вашего проекта и отслеживать панель использования и выставления счетов в консоли Firebase .