Chọn Firebase hay Google Cloud
Hai kết nối này độc lập với nhau. Bạn có thể kết nối cả hai cho cùng một project, mỗi kết nối một service account riêng.
Điều kiện tiên quyết
- Một project Firebase mà bạn muốn CloudThinker kiểm tra.
- Quyền trong Google Cloud của project đó để tạo service account và key, và gán IAM role.
- Cho phép tạo service account key. Nếu tổ chức của bạn áp dụng
constraints/iam.disableServiceAccountKeyCreation(mặc định trên các tổ chức tạo từ tháng 5/2024), hãy nhờ organization policy admin cấp ngoại lệ cho project này trước.
Thiết lập
Trước tiên, hãy quyết định cách bao quát nhiều project. Phần lớn các đội dùng mỗi project một kết nối.- Google Cloud console
- gcloud CLI
1
Tạo service account riêng
Trong Google Cloud console, chọn project Firebase và vào IAM & Admin → Service Accounts. Nhấn Create service account, đặt tên
cloudthinker-firebase, rồi nhấn Create and continue.2
Cấp role Firebase chỉ đọc
Thêm Firebase Viewer (
roles/firebase.viewer) và nhấn Done. Chỉ thêm role ghi nếu bạn muốn CloudThinker tạo ứng dụng hoặc deploy thông qua phê duyệt của bạn. Xem Quyền yêu cầu.3
Tạo JSON key
Mở service account, vào tab Keys, rồi nhấn Add key → Create new key. Chọn JSON và nhấn Create.Trạng thái thành công: trình duyệt tải xuống một file key
.json.1
Mở hộp thoại kết nối
Trên thanh bên, nhấn More → Workspace settings → Connections, chọn Firebase, rồi nhấn Connect.
2
Đặt tên kết nối
Điền Alias (ví dụ
prod-firebase) và Description (ví dụ Production Firebase project, mobile app). Agent đọc phần mô tả để chọn đúng kết nối khi bạn có nhiều kết nối.3
Tải key lên
Kéo file
.json vào vùng tải lên, hoặc nhấn choose a JSON file để chọn file. Nhấn Connect.Trạng thái thành công: kết nối hiển thị Connected, và project_id của key là project đang hoạt động. Sau đó bước khám phá chạy một lần ở chế độ nền và tiêu tốn credit. Bước này không bao giờ chờ phê duyệt, nên bỏ qua việc chuyển project và kiểm tra trạng thái deploy. Xem Điều gì xảy ra sau khi kết nối.4
Đặt environment
Mở Firebase trong More → Workspace settings → Connections, nhấn biểu tượng bút chì trên dòng của kết nối, rồi đặt Environment trong Edit Instance. Trường này gắn nhãn cho kết nối để người và agent dễ nhận biết.
Chi tiết kết nối
Bạn không cần project ID riêng hay file cấu hình Firebase. Để bao quát nhiều project, xem các lựa chọn trong Thiết lập.
Quyền yêu cầu
Google yêu cầu thêm role cho một số loại deploy. Ví dụ, deploy Cloud Functions cần thêm Cloud Functions Developer (
roles/cloudfunctions.developer) và Service Account User (roles/iam.serviceAccountUser).
Khả năng của agent
CloudThinker dùng bộ công cụ Firebase CLI chính thức (firebase-tools) qua kết nối này.
Kết nối bao gồm những gì
firebase-tools cung cấp. Kết nối không đọc document Firestore, user của Authentication, Crashlytics hay Remote Config.
Xác minh kết nối
project_id thật của bạn là project đang hoạt động.
Ví dụ prompt
Khắc phục sự cố
Xác thực thất bại hoặc thông tin xác thực không khả dụng
Xác thực thất bại hoặc thông tin xác thực không khả dụng
Nguyên nhân: JSON key không hợp lệ, không đầy đủ, hoặc thuộc về một service account đã bị xóa.Cách sửa: tạo JSON key mới cho service account. Trong More → Workspace settings → Connections, mở Firebase, nhấn biểu tượng bút chì trên dòng của kết nối, rồi dùng Replace… trong Edit Instance để tải key lên.
CloudThinker báo chưa chọn project đang hoạt động
CloudThinker báo chưa chọn project đang hoạt động
Nguyên nhân: lỗi ghi
PRECONDITION_FAILED và nhắc tới project đang hoạt động. CloudThinker đặt project đang hoạt động từ project_id của key mỗi khi kết nối khởi động. Nếu không đọc được key đã lưu, ví dụ vì key bị sửa trước khi tải lên, sẽ không có project nào được chọn. Tài nguyên không hề bị thiếu.Cách sửa: với prompt này, hãy nêu tên project. Việc chuyển project đang hoạt động đi qua phê duyệt của bạn. Để sửa hẳn, hãy tạo JSON key mới và tải nguyên file đã tải xuống, không chỉnh sửa, bằng Replace… trong Edit Instance.Bị từ chối quyền trên project, rules hoặc deploy
Bị từ chối quyền trên project, rules hoặc deploy
Nguyên nhân: service account thiếu IAM role cho sản phẩm Firebase đó, hoặc không nhìn thấy project.Cách sửa: trong Google Cloud console → IAM, cấp Firebase Viewer cho thao tác đọc và rules, hoặc Firebase Admin (hay role hẹp hơn trong Quyền yêu cầu) cho thao tác tạo và deploy. Sau đó thử lại.
Một project không xuất hiện trong danh sách project
Một project không xuất hiện trong danh sách project
Nguyên nhân: service account không có role nào trong project đó.Cách sửa: trong Google Cloud console → IAM của project đó, cấp cho service account role Firebase Viewer (
roles/firebase.viewer), rồi hỏi lại.Bước kiểm tra hiển thị Timed out
Bước kiểm tra hiển thị Timed out
Nguyên nhân: bước kiểm tra không hoàn tất kịp thời. Endpoint của Firebase là công khai, nên hiếm khi do mạng của bạn.Cách sửa: kết nối lại. Nếu vẫn tiếp tục timeout, hãy liên hệ chúng tôi.
Thao tác tạo hoặc deploy không chạy
Thao tác tạo hoặc deploy không chạy
Nguyên nhân: thao tác ghi cần cả IAM role cho phép lẫn phê duyệt trong CloudThinker. Nếu bạn đã từ chối yêu cầu, CloudThinker sẽ không thử lại.Cách sửa: kiểm tra role của service account, rồi hỏi lại.
Bảo mật
- Quyền tối thiểu — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
- Chỉ đọc theo mặc định — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
- Xoay vòng thông tin xác thực — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
- Thu hồi khi bàn giao — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.
- Bảo vệ key: JSON key là thông tin xác thực đầy đủ của service account. Xóa bản sao cục bộ sau khi tải lên, và không bao giờ commit hay dán key vào chat.
- Xoay vòng key ít nhất mỗi 90 ngày: tạo key mới, tải lên bằng Replace… trong Edit Instance, rồi xóa key cũ. Xem Xoay vòng thông tin xác thực.
Liên quan
Kết nối Google Cloud
Kết nối phần còn lại của project Google Cloud.
Approvals
Kiểm soát cách các thao tác cần phê duyệt được quyết định.