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 đã bật một số cấu hình và dịch vụ dành riêng cho Firebase. Thao tác này thường được gọi là "thêm Firebase" vào 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 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 một thẻ firebase:enabled vào dự án của bạn trong trang Thẻ của bảng điều khiển Google Cloud. Tìm hiểu thêm thông tin chi tiết về những điều sẽ 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 cách sử dụng CLI Firebase, 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 từ cả Firebase và Google Cloud trong dự án.

• 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à thành viên dự án (tức là một đối tượng chính) có đối với dự án Google Cloud cũng sẽ áp dụng cho dự án Firebase (và ngược lại).

• Hoạt động thanh toán cho dự án được chia sẻ trên Firebase và Google Cloud. Nếu bạn bật tính năng thanh toán trên 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) Blaze 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ệ phân cấp tài nguyên áp dụng cho dự án Google Cloud (ví dụ: tổ chức, thư mục, v.v.) cũng sẽ áp dụng cho dự án Firebase.

• Thao tác xoá dự án sẽ xoá dự án đó trên Firebase và Google Cloud.

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

Cách thêm Firebase vào 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 bất kỳ tuỳ chọn nào sau đây. Đảm bảo rằng bạn có các quyền cần thiết để thêm Firebase vào dự án Google Cloud.

Xin lưu ý rằng sau khi bạn "thêm Firebase" vào một dự án Google Cloud hiện có, bạn không thể huỷ thao tác này (tức là bạn không thể hoàn toàn "xoá 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ả tính 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 Firebase trong Câu hỏi thường gặp này.

Bảng điều khiển Firebase

1. Chuyển đến bảng điều khiển Firebase.

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

3. Nhấp vào Tạo dự án.

4. Ở cuối trang, hãy nhấp vào đường liên kết Bạn đã có dự án trên Google Cloud?

5. Trong trường văn bản, hãy bắt đầu nhập mã dự án của dự án hiện có, sau đó chọn dự án trong danh sách hiển thị.

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

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

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

   Xin lưu ý rằng bạn không bắt buộc phải bật 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 hiển thị.

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ể bạn không có các quyền cần thiết 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 dịch vụ Firebase vào dự án của bạn trong hướng dẫn về 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ể bạn không có các quyền cần thiết hoặc bạn chưa chấp nhận Điều khoản dịch vụ của Firebase.

Terraform

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

2. Bật 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ể bạn không có các quyền cần thiết 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ả tính 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. Bạn cũng cần chấp nhận Điều khoản của Firebase để "thêm Firebase" vào dự án Google Cloud hiện có.

Bạn chỉ cần chấp nhận Điều khoản 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 các điều khoản đó cho Tài khoản Google của mình; việc chấp nhận không áp dụng ở 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 cách sử dụng bất kỳ tuỳ chọn nào sau đây. 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ụ: someone has invited you to become a project member (that is, a principal) on the project).

• 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 cách sử dụng CLI Firebase, API REST 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ý một phiên bản ngoại tuyến của Thoả thuận cấp cao của Google Cloud để sử dụng các dịch vụ Firebase cụ thể trong cùng một 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ụ Firebase đó và 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ụ Firebase đó.

Tôi cần có những quyền nào để "thêm Firebase"?

Để "thêm Firebase" vào dự án Google Cloud hiện có, thành viên dự án (tức là một người dùng chính) phải có các quyền IAM sau:

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

Theo mặc định, các vai trò IAM của Người chỉnh sửa và Chủ sở hữu sẽ 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. Để làm việc đó, bạn cần thêm Firebase bằng bảng điều khiển Firebase (hoặc sử dụng CLI Firebase, API REST Quản lý Firebase hoặc Terraform đối với các trường hợp sử dụng nâng cao).

Điều gì sẽ 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 đã bật một số cấu hình và dịch vụ dành riêng cho Firebase. 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 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á đó đố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
  • API Lượt cài đặt Firebase
  • API Quản lý Firebase
  • API Cấu hình từ xa Firebase
  • API theo thời gian thực của Cấu hình từ xa Firebase
  • API quy tắc Firebase
  • API Identity Toolkit
  • API Dịch vụ mã thông báo

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

Sau khi bạn "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ể hoàn toàn "xoá Firebase" khỏi dự án Google Cloud).

Quá trình "thêm Firebase" sẽ cho phép các API và dịch vụ phụ trợ có thể được sử dụng cho các tính năng Google Cloud khác. 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ả ngoài mong muốn và không lường trước được do các phần phụ thuộc.

Tuy nhiên, nếu muốn, bạn có thể tắt tất 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 thực hiện việc này một cách cực kỳ thận trọng. Bạn cần phải 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ỳ nội dung nào liên quan đến nội dung 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 cách không mong muốn.

Có thể chặn tính năng "thêm Firebase" cho dự án Google Cloud hiện có không?

Có, bạn có thể chặn khả năng "thêm Firebase" vào dự án Google Cloud hiện có. Dưới đây là một số tùy chọn:

• Chặn việc bật API firebase.googleapis.com bằng cách sử dụng quy tắc ràng buộc "Hạn chế các API và dịch vụ được phép của Google Cloud".

• Hạn chế các thành viên dự án (tức là các nguyên tắc) có quyền IAM firebase.projects.update. Đây là quyền cần thiết để "thêm Firebase". Bạn có thể sử dụng chính sách từ chối IAM để thực hiện việc này một cách hiệu quả.

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 về dự án Firebase, bao gồm cả mối quan hệ của các dự án này với Google Cloud và hệ phân cấp cơ bản của một dự án cũng như các ứng dụng và 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 dành cho thiết bị di động và web bằng cách đăng ký ứng dụng với dự án Firebase và kết nối ứng dụng với Firebase: iOS+ | Android | Web | Flutter | Unity | C++.