Как начать работу с Firebase, используя существующий облачный проект Google Cloud

Проект Firebase – это проект Google Cloud, в котором включены дополнительные конфигурации и сервисы Firebase. Это часто называют "добавлением Firebase" в проект Google Cloud. На этой странице описано, как добавить Firebase, и приведены ответы на часто задаваемые вопросы.

Когда вы добавляете Firebase в проект Google Cloud, Firebase автоматически включает несколько API и создает сервисные аккаунты, чтобы упростить использование всех сервисов и интерфейсов Firebase. Firebase также добавляет ярлык firebase:enabled в ваш проект на странице IAM & Admin (IAM и администрирование) > Labels (Ярлыки) в консоли 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, так и в 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 в проект Google Cloud.

Консоль 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.

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

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

   firebase projects:addfirebase

4. Когда появится запрос, выберите существующий проект Google Cloud из списка.

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

REST API

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

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

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

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

Подробные инструкции вы найдете в разделе Add Firebase services to your project (Как добавить сервисы Firebase в проект) руководства по Firebase "Set up and manage a Firebase project using the Management REST API (Как настроить проект Firebase и управлять им с помощью Management REST API)". Обязательно следуйте всем инструкциям в разделе Подготовка этого руководства.

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

Terraform

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

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

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

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

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

Нужно ли принимать Условия использования Firebase, чтобы начать работу с этим сервисом?

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

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

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

• Примите Условия использования Firebase, следуя инструкциям.

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

• Откройте существующий проект Firebase в консоли Firebase и примите Условия использования Firebase (например, если вас пригласили стать участником проекта, то есть субъектом).

• Откройте существующий проект Google Cloud в консоли Firebase, нажмите Добавить Firebase и примите Условия использования Firebase.

Примечание. Принять Условия использования Firebase нельзя с помощью интерфейса командной строки Firebase, 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 не загружается список моих проектов Google Cloud?

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

Консоль Firebase не предназначена для загрузки многих тысяч проектов Google Cloud. Вместо этого рекомендуем добавить Firebase в существующий проект Google Cloud с помощью интерфейса командной строки Firebase, REST API или Terraform.

Также рекомендуем ознакомиться с ответом на вопрос Почему мой проект Firebase не показывается в списке проектов Firebase?

Достаточно ли добавить ярлык firebase:enabled, чтобы добавить Firebase?

У всех проектов Firebase есть ярлык firebase:enabled на странице IAM & Admin (IAM и администрирование) > Labels (Ярлыки) в консоли Google Cloud.

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

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

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

• Добавляет ярлык firebase:enabled на странице IAM & Admin (IAM и администрирование) > Labels (Ярлыки) в консоли Google Cloud.

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

• Создает следующие сервисные аккаунты:

  • [e-mail]
  • firebase-adminsdk-random5chars@PROJECT_ID.iam.gserviceaccount.com

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

  • App Engine Admin API
  • Cloud Pub/Sub API
  • Cloud Resource Manager API
  • Cloud Runtime Configuration API
  • Cloud Testing API
  • Firebase Cloud Messaging API
  • Firebase Dynamic Links API
  • Firebase Hosting API
  • Firebase Installations API
  • Firebase Management API
  • Firebase Remote Config API
  • Firebase Remote Config Realtime API
  • Firebase Rules API
  • Identity Toolkit API
  • Token Service 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 | Веб | Flutter | Unity | C++.