Bắt đầu sử dụng Firebase với một dự án Google Cloud hiện có

Dự án Firebase là một dự án Google Cloud có một số cấu hình và dịch vụ bổ sung dành riêng cho Firebase được bật. Đây thường được gọi là "thêm Firebase" vào một dự án Google Cloud. Trang này mô tả cách "thêm Firebase", cùng với một số câu hỏi thường gặp (FAQ).

Khi bạn thêm Firebase vào một dự án Google Cloud, Firebase sẽ tự động bật một số API và tạo tài khoản dịch vụ để đơn giản hoá việc sử dụng tất cả các dịch vụ và giao diện của Firebase. Firebase cũng thêm nhãn firebase:enabled vào dự án của bạn trong trang Nhãn của bảng điều khiển Google Cloud. Tìm hiểu thêm thông tin chi tiết về điều gì xảy ra khi bạn "thêm Firebase".

Mối quan hệ giữa dự án Firebase và dự án Google Cloud

Vì dự án Firebase là một dự án Google Cloud:

• Bạn có thể truy cập và tương tác với dự án trong bảng điều khiển Firebase cũng như trong bảng điều khiển Google Cloud và Bảng điều khiển API của Google.

• Bạn có thể tương tác với dự án bằng FirebaseCLI, gcloud CLI và mọi tài nguyên Terraform của Google.

• Bạn có thể sử dụng các sản phẩm và API của cả Firebase và Google Cloud trong dự án.

• Các quyền và vai trò IAM cho dự án được chia sẻ trên Firebase và Google Cloud. Mọi quyền truy cập mà một thành viên dự án (tức là một pháp nhân) có đối với dự án Google Cloud của bạn cũng sẽ áp dụng cho dự án Firebase của bạn (và ngược lại).

• Thanh toán cho dự án được chia sẻ giữa Firebase và Google Cloud. Nếu bạn đã bật tính năng thanh toán cho dự án Google Cloud, thì dự án Firebase của bạn sẽ sử dụng Gói giá linh hoạt (trả tiền theo mức dùng) của Firebase.

• Giá trị nhận dạng duy nhất cho dự án (chẳng hạn như số dự án và mã dự án) được chia sẻ trên Firebase và Google Cloud.

• Mọi hệ thống phân cấp tài nguyên được áp dụng cho dự án Google Cloud của bạn (ví dụ: tổ chức, thư mục, v.v.) cũng sẽ áp dụng cho dự án Firebase của bạn.

• Khi bạn xoá dự án, dự án đó sẽ bị xoá trên cả Firebase và Google Cloud.

• Việc xoá hoặc sửa đổi một tài nguyên hoặc dữ liệu trong dự án sẽ áp dụng cho cả Firebase và Google Cloud.

Cách thêm Firebase vào một dự án Google Cloud hiện có

Bạn có thể "thêm Firebase" vào một dự án Google Cloud hiện có bằng cách sử dụng một trong các lựa chọn sau. Đảm bảo bạn có các quyền bắt buộc để thêm Firebase vào dự án Google Cloud.

Xin lưu ý rằng sau khi "thêm Firebase" vào một dự án Google Cloud hiện có, bạn sẽ không thể huỷ thao tác này (tức là bạn không thể xoá hoàn toàn "Firebase" khỏi dự án Google Cloud). Tìm hiểu thêm trong phần Câu hỏi thường gặp này.

Lưu ý: Để truy cập và sử dụng tất cả các chức năng của Firebase trong dự án Google Cloud, bạn cần chấp nhận Điều khoản dịch vụ của Firebase. Tìm hiểu thêm về yêu cầu đối với Điều khoản của Firebase trong phần Câu hỏi thường gặp này.

Firebase bảng điều khiển

1. Đăng nhập vào bảng điều khiển Firebase bằng tài khoản cấp cho bạn quyền truy cập vào dự án Google Cloud hiện có.

2. Nhấp vào nút này để tạo một dự án Firebase mới.

3. Ở cuối trang, hãy nhấp vào Thêm Firebase vào dự án Google Cloud.

4. Trong trường văn bản, hãy bắt đầu nhập tên dự án của dự án hiện có, rồi chọn dự án trong danh sách xuất hiện.

5. Nhấp vào Mở dự án.

6. Nếu được nhắc, hãy chấp nhận Điều khoản của Firebase.

7. Làm theo hướng dẫn trên màn hình để "thêm Firebase" và thiết lập một dự án Firebase.

   Xin lưu ý rằng bạn không bắt buộc phải bật tính năng trợ lý AI trong bảng điều khiển Firebase và Google Analytics.

Firebase CLI

1. Nếu bạn chưa cài đặt, hãy cài đặt CLI Firebase.

2. Đăng nhập bằng cùng một Tài khoản Google cho phép bạn truy cập vào dự án Google Cloud hiện có.

