Вы можете установить (и управлять ) любым официальным расширением Firebase, используя либо консоль Firebase, либо Firebase CLI (интерфейс командной строки).
Обязательно ознакомьтесь с различиями в поддерживаемых действиях для интерфейса командной строки Firebase и консоли Firebase.
Чтобы устанавливать расширения или управлять ими, вам должна быть назначена одна из этих ролей: владелец, редактор или администратор Firebase .
Чтобы установить расширение, ваш проект должен находиться в плане Blaze (оплата по мере использования). Хотя за установку расширения плата не взимается, с вас может взиматься плата за использование служб Firebase или облачных служб, таких как Cloud Secret Manager , если ваше использование превышает уровень бесплатного пользования службами.
Прежде чем вы начнете
Если вы еще этого не сделали, добавьте Firebase в свой проект .
Если вы еще этого не сделали, обновите свой проект до плана Blaze (оплата по мере использования).
Запишите либо идентификатор вашего проекта Firebase, либо ранее настроенный псевдоним проекта.
- Идентификатор проекта — запускайте
firebase projects:list
из любого места на вашем компьютере. - Псевдоним проекта — запустите
firebase use
из локального каталога приложений.
- Идентификатор проекта — запускайте
Шаг 1. Просмотрите подробную информацию о расширении.
Этот шаг не является обязательным, но настоятельно рекомендуется.
Перед установкой расширения Firebase мы рекомендуем вам просмотреть подробную информацию о расширении, включая:
- Как работает расширение, какие задачи перед установкой и подробности о расширении
- Общая идентификационная информация и описание
- Требуется ли для задач расширения учетная запись для выставления счетов
- Сервисы Google (API) и роли доступа, необходимые для работы
- Ресурсы , созданные для расширения (например, функции).
- Описания настраиваемых пользователем параметров
Чтобы просмотреть подробную информацию о расширении:
Убедитесь, что вы настроили свою среду и выбрали расширение .
Запустите команду Extension-info из любого места вашего компьютера:
firebase ext:info publisher-id/extension-id
Аргументы
publisher-id
иextension-id
являются обязательными. Их можно найти на странице сведений о предварительной установке расширения .
Шаг 2. Установите расширение.
В процессе установки вам будет предложено просмотреть основные характеристики расширения (например, включенные API, созданные ресурсы , предоставленный доступ и т. д.). Вы будете уведомлены о любых требованиях к выставлению счетов, а также вам будет предложено указать значения настраиваемых параметров расширения.
Убедитесь, что вы настроили свою среду и выбрали расширение .
В локальном каталоге Firebase запустите команду Extension-install. При появлении запроса введите значения параметров, чтобы настроить экземпляр расширения.
firebase ext:install publisher-id/extension-id --project=projectId-or-alias
Аргументы
publisher-id
иextension-id
являются обязательными. Их можно найти на странице сведений о предварительной установке расширения .Выполнение этой команды добавляет экземпляр расширения в манифест расширений .
Затем, чтобы развернуть расширения из вашего манифеста в проекте Firebase, запустите:
firebase deploy --only extensions --project=projectId-or-alias
Шаг 3. Завершите настройку после установки.
Некоторые расширения содержат обязательные или дополнительные действия, которые необходимо выполнить перед их использованием. Эти инструкции можно найти на странице сведений о вашем расширении после установки на панели расширений консоли Firebase (конкретная ссылка на панель мониторинга отображается в терминале после установки).
Вы также можете найти эти инструкции в файле POSTINSTALL.md
, включенном в исходный каталог расширения .
Создание ресурсов Firebase
Если вы настроили расширение для использования ресурсов Firebase (коллекций Cloud Firestore, путей к базе данных реального времени, сегментов Cloud Storage), которые еще не существуют, создайте их перед использованием расширения.
Создание обработчиков событий Eventarc
Некоторые расширения публикуют информацию в Eventarc , когда во время выполнения происходят важные события. Если расширение публикует события и вы включили события во время установки, вы можете написать функции, реагирующие на эти события, с помощью собственной логики. Это может быть полезно, например, для уведомления пользователей о завершении длительных задач или для последующей обработки вывода функции расширения.
Список событий (если таковые имеются), которые оно публикует, см. в документации расширения. Например, см. типы событий для расширения «Выполнение платежей с помощью Stripe» .
Затем см. раздел Пользовательские триггеры событий для получения информации о написании обработчиков событий Eventarc.
Установите несколько экземпляров расширения
Вы можете установить одно и то же расширение несколько раз в одном проекте. Каждый установленный экземпляр может иметь собственную настроенную конфигурацию и собственные ресурсы расширения. Вы идентифицируете каждый установленный экземпляр и ссылаетесь на него, используя его идентификатор экземпляра , который уникален в рамках вашего проекта. Вам будет предложено подтвердить или изменить идентификатор экземпляра каждого дополнительного экземпляра устанавливаемого вами расширения.
Следующие шаги
Просмотрите подробную информацию и конфигурацию установленного расширения в консоли Firebase.
Отслеживайте активность установленного расширения, включая проверку его работоспособности, использования и журналов.
Управляйте установленным расширением с помощью Firebase CLI. Вы можете перенастроить или удалить расширение, а также обновить его до последней версии.
Управляйте установленным расширением с помощью консоли Firebase. Для официальных расширений Firebase вы можете перенастроить или удалить расширение, а также обновить его до последней версии.
Рекомендуется для всех проектов обязательно настроить оповещения о бюджете для вашего проекта и отслеживать панель использования и выставления счетов в консоли Firebase.