Проект Firebase — это проект Google Cloud , в котором включены некоторые дополнительные конфигурации и сервисы, специфичные для Firebase. Обычно это называется «добавлением Firebase» в проект Google Cloud . На этой странице описано , как «добавить Firebase» , а также приведены ответы на часто задаваемые вопросы (FAQ) .
При добавлении Firebase в проект Google Cloud , Firebase автоматически включает несколько API и создает учетные записи служб для упрощения использования всех сервисов и интерфейсов Firebase. Firebase также добавляет метку firebase:enabled к вашему проекту на странице IAM & Admin > Метки в консоли 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 будет использовать тарифный план 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
Войдите в консоль Firebase , используя учетную запись, которая предоставляет вам доступ к существующему проекту Google Cloud .
Нажмите кнопку, чтобы создать новый проект Firebase.
В нижней части страницы нажмите «Добавить Firebase в проект Google Cloud» .
В текстовом поле начните вводить название существующего проекта, а затем выберите проект из отображаемого списка.
Нажмите «Открыть проект» .
При появлении запроса примите Условия использования Firebase .
Следуйте инструкциям на экране, чтобы «добавить Firebase» и настроить проект Firebase.
Обратите внимание, что включение поддержки ИИ в консоли Firebase и Google Analytics является необязательным.
Firebase CLI
Если вы еще этого не сделали, установите Firebase CLI .
Войдите в систему, используя ту же учетную запись Google, которая предоставляет вам доступ к существующему проекту Google Cloud .
Выполните следующую команду:
firebase projects:addfirebase
При появлении запроса выберите существующий проект Google Cloud из отображаемого списка.
REST API
Включите API управления Firebase в существующем проекте Google Cloud .
Сгенерируйте свой токен доступа к API.
Включите службы Firebase для проекта, вызвав метод
projects.addFirebase.Обратите внимание, что для выполнения этого вызова вам потребуется имя ресурса вашего проекта.
Подробные инструкции см. в разделе «Добавление сервисов Firebase в ваш проект» в руководстве Firebase: «Настройка и управление проектом Firebase с помощью Management REST API». Обязательно следуйте всем инструкциям в разделе « Перед началом работы » этого руководства.
Терраформирование
Включите API управления Firebase (
firebase.googleapis.com) в существующем проекте Google Cloud .Включите службы Firebase для проекта, используя ресурс
google_firebase_project.
Подробную информацию об использовании Firebase и Terraform см. в разделе «Начало работы с Terraform и Firebase» .
Часто задаваемые вопросы и устранение неполадок
Для доступа ко всем возможностям Firebase и их использования в проекте Google Cloud необходимо принять Условия использования Firebase . Также необходимо принять Условия использования Firebase, чтобы «добавить Firebase» в существующий проект Google Cloud .
Принять условия использования Firebase для вашей учетной записи Google достаточно только один раз, независимо от количества проектов, к которым у вас есть доступ. Принимая условия, вы принимаете их для своей учетной записи Google ; принятие условий не распространяется на все проекты и не распространяется на всех участников проекта.
Вы можете принять Условия использования Firebase через консоль Firebase , используя любой из следующих способов. При появлении запроса примите Условия. Если вам не предлагается принять Условия использования Firebase, значит, вы уже их приняли.
Примите условия использования Firebase напрямую, используя процедуру принятия условий .
Создайте новый проект Firebase с помощью консоли Firebase , а затем примите условия использования Firebase.
Откройте существующий проект Firebase в консоли Firebase , а затем примите условия использования Firebase (например, вас пригласили стать участником проекта (то есть, руководителем)).
Откройте существующий проект Google Cloud в консоли 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 CLI, REST API или Terraform, чтобы «добавить Firebase» в ваш существующий проект Google Cloud .
Также, возможно, вам будет полезно ознакомиться с разделом часто задаваемых вопросов "Почему мой проект Firebase не отображается в списке проектов Firebase?".
Все проекты Firebase имеют метку firebase:enabled на странице IAM & Admin > Метки в консоли Google Cloud .
However, just manually adding the firebase:enabled label to your list of project labels does NOT enable Firebase-specific configurations and services for your Google Cloud project. To do that, you need to add Firebase using the Firebase console (or, for advanced use cases, using the Firebase CLI, Firebase Management REST API, or Terraform).
Проект Firebase — это проект Google Cloud , в котором включены некоторые дополнительные конфигурации и сервисы, специфичные для Firebase. Таким образом, при добавлении Firebase в существующий проект Google Cloud Firebase выполняет следующие действия для упрощения использования всех сервисов и интерфейсов Firebase:
Добавляет метку
firebase:enabledна страницу IAM & Admin > Метки в консоли 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 Cloud Resource Manager
- API конфигурации среды выполнения облака
- API облачного тестирования
- API Firebase Cloud Messaging
- API динамических ссылок Firebase
- API хостинга Firebase
- API установок Firebase
- API управления Firebase
- API удаленной конфигурации Firebase
- API Firebase Remote Config в реальном времени
- API правил Firebase
- API инструментария идентификации
- API службы токенов
После добавления Firebase в существующий проект Google Cloud это действие нельзя отменить (то есть, полностью удалить Firebase из проекта Google Cloud невозможно).
Процесс «добавления Firebase» активирует API и серверные службы, которые могут использоваться для других функций Google Cloud . Отключение всех этих активированных служб может привести к неожиданным и непредвиденным последствиям из-за зависимостей.
Однако, при желании, вы можете вручную отключить все API и удалить метку, ключ API и учетные записи служб , автоматически включенные и созданные при добавлении Firebase .
Хотя вы не можете напрямую исключить возможность «добавления Firebase» в существующий проект Google Cloud , вы можете сделать следующее:
Ограничьте количество участников проекта (то есть, субъектов), имеющих разрешение IAM firebase.projects.update , необходимое для "добавления Firebase".
Следующие шаги
Для получения дополнительной информации о проектах Firebase ознакомьтесь со следующими ресурсами:
Книга «Понимание проектов Firebase » содержит краткий обзор нескольких важных концепций, касающихся проектов Firebase, включая их взаимосвязь с Google Cloud , а также базовую иерархию проекта, его приложений и ресурсов.
Общие рекомендации по настройке проектов Firebase — содержит общие, высокоуровневые рекомендации по настройке проектов Firebase и регистрации ваших приложений в проекте, что позволит вам выстроить четкий рабочий процесс разработки с использованием различных сред.
Начните использовать Firebase в своих мобильных и веб-приложениях, зарегистрировав свои приложения в проекте Firebase и подключив их к Firebase: iOS+ | Android | Web | Flutter | Unity | C++ .