Проект 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 будет использовать тарифный план 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 (например, кто-то пригласил вас стать участником проекта (то есть, руководителем)).
Откройте существующий аккаунт Google Cloud в консоли 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 на странице «Метки» в консоли Google Cloud .
Однако простое добавление метки firebase:enabled вручную в список меток проекта НЕ включает специфические для Firebase конфигурации и сервисы для вашего проекта Google Cloud . Для этого необходимо добавить Firebase с помощью консоли Firebase (или, в более сложных случаях, с помощью Firebase CLI, Firebase Management REST API или Terraform).
Проект 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 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++ .