Начните использовать 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 , gcloud CLI и любой ресурс Terraform от Google.

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

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

• Платежи за проект распределяются между Firebase и Google Cloud . Если в вашем проекте Google Cloud включена оплата, то ваш проект Firebase будет использовать тарифный план 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 ). Узнайте больше в этом FAQ .

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

Консоль Firebase

1. Перейдите в консоль Firebase .

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

3. Нажмите Создать проект .

4. В нижней части страницы нажмите ссылку « У вас уже есть проект Google Cloud?»

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

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

7. Если будет предложено, примите Условия Firebase .

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

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

Интерфейс командной строки Firebase

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

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

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

   firebase projects:addfirebase

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

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

ОТДЫХ API

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

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

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

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

Подробные инструкции см. в разделе «Добавление сервисов Firebase в ваш проект» руководства Firebase: «Настройка проекта Firebase и управление им с помощью Management 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 , 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 , REST API управления Firebase или 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
  • Cloud Pub/Sub 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». Чтобы сделать это эффективно, вы можете использовать политику запрета IAM .

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

• Чтобы узнать больше о проектах Firebase, посетите следующие ресурсы:

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

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

• Начните использовать Firebase в своих мобильных и веб-приложениях, зарегистрировав свои приложения в проекте Firebase и подключив их к Firebase: iOS+ | Андроид | Интернет | флаттер | Единство | С++ .