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 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 Cloudbả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ự ánmã 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 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.

  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.

  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ị.

  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 đó.

  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.

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

Để 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 đó.

Để "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.

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 cho các trường hợp sử dụng nâng cao).

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:

    • service-PROJECT_NUMBER@gcp-sa-firebase.iam.gserviceaccount.com
    • 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

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ẽ bật 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ả không mong muốn và ngoài dự kiế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ả 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".

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

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++.