기존 Google Cloud 프로젝트에서 Firebase 사용 시작하기

Firebase 프로젝트는 Firebase 관련 구성 및 서비스가 추가로 사용 설정된 Google Cloud 프로젝트입니다. 이를 Google Cloud 프로젝트에 'Firebase 추가'라고 합니다. 이 페이지에서는 'Firebase를 추가'하는 방법과 몇 가지 자주 묻는 질문(FAQ)을 설명합니다.

Google Cloud 프로젝트에 Firebase를 추가하면 Firebase에서 여러 API를 자동으로 사용 설정하고 서비스 계정을 만들어 모든 Firebase 서비스와 인터페이스를 간편하게 사용할 수 있도록 합니다. 또한 Firebase는 Google Cloud 콘솔의 라벨 페이지 내에서 프로젝트에 firebase:enabled 라벨을 추가합니다. 'Firebase를 추가'하면 어떻게 되는지 자세히 알아보세요.

Firebase 프로젝트와 Google Cloud 프로젝트 간의 관계

Firebase 프로젝트는 Google Cloud 프로젝트이므로 다음이 적용됩니다.

Google Cloud 콘솔, Google API 콘솔뿐 아니라 Firebase Console에서도 프로젝트에 액세스하고 상호작용할 수 있습니다.
Firebase CLI, gcloud CLI, Google의 Terraform 리소스를 사용하여 프로젝트와 상호작용할 수 있습니다.
프로젝트에서 Firebase와 Google Cloud의 제품 및 API를 모두 사용할 수 있습니다.
프로젝트의 IAM 권한과 역할은 Firebase 및 Google Cloud에서 공유됩니다. 프로젝트 구성원(즉, 주 구성원)에게 Google Cloud 프로젝트에 대한 액세스 권한이 있으면 Firebase 프로젝트에도 적용되며 그 반대의 경우도 마찬가지입니다.
프로젝트의 결제는 Firebase 및 Google Cloud에서 공유됩니다. Google Cloud 프로젝트에 결제가 사용 설정되어 있으면 Firebase 프로젝트에 Firebase의 사용한 만큼만 지불하는 Blaze 요금제가 적용됩니다.
프로젝트의 고유 식별자(예: 프로젝트 번호 및 프로젝트 ID)가 Firebase와 Google Cloud에서 공유됩니다.
Google Cloud 프로젝트에 적용된 모든 리소스 계층 구조(예: 조직, 폴더 등)는 Firebase 프로젝트에도 적용됩니다.
프로젝트를 삭제하면 Firebase와 Google Cloud 양쪽에서 삭제됩니다.
프로젝트 내에서 리소스 또는 데이터를 삭제하거나 수정하면 Firebase 및 Google Cloud 전체에 적용됩니다.

기존 Google Cloud 프로젝트에 Firebase를 추가하는 방법

다음 옵션 중 하나를 사용하여 기존 Google Cloud 프로젝트에 'Firebase를 추가'할 수 있습니다. Google Cloud 프로젝트에 Firebase를 추가하는 데 필요한 권한이 있는지 확인합니다.

기존 Google Cloud 프로젝트에 'Firebase를 추가'하면 실행취소할 수 없습니다. 즉, Google Cloud 프로젝트에서 완전히 'Firebase를 삭제'할 수 없습니다. 이 FAQ에서 자세히 알아보세요.

Firebase 콘솔

기존 Google Cloud 프로젝트에 액세스할 수 있는 계정으로 Firebase Console에 로그인합니다.
버튼을 클릭하여 새 Firebase 프로젝트를 만듭니다.
페이지 하단에서 Google Cloud 프로젝트에 Firebase 추가를 클릭합니다.
텍스트 필드에 기존 프로젝트의 프로젝트 ID를 입력한 다음 표시되는 목록에서 프로젝트를 선택합니다.
프로젝트 열기를 클릭합니다.
메시지가 표시되면 Firebase 약관에 동의합니다.
화면에 표시된 안내에 따라 'Firebase를 추가'하고 Firebase 프로젝트를 설정합니다.

Firebase Console 및 Google Analytics에서 AI 어시스턴스를 사용 설정하는 것은 선택사항입니다.

Firebase CLI

아직 설치하지 않았으면 Firebase CLI를 설치합니다.
기존 Google Cloud 프로젝트에 액세스할 수 있는 동일한 Google 계정으로 로그인합니다.
다음 명령어를 실행합니다.
```
firebase projects:addfirebase
```
메시지가 표시되면 표시된 목록에서 기존 Google Cloud 프로젝트를 선택합니다.

REST API

기존 Google Cloud 프로젝트에서 Firebase Management API를 사용 설정합니다.
API 액세스 토큰을 생성합니다.
projects.addFirebase를 호출하여 프로젝트에 Firebase 서비스를 사용 설정합니다.

이 호출을 실행하려면 프로젝트의 리소스 이름이 필요합니다.

자세한 내용은 Firebase 가이드의 프로젝트에 Firebase 서비스 추가 섹션의 'Management REST API를 사용하여 Firebase 프로젝트 설정 및 관리'를 참조하세요. 가이드의 시작하기 전에 섹션에 있는 모든 안내를 따르세요.

Terraform

기존 Google Cloud 프로젝트에서 Firebase Management API(firebase.googleapis.com)를 사용 설정합니다.
google_firebase_project 리소스를 사용하여 프로젝트에 Firebase 서비스를 사용 설정합니다.

Firebase 및 Terraform 사용에 관한 자세한 내용은 Terraform 및 Firebase 시작하기를 참조하세요.

FAQ 및 문제 해결

Firebase를 사용하려면 Firebase 서비스 약관에 동의해야 하나요?

Google Cloud 프로젝트에서 Firebase의 모든 기능에 액세스하고 이를 사용하려면 Firebase 서비스 약관에 동의해야 합니다. 또한 기존 Google Cloud 프로젝트에 'Firebase를 추가'하려면 Firebase 약관에 동의해야 합니다.

액세스할 수 있는 프로젝트의 수와 관계없이 Google 계정에 대해 Firebase 약관에 한 번만 동의하면 됩니다. 약관에 동의하면 Google 계정에 대해서만 동의하는 것이며 모든 프로젝트 구성원의 프로젝트 수준에서는 동의하는 것이 아닙니다.

다음 옵션 중 하나를 사용하여 Firebase Console을 통해 Firebase 약관에 동의할 수 있습니다. 메시지가 표시되면 약관에 동의합니다.

Firebase Console을 사용하여 새 Firebase 프로젝트를 만듭니다.
Firebase Console에서 기존 Firebase 프로젝트를 엽니다(예: 누군가 나를 프로젝트의 프로젝트 구성원(즉, 프로젝트의 주 구성원)으로 초대함).
Firebase Console에서 기존 Google Cloud를 열고 'Firebase 추가'를 실행합니다.

'Firebase 추가'에 필요한 권한은 무엇인가요?

기존 Google Cloud 프로젝트에 'Firebase를 추가'하려면 프로젝트 구성원(즉, 주 구성원)에게 다음 IAM 권한이 있어야 합니다.

firebase.projects.update
resourcemanager.projects.get
serviceusage.services.enable
serviceusage.services.get

편집자 및 소유자의 IAM 역할에는 기본적으로 이러한 권한이 포함되어 있습니다.

Firebase Console에서 기존 Google Cloud 프로젝트 목록을 로드하지 못하는 이유는 무엇인가요?

이 FAQ는 Firebase Console을 사용하여 기존 Google Cloud 프로젝트에 'Firebase를 추가'하려고 할 때 수천 개의 Google Cloud 프로젝트에 액세스할 수 있는 경우에 가장 자주 적용됩니다.

Firebase Console은 수천 개의 Google Cloud 프로젝트를 로드하도록 설계되지 않았습니다. 대신 Firebase CLI, REST API 또는 Terraform을 사용하여 기존 Google Cloud 프로젝트에 'Firebase를 추가'하는 것이 좋습니다.

또한 '내 Firebase 프로젝트가 Firebase 프로젝트 목록에 표시되지 않는 이유는 무엇인가요?'라는 FAQ를 검토하는 것이 좋습니다.

`firebase:enabled` 라벨을 추가하면 Firebase를 추가할 수 있나요?

모든 Firebase 프로젝트에는 Google Cloud 콘솔의 라벨 페이지 내에 firebase:enabled 라벨이 있습니다.

그러나 프로젝트 라벨 목록에 firebase:enabled 라벨을 수동으로 추가한다고 해서 Google Cloud 프로젝트에 Firebase 관련 구성 및 서비스가 사용 설정되지는 않습니다. 이를 사용 설정하려면 Firebase Console을 사용하여 Firebase를 추가해야 합니다(고급 사용 사례의 경우 Firebase CLI, Firebase Management REST API 또는 Terraform 사용).

기존 Google Cloud 프로젝트에 'Firebase를 추가'하면 어떻게 되나요?

Firebase 프로젝트는 Firebase 관련 구성 및 서비스가 추가로 사용 설정된 Google Cloud 프로젝트입니다. 따라서 기존 Google Cloud 프로젝트에 'Firebase를 추가'하면 Firebase에서 다음 작업을 실행하여 모든 Firebase 서비스와 인터페이스의 사용을 간소화합니다.

Google Cloud 콘솔의 라벨 페이지 내에 firebase:enabled 라벨을 추가합니다.
'브라우저' API 키를 만들고 Firebase 관련 API로 자동 제한합니다.
다음 서비스 계정을 만듭니다.
- service-PROJECT_NUMBER@gcp-sa-firebase.iam.gserviceaccount.com
- 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 동적 링크 API
- Firebase 호스팅 API
- Firebase Installations API
- Firebase Management API
- Firebase 원격 구성 API
- Firebase 원격 구성 실시간 API
- Firebase Rules API
- Identity Toolkit API
- Token Service API

프로젝트에서 'Firebase를 삭제'할 수 있나요?

기존 Google Cloud 프로젝트에 'Firebase를 추가'한 후에는 실행취소할 수 없습니다. 즉, Google Cloud 프로젝트에서 완전히 'Firebase를 삭제'할 수 없습니다.

'Firebase 추가' 프로세스를 통해 다른 Google Cloud 기능에 사용할 수 있는 API와 백엔드 서비스가 사용 설정됩니다. 사용 설정된 이러한 모든 서비스를 사용 중지하면 종속 항목으로 인해 예상치 못한 결과가 발생할 수 있습니다.

하지만 원하는 경우 모든 API를 수동으로 사용 중지하고 'Firebase를 추가'할 때 자동으로 사용 설정되고 생성된 라벨, API 키, 서비스 계정을 삭제할 수 있습니다.

기존 Google Cloud 프로젝트에서 'Firebase 추가'를 차단할 수 있나요?

기존 Google Cloud 프로젝트에 'Firebase를 추가'하는 것을 실제로 차단할 수는 없지만 다음 작업을 할 수 있습니다.

'Firebase 추가'에 필요한 IAM 권한 firebase.projects.update를 가진 프로젝트 구성원(즉, 주 구성원)을 제한합니다.

다음 단계

Firebase 프로젝트에 대해 자세히 알아보려면 다음 리소스를 확인하세요.
- Firebase 프로젝트 이해 - Google Cloud와의 관계, 프로젝트와 앱 및 리소스의 기본 계층 구조 등 Firebase 프로젝트에 관한 몇 가지 중요한 개념을 간략히 설명합니다.
- Firebase 프로젝트 설정을 위한 일반적인 권장사항 - Firebase 프로젝트를 설정하고 프로젝트에 앱을 등록하는 일반적인 권장사항을 간략히 설명합니다. 이 내용을 토대로 고유한 환경을 사용하는 개발 워크플로를 명확하게 이해할 수 있습니다.
Firebase 프로젝트에 앱을 등록하고 Firebase에 연결하여 모바일 및 웹 앱에서 Firebase를 사용해 보세요. iOS+ | Android | 웹 | Flutter | Unity | C++