Начните использовать Firebase с существующим проектом Google Cloud.

Проект Firebase — это проект Google Cloud , в котором включены некоторые дополнительные конфигурации и сервисы, специфичные для Firebase. Это обычно называется «добавлением Firebase» в проект Google Cloud . На этой странице описывается , как «добавить Firebase» , а также приведены ответы на некоторые часто задаваемые вопросы (FAQ) .

При добавлении Firebase в проект Google Cloud , Firebase автоматически включает несколько API и создаёт учётные записи служб для упрощения использования всех сервисов и интерфейсов Firebase. Firebase также добавляет метку firebase:enabled к вашему проекту на странице «Метки» консоли Google Cloud . Узнайте больше о том, что происходит при добавлении Firebase .

Связь между проектом Firebase и проектом Google Cloud

Поскольку проект Firebase — это проект Google Cloud :

• Вы можете получить доступ к проекту и взаимодействовать с ним в консоли Firebase , а также в консоли Google Cloud и консоли Google API .

• Вы можете взаимодействовать с проектом, используя Firebase CLI , gcloud CLI и любой ресурс Terraform от Google.

• В проекте вы можете использовать продукты и API как Firebase, так и Google Cloud .

• Разрешения и роли IAM для проекта являются общими для Firebase и Google Cloud . Любой доступ участника проекта (то есть принципала) к вашему проекту Google Cloud будет применяться и к вашему проекту Firebase (и наоборот).

• Оплата за проект производится совместно через Firebase и Google Cloud . Если для вашего проекта Google Cloud включена оплата, то для вашего проекта Firebase будет действовать тарифный план Blaze с оплатой по факту использования от Firebase.

• Уникальные идентификаторы проекта (например, номер проекта и идентификатор проекта ) являются общими для Firebase и Google Cloud .

• Любая иерархия ресурсов , примененная к вашему проекту Google Cloud (например, организация, папки и т. д.), будет также применена к вашему проекту Firebase.

• Удаление проекта приведет к его удалению из Firebase и Google Cloud .

• Удаление или изменение ресурса или данных в проекте применяется к Firebase и Google Cloud .

Как добавить Firebase в существующий проект Google Cloud

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

Имейте в виду, что после добавления Firebase в существующий проект Google Cloud это действие нельзя будет отменить (то есть, полностью удалить Firebase из проекта Google Cloud невозможно). Подробнее читайте в разделе часто задаваемых вопросов .

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

Консоль Firebase

1. Войдите в консоль Firebase , используя учетную запись, которая предоставляет вам доступ к существующему проекту Google Cloud .

2. Нажмите кнопку, чтобы создать новый проект Firebase.

3. В нижней части страницы нажмите Добавить Firebase в проект Google Cloud .

4. В текстовом поле начните вводить название существующего проекта, а затем выберите проект из отображаемого списка.

5. Нажмите Открыть проект .

6. При появлении соответствующего запроса примите Условия Firebase .

7. Следуйте инструкциям на экране, чтобы «добавить Firebase» и настроить проект Firebase.

   Обратите внимание, что включение помощи ИИ в консоли Firebase и Google Analytics необязательно.

Firebase CLI

1. Если вы еще этого не сделали, установите Firebase CLI .

2. Войдите в систему, используя ту же учетную запись Google, которая предоставляет вам доступ к существующему проекту Google Cloud .

3. Выполните следующую команду:

   firebase projects:addfirebase

4. При появлении запроса выберите существующий проект Google Cloud из отображаемого списка.

Примечание: Если вы получаете ошибку 403 PERMISSION_DENIED при попытке «добавить Firebase» в существующий проект Google Cloud , это может означать, что у вас нет необходимых разрешений или вы не приняли Условия обслуживания Firebase .

REST API

1. Включите Firebase Management API в существующем проекте Google Cloud .

2. Сгенерируйте токен доступа к API.

3. Включите службы Firebase для проекта, вызвав projects.addFirebase .

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

Подробные инструкции см. в разделе «Добавление служб Firebase в ваш проект» руководства Firebase: «Настройка и управление проектом Firebase с помощью REST API управления». Обязательно следуйте всем инструкциям в разделе «Перед началом работы» этого руководства.

Примечание: Если вы получаете ошибку 403 PERMISSION_DENIED при попытке «добавить Firebase» в существующий проект Google Cloud , это может означать, что у вас нет необходимых разрешений или вы не приняли Условия обслуживания Firebase .

Терраформировать

1. Включите Firebase Management API ( firebase.googleapis.com ) в существующем проекте Google Cloud .

2. Включите службы Firebase для проекта с помощью ресурса google_firebase_project .

Подробную информацию об использовании Firebase и Terraform см. в разделе Начало работы с Terraform и Firebase .

Примечание: Если вы получаете ошибку 403 PERMISSION_DENIED при попытке «добавить Firebase» в существующий проект Google Cloud , это может означать, что у вас нет необходимых разрешений или вы не приняли Условия обслуживания Firebase .

Часто задаваемые вопросы и устранение неполадок

Требуется ли принятие Условий обслуживания Firebase для начала использования Firebase?

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

Вам нужно принять Условия использования Firebase только один раз для своей учётной записи Google, независимо от того, к скольким проектам у вас есть доступ. Принимая Условия, вы принимаете их только для своей учётной записи Google; принятие условий не распространяется на уровень проекта и не распространяется на всех его участников.

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

• Создайте новый проект Firebase с помощью консоли Firebase .

• Откройте существующий проект Firebase в консоли Firebase (например, кто-то пригласил вас стать участником проекта (то есть руководителем) в проекте).

• Откройте существующее Google Cloud в консоли Firebase и «добавьте к нему Firebase» .

Примечание: Принять Условия использования Firebase невозможно с помощью Firebase CLI, REST API или Terraform. Это можно сделать только через консоль Firebase .

Важно: если вы подписали автономный вариант основного соглашения Google Cloud для использования определенных служб Firebase в рамках той же учетной записи Google Cloud Platform, Условия Firebase не применяются к вашему использованию таких служб Firebase, и ваши автономные условия регулируют ваше использование таких служб Firebase.

Какие разрешения необходимы для «добавления Firebase»?

Чтобы «добавить Firebase» в существующий проект Google Cloud , участник проекта (то есть принципал) должен иметь следующие разрешения IAM:

• firebase.projects.update
• resourcemanager.projects.get
• serviceusage.services.enable
• serviceusage.services.get

Роли IAM «Редактор» и «Владелец» содержат эти разрешения по умолчанию.

Достаточно ли добавления метки firebase:enabled для добавления Firebase?

Все проекты Firebase имеют метку firebase:enabled на странице «Метки» консоли Google Cloud .

Однако простое добавление метки firebase:enabled в список меток проекта вручную НЕ активирует специфичные для Firebase конфигурации и сервисы для вашего проекта Google Cloud . Для этого необходимо добавить Firebase через консоль Firebase (или, в более сложных случаях, через Firebase CLI, Firebase Management REST API или Terraform).

Что происходит, когда вы «добавляете Firebase» к существующему проекту Google Cloud ?

Проект Firebase — это проект Google Cloud , в котором включены некоторые дополнительные конфигурации и сервисы, специфичные для Firebase. Поэтому при добавлении Firebase в существующий проект Google Cloud Firebase выполняет следующие действия для упрощения использования всех сервисов и интерфейсов Firebase:

• Добавляет метку firebase:enabled на страницу «Метки» консоли Google Cloud .

• Создает ключ API «Браузер» и автоматически ограничивает его API, связанными с Firebase .

• Создает следующие учетные записи служб:

  • service- PROJECT_NUMBER @gcp-sa-firebase.iam.gserviceaccount.com
  • firebase-adminsdk- random5chars @ PROJECT_ID .iam.gserviceaccount.com

• Включает следующие API:

  • API администратора App Engine
  • API облачной публикации/подписки
  • API диспетчера облачных ресурсов
  • API конфигурации среды выполнения облака
  • API облачного тестирования
  • API облачных сообщений Firebase
  • API динамических ссылок Firebase
  • API хостинга Firebase
  • API установок Firebase
  • API управления Firebase
  • API удаленной настройки Firebase
  • API удаленной настройки Firebase в реальном времени
  • API правил Firebase
  • API набора инструментов идентификации
  • API службы токенов

Могу ли я «удалить Firebase» из проекта?

После «добавления Firebase» в существующий проект Google Cloud действие нельзя отменить (то есть, вы не сможете полностью «удалить Firebase» из проекта Google Cloud ).

Процесс добавления Firebase активирует API и бэкэнд-сервисы, которые могут использоваться для других функций Google Cloud . Отключение всех этих сервисов может привести к неожиданным и непреднамеренным последствиям из-за зависимостей.

Однако при желании вы можете вручную отключить все API и удалить метку, ключ API и учетные записи служб , автоматически включенные и созданные при «добавлении Firebase» .

Внимание: Если вы решите вручную отключить и удалить то, что произошло во время добавления Firebase, делайте это с особой осторожностью. Вам необходимо быть абсолютно уверенным, что ваш проект Google Cloud и связанные с ним приложения не используют ничего , связанного с тем, что вы отключаете и удаляете; в противном случае ваш проект или приложение могут перестать работать или вести себя непредсказуемым образом.

Могу ли я заблокировать «добавление Firebase» для существующего проекта Google Cloud ?

Хотя вы фактически не можете заблокировать возможность «добавления Firebase» в существующий проект Google Cloud , вы можете сделать следующее:

Ограничьте круг участников проекта (т. е. участников), имеющих разрешение IAM firebase.projects.update , которое требуется для «добавления Firebase».

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

• Для получения дополнительной информации о проектах Firebase ознакомьтесь со следующими ресурсами:

  • Понимание проектов Firebase — краткий обзор нескольких важных концепций проектов Firebase, включая их связь с Google Cloud , а также базовую иерархию проекта, его приложений и ресурсов.

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

• Начните использовать Firebase в своих мобильных и веб-приложениях, зарегистрировав свои приложения в проекте Firebase и подключив их к Firebase: iOS+ | Android | Web | Flutter | Unity | C++ .