Установите расширение Firebase

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

Обязательно ознакомьтесь с различиями в поддерживаемых действиях для интерфейса командной строки Firebase и консоли Firebase.


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

Чтобы установить расширение, ваш проект должен находиться в плане Blaze (оплата по мере использования). Хотя за установку расширения плата не взимается, с вас может взиматься плата за использование служб Firebase или облачных служб, таких как Cloud Secret Manager , если ваше использование превышает уровень бесплатного пользования службами.

Прежде чем вы начнете

  1. Если вы еще этого не сделали, добавьте Firebase в свой проект .

  2. Если вы еще этого не сделали, обновите свой проект до плана Blaze (оплата по мере использования).

  3. Установите или обновите последнюю версию Firebase CLI.

  4. Запишите либо идентификатор вашего проекта Firebase, либо ранее настроенный псевдоним проекта.

Шаг 1. Просмотрите подробную информацию о расширении.

Этот шаг не является обязательным, но настоятельно рекомендуется.

Перед установкой расширения Firebase мы рекомендуем вам просмотреть подробную информацию о расширении, включая:

  • Как работает расширение, какие задачи перед установкой и подробности о расширении
  • Общая идентификационная информация и описание
  • Требуется ли для задач расширения учетная запись для выставления счетов
  • Сервисы Google (API) и роли доступа , необходимые для работы
  • Ресурсы , созданные для расширения (например, функции).
  • Описания настраиваемых пользователем параметров

Чтобы просмотреть подробную информацию о расширении:

  1. Убедитесь, что вы настроили свою среду и выбрали расширение .

  2. Запустите команду Extension-info из любого места вашего компьютера:

    firebase ext:info publisher-id/extension-id

    Аргументы publisher-id и extension-id являются обязательными. Их можно найти на странице сведений о предварительной установке расширения .

Шаг 2. Установите расширение.

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

  1. Убедитесь, что вы настроили свою среду и выбрали расширение .

  2. В локальном каталоге Firebase запустите команду Extension-install. При появлении запроса введите значения параметров, чтобы настроить экземпляр расширения.

    firebase ext:install publisher-id/extension-id --project=projectId-or-alias

    Аргументы publisher-id и extension-id являются обязательными. Их можно найти на странице сведений о предварительной установке расширения .

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

  3. Затем, чтобы развернуть расширения из вашего манифеста в проекте Firebase, запустите:

    firebase deploy --only extensions --project=projectId-or-alias

Шаг 3. Завершите настройку после установки.

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

Вы также можете найти эти инструкции в файле POSTINSTALL.md , включенном в исходный каталог расширения .

Создание ресурсов Firebase

Если вы настроили расширение для использования ресурсов Firebase (коллекций Cloud Firestore, путей к базе данных реального времени, сегментов Cloud Storage), которые еще не существуют, создайте их перед использованием расширения.

Создание обработчиков событий Eventarc

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

Список событий (если таковые имеются), которые оно публикует, см. в документации расширения. Например, см. типы событий для расширения «Выполнение платежей с помощью Stripe» .

Затем см. раздел Пользовательские триггеры событий для получения информации о написании обработчиков событий Eventarc.

Установите несколько экземпляров расширения

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

Следующие шаги