Проект 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 с оплатой по мере использования 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 ). Узнайте больше в этом FAQ .
Консоль Firebase
Перейдите в консоль Firebase .
Войдите в систему с той же учетной записью Google, которая позволяет вам получить доступ к существующему проекту Google Cloud .
Нажмите Создать проект .
В нижней части страницы нажмите ссылку « У вас уже есть проект Google Cloud?»
В текстовом поле начните вводить идентификатор существующего проекта, а затем выберите проект из отображаемого списка.
Нажмите Открыть проект .
Если будет предложено, примите Условия Firebase .
Следуйте инструкциям на экране, чтобы «добавить Firebase» и настроить проект Firebase.
Обратите внимание, что включение Google Analytics не является обязательным.
Интерфейс командной строки Firebase
Если вы еще этого не сделали, установите Firebase CLI .
Войдите в систему с той же учетной записью Google, которая позволяет вам получить доступ к существующему проекту Google Cloud .
Выполните следующую команду:
firebase projects:addfirebase
При появлении запроса выберите существующий проект Google Cloud из отображаемого списка.
Если вы еще не приняли Условия Firebase , откройте проект Firebase в консоли Firebase чтобы принять Условия. Подробную информацию о требованиях к Условиям использования Firebase можно найти в этом разделе часто задаваемых вопросов .
ОТДЫХ API
Включите Firebase Management API в существующем проекте Google Cloud .
Создайте свой токен доступа к API.
Включите службы Firebase для проекта, вызвав
projects.addFirebase
.Обратите внимание, что для выполнения этого вызова вам понадобится имя ресурса вашего проекта.
Если вы еще не приняли Условия Firebase , откройте проект Firebase в консоли Firebase чтобы принять Условия. Подробную информацию о требованиях к Условиям использования Firebase можно найти в этом разделе часто задаваемых вопросов .
Подробные инструкции см. в разделе «Добавление сервисов Firebase в ваш проект» руководства Firebase: «Настройка проекта Firebase и управление им с помощью Management REST API». Обязательно следуйте всем инструкциям в разделе «Перед началом работы » этого руководства.
Терраформировать
Включите Firebase Management API (
firebase.googleapis.com
) в существующем проекте Google Cloud .Включите службы Firebase для проекта, используя ресурс
google_firebase_project
.Если вы еще не приняли Условия Firebase , откройте проект Firebase в консоли Firebase чтобы принять Условия. Подробную информацию о требованиях к Условиям использования Firebase можно найти в этом разделе часто задаваемых вопросов .
Подробную информацию об использовании Firebase и Terraform см. в разделе Начало работы с Terraform и Firebase .
Часто задаваемые вопросы и устранение неполадок
Чтобы получить доступ и использовать все возможности Firebase в проекте Google Cloud , вам необходимо принять Условия использования Firebase .
Вам нужно принять Условия Firebase только один раз для своей учетной записи Google, независимо от того, к скольким проектам у вас есть доступ. Принимая условия, вы принимаете их только в отношении своей учетной записи Google; принятие не происходит на уровне проекта для всех участников проекта.
Вы принимаете Условия Firebase, открывая проект Firebase в консоли Firebase и следуя инструкциям на экране.
Чтобы «добавить Firebase» в существующий проект Google Cloud , участник проекта (то есть руководитель) должен иметь следующие разрешения IAM:
-
firebase.projects.update
-
resourcemanager.projects.get
-
serviceusage.services.enable
-
serviceusage.services.get
Роли IAM «Редактор» и «Владелец» по умолчанию содержат эти разрешения.
Все проекты Firebase имеют метку firebase:enabled
на странице «Ярлыки» консоли Google Cloud .
Однако простое добавление метки firebase:enabled
вручную в список меток проекта НЕ включает конфигурации и сервисы, специфичные для Firebase, для вашего проекта Google Cloud . Для этого вам необходимо добавить Firebase с помощью консоли Firebase (или, для расширенных вариантов использования, с помощью интерфейса командной строки Firebase , REST API управления Firebase или 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-service-account@firebase-sa-management.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» в существующий проект Google Cloud , его нельзя будет отменить (то есть вы не сможете полностью «удалить Firebase» из проекта Google Cloud ).
Процесс «добавления Firebase» включает API и серверные службы, которые можно использовать для других функций Google Cloud . Отключение всех этих включенных служб может привести к неожиданным и непредвиденным последствиям из-за зависимостей.
Однако при желании вы можете вручную отключить все API и удалить метку, ключ API и учетные записи служб , автоматически включенные и созданные при «добавлении Firebase» .
Да, вы можете заблокировать возможность «добавления Firebase» в существующий проект Google Cloud . Вот несколько вариантов:
Заблокируйте включение API
firebase.googleapis.com
с помощью ограничения «Ограничить разрешенные API и сервисы Google Cloud» .Ограничьте количество участников проекта (то есть участников), имеющих разрешение IAM
firebase.projects.update
, необходимое для «добавления Firebase». Чтобы сделать это эффективно, вы можете использовать политику запрета IAM .
Следующие шаги
Чтобы узнать больше о проектах Firebase, посетите следующие ресурсы:
Понимание проектов Firebase — содержит краткие обзоры нескольких важных понятий о проектах Firebase, включая их связь с Google Cloud и базовую иерархию проекта, его приложений и ресурсов.
Общие рекомендации по настройке проектов Firebase — представлены общие рекомендации высокого уровня по настройке проектов Firebase и регистрации ваших приложений в проекте, чтобы у вас был четкий рабочий процесс разработки с использованием различных сред.
Начните использовать Firebase в своих мобильных и веб-приложениях, зарегистрировав свои приложения в проекте Firebase и подключив их к Firebase: iOS+ | Андроид | Интернет | флаттер | Единство | С++ .