3. Chạy lệnh sau:

   firebase projects:addfirebase

4. Khi được nhắc, hãy chọn dự án Google Cloud hiện có trong danh sách xuất hiện.

Lưu ý: Nếu bạn gặp lỗi 403 PERMISSION_DENIED khi cố gắng "thêm Firebase" vào một dự án Google Cloud hiện có, thì có thể là do bạn không có các quyền bắt buộc hoặc bạn chưa chấp nhận Điều khoản dịch vụ của Firebase.

API REST

1. Bật Firebase Management API trong dự án Google Cloud hiện có.

2. Tạo mã thông báo truy cập API.

3. Bật các dịch vụ Firebase cho dự án bằng cách gọi projects.addFirebase.

   Xin lưu ý rằng bạn sẽ cần tên tài nguyên của dự án để thực hiện lệnh gọi này.

Để biết hướng dẫn chi tiết, hãy xem phần Thêm các dịch vụ Firebase vào dự án của bạn trong hướng dẫn của Firebase: "Thiết lập và quản lý dự án Firebase bằng Management REST API". Hãy nhớ làm theo tất cả hướng dẫn trong phần Trước khi bắt đầu của hướng dẫn đó.

Lưu ý: Nếu bạn gặp lỗi 403 PERMISSION_DENIED khi cố gắng "thêm Firebase" vào một dự án Google Cloud hiện có, thì có thể là do bạn không có các quyền bắt buộc hoặc bạn chưa chấp nhận Điều khoản dịch vụ của Firebase.

Terraform

1. Bật Firebase Management API (firebase.googleapis.com) trong dự án Google Cloud hiện có.

2. Bật các dịch vụ Firebase cho dự án bằng cách sử dụng tài nguyên google_firebase_project.

Để biết thông tin chi tiết về cách sử dụng Firebase và Terraform, hãy xem bài viết Bắt đầu sử dụng Terraform và Firebase.

Lưu ý: Nếu bạn gặp lỗi 403 PERMISSION_DENIED khi cố gắng "thêm Firebase" vào một dự án Google Cloud hiện có, thì có thể là do bạn không có các quyền bắt buộc hoặc bạn chưa chấp nhận Điều khoản dịch vụ của Firebase.

Câu hỏi thường gặp và cách khắc phục sự cố

Tôi có bắt buộc phải chấp nhận Điều khoản dịch vụ của Firebase để bắt đầu sử dụng Firebase không?

Để truy cập và sử dụng tất cả các chức năng của Firebase trong một dự án Google Cloud, bạn cần chấp nhận Điều khoản dịch vụ của Firebase. Bạn cũng cần chấp nhận Điều khoản của Firebase để "thêm Firebase" vào một dự án Google Cloud hiện có.

Bạn chỉ cần chấp nhận Điều khoản của Firebase một lần cho Tài khoản Google của mình, bất kể bạn có quyền truy cập vào bao nhiêu dự án. Khi chấp nhận các điều khoản, bạn chỉ chấp nhận cho Tài khoản Google của mình; việc chấp nhận không diễn ra ở cấp dự án cho tất cả thành viên dự án.

Bạn có thể chấp nhận Điều khoản của Firebase thông qua bảng điều khiển Firebase bằng một trong các cách sau. Khi được nhắc, hãy chấp nhận Điều khoản.

• Tạo một dự án Firebase mới bằng bảng điều khiển Firebase.

• Mở một dự án Firebase hiện có trong bảng điều khiển Firebase (ví dụ: có người đã mời bạn trở thành thành viên dự án (tức là một pháp nhân) trong dự án).

• Mở một Google Cloud hiện có trong bảng điều khiển Firebase rồi "thêm Firebase" vào đó.

Lưu ý: Bạn không thể chấp nhận Điều khoản của Firebase bằng CLI Firebase, REST API hoặc Terraform. Bạn chỉ có thể thực hiện việc này bằng bảng điều khiển Firebase.

Lưu ý quan trọng: Nếu bạn ký vào một phiên bản ngoại tuyến của Thoả thuận chính của Google Cloud để sử dụng các dịch vụ cụ thể của Firebase bằng cùng Tài khoản Google Cloud Platform, thì Điều khoản của Firebase sẽ không áp dụng cho việc bạn sử dụng các dịch vụ đó của Firebase, đồng thời các điều khoản ngoại tuyến sẽ điều chỉnh việc bạn sử dụng các dịch vụ đó của Firebase.

Bạn cần có những quyền nào để "thêm Firebase"?

Để "thêm Firebase" vào một dự án Google Cloud hiện có, một thành viên dự án (tức là một pháp nhân) phải có các quyền IAM sau đây:

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

Theo mặc định, vai trò Người chỉnh sửa và Chủ sở hữu trong IAM có các quyền này.

Việc thêm nhãn firebase:enabled có đủ để thêm Firebase không?

Tất cả dự án Firebase đều có nhãn firebase:enabled trong trang Nhãn của bảng điều khiển Google Cloud.

Tuy nhiên, việc chỉ thêm nhãn firebase:enabled vào danh sách nhãn dự án theo cách thủ công sẽ KHÔNG bật các cấu hình và dịch vụ dành riêng cho Firebase cho dự án Google Cloud của bạn. Để làm như vậy, bạn cần thêm Firebase bằng bảng điều khiển Firebase (hoặc, đối với các trường hợp sử dụng nâng cao, hãy dùng Firebase CLI, Firebase Management REST API hoặc Terraform).

Điều gì xảy ra khi bạn "thêm Firebase" vào một dự án Google Cloud hiện có?

Dự án Firebase là một dự án Google Cloud có một số cấu hình và dịch vụ bổ sung dành riêng cho Firebase được bật. Vì vậy, khi bạn "thêm Firebase" vào một dự án Google Cloud hiện có, Firebase sẽ thực hiện các thao tác sau để đơn giản hoá việc sử dụng tất cả các dịch vụ và giao diện của Firebase:

• Thêm nhãn firebase:enabled trong trang Nhãn của bảng điều khiển Google Cloud.

• Tạo khoá API "Trình duyệt" và tự động hạn chế khoá này đối với các API liên quan đến Firebase.

• Tạo các tài khoản dịch vụ sau:

  • [e-mail]
  • firebase-adminsdk-random5chars@PROJECT_ID.iam.gserviceaccount.com

• Bật các API sau:

  • App Engine Admin API
  • Cloud Pub/Sub API
  • Cloud Resource Manager API
  • Cloud Runtime Configuration API
  • Cloud Testing API
  • API Gửi thông báo qua đám mây của Firebase
  • API Đường liên kết động của Firebase
  • Firebase Hosting API
  • Firebase Installations API
  • API Quản lý Firebase
  • Firebase Remote Config API
  • Firebase Remote Config Realtime API
  • Firebase Rules API
  • Identity Toolkit API
  • Token Service API

Tôi có thể "xoá Firebase" khỏi một dự án không?

Sau khi "thêm Firebase" vào một dự án Google Cloud hiện có, bạn sẽ không thể huỷ thao tác này (tức là bạn không thể xoá hoàn toàn "Firebase" khỏi dự án Google Cloud).

Quy trình "thêm Firebase" cho phép các API và dịch vụ phụ trợ có thể được dùng cho các tính năng khác của Google Cloud. Việc tắt tất cả các dịch vụ đã bật này có thể gây ra những hậu quả không mong muốn và ngoài ý muốn do các phần phụ thuộc.

Tuy nhiên, nếu muốn, bạn có thể tắt tất cả các API theo cách thủ công và xoá nhãn, khoá API và tài khoản dịch vụ được bật và tạo tự động khi bạn "thêm Firebase".

Cảnh báo: Nếu bạn chọn tắt và xoá thủ công những gì đã xảy ra trong quá trình "thêm Firebase", hãy hết sức thận trọng. Bạn cần hoàn toàn chắc chắn rằng dự án Google Cloud và các ứng dụng liên kết với dự án đó không sử dụng bất kỳ thứ gì liên quan đến những gì bạn đang tắt và xoá; nếu không, dự án hoặc ứng dụng của bạn có thể ngừng hoạt động hoặc hoạt động theo những cách không mong muốn.

Tôi có thể chặn thao tác "thêm Firebase" cho một dự án Google Cloud hiện có không?

Mặc dù không thể chặn khả năng "thêm Firebase" vào một dự án Google Cloud hiện có, nhưng bạn có thể làm như sau:

Giới hạn số lượng thành viên dự án (tức là các thực thể) có quyền IAM firebase.projects.update. Đây là quyền bắt buộc để "thêm Firebase".

Các bước tiếp theo

• Hãy xem các tài nguyên sau để tìm hiểu thêm về dự án Firebase:

  • Tìm hiểu về các dự án Firebase – cung cấp thông tin tổng quan ngắn gọn về một số khái niệm quan trọng liên quan đến các dự án Firebase, bao gồm cả mối quan hệ của các dự án này với Google Cloud cũng như hệ thống phân cấp cơ bản của một dự án và các ứng dụng cũng như tài nguyên của dự án đó.

  • Các phương pháp hay nhất chung để thiết lập dự án Firebase – cung cấp các phương pháp hay nhất chung, cấp cao để thiết lập dự án Firebase và đăng ký ứng dụng của bạn với một dự án để bạn có quy trình phát triển rõ ràng sử dụng các môi trường riêng biệt.

• Bắt đầu sử dụng Firebase trong ứng dụng di động và ứng dụng web bằng cách đăng ký ứng dụng với dự án Firebase và kết nối các ứng dụng đó với Firebase: iOS+ | Android | Web | Flutter | Unity | C++.