Điều kiện tiên quyết
- Một project Google Cloud mà bạn có quyền tạo service account và cấp IAM role.
-
Quyền tạo key cho service account. 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 năm 2024), hãy nhờ admin quản lý organization policy cấp ngoại lệ cho project này trước khi bắt đầu. Thay đổi policy có thể mất vài phút mới có hiệu lực. -
API của các dịch vụ bạn muốn hỏi phải được bật trong mọi project mà kết nối bao phủ. Agent sẽ nhận lỗi
API not enabledvới bất kỳ dịch vụ nào đang tắt. Bật API cần vai trò Service Usage Admin (roles/serviceusage.serviceUsageAdmin) hoặc Owner trên project. Bộ API thường dùng, bao gồm project, inventory, GKE, BigQuery, rà soát IAM, metric, log và Cloud Storage: - Vai trò Admin trong workspace CloudThinker, vai trò có quyền thêm và sửa kết nối. Xem Vai trò.
- Với câu hỏi về chi phí và Optimize: một bản export Standard usage cost của Cloud Billing sang BigQuery. Dataset export phải nằm cùng project với service account, vì Optimize chỉ đọc bảng billing trong project đã kết nối. Để tạo export, một Billing Account Administrator vào Billing → Billing export → BigQuery export, rồi trong mục Standard usage cost nhấn Edit settings. Xem hướng dẫn thiết lập của Google. Export mới có thể mất vài giờ mới có những hàng dữ liệu đầu tiên, nên Optimize có thể trống trong ngày đầu.
Thiết lập
Trước tiên, tạo service account trong Google Cloud, sau đó tải key của service account lên CloudThinker.- Google Cloud console
- gcloud CLI
1
Tạo service account
Trong Google Cloud console, chọn project và vào IAM & Admin → Service Accounts. Nhấn Create service account, đặt tên
cloudthinker-readonly, rồi nhấn Create and continue.2
Cấp role chỉ đọc
Thêm Viewer (
roles/viewer). Với Optimize, thêm cả BigQuery Job User (roles/bigquery.jobUser). Nhấn Done. Nếu tổ chức của bạn cấm các basic role như Viewer, hãy dùng các predefined role trong mục Quyền yêu cầu.3
Với Optimize: chia sẻ dataset billing
Vào BigQuery, chọn dataset billing export, rồi nhấn Sharing → Permissions → Add principal. Nhập email của service account, chọn BigQuery Data Viewer, rồi nhấn Save. Bỏ qua bước này nếu bạn không dùng Optimize.
4
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. File key chỉ tải xuống một lần và không thể tải lại.
1
Mở hộp thoại kết nối
Ở thanh bên, nhấn More → Workspace settings → Connections, chọn Google Cloud Platform, rồi nhấn Connect.
2
Đặt tên project
Điền Alias (ví dụ
prod-gcp) và Description (ví dụ Production GCP project, GKE workloads). Khi bạn có nhiều kết nối, agent đọc phần mô tả để chọn đúng kết nối.3
Tải key lên và chọn region
Kéo file JSON key vào GOOGLE_SERVICE_ACCOUNT_KEY, hoặc nhấn để chọn file. Chọn region chính của bạn từ danh sách GCP_DEFAULT_REGION. Mặc định là
us-central1. Nhấn Connect.Trạng thái thành công: trạng thái chuyển qua Connecting và Verifying, rồi project hiển thị trạng thái Connected. Lúc này Discovery chạy một lần ở chế độ nền và tiêu tốn credit. Hãy xem mục Discovery trên bảng chi tiết trước khi gửi prompt đầu tiên. Xem Điều gì xảy ra sau khi bạn kết nối.4
Đặt môi trường
Mở Google Cloud Platform trong More → Workspace settings → Connections, nhấn biểu tượng bút chì trên hàng của project, rồi đặt Environment trong Edit Instance. Trường này gắn nhãn project cho cả người dùng lẫn agent.
5
Đặt câu hỏi xác minh
Mở một cuộc chat và hỏi câu hỏi xác minh. Câu trả lời phải liệt kê đúng các project ID của bạn.
Kết nối thêm project
Dù bạn chọn cách nào, Optimize chỉ đọc billing từ project chứa key (
project_id của key). Kết nối theo từng project mà project đó không có billing export sẽ không có dữ liệu chi phí cho Optimize. Billing export bao phủ mọi project trên billing account của nó, vì vậy hãy đặt service account trong project chứa export, cấp Viewer trên folder hoặc organization, rồi kết nối một lần. Để cấp quyền trên folder, bạn cần Folder IAM Admin (roles/resourcemanager.folderIamAdmin). Để cấp quyền trên organization, bạn cần Organization Administrator (roles/resourcemanager.organizationAdmin):
Chi tiết kết nối
File key là JSON với các trường như
type, project_id, private_key và client_email. Hãy tải lên nguyên vẹn, không chỉnh sửa.
Environment (Production, Staging, Development hoặc Not set) không có trong hộp thoại kết nối. Hãy đặt sau khi kết nối, như ở các bước thiết lập: trường này gắn nhãn project cho cả người dùng lẫn agent. Rule phê duyệt không đọc trường này, nên Rule muốn áp dụng cho một project phải nêu tên kết nối đó.
Quyền yêu cầu
Nếu tổ chức của bạn cấm basic role, hãy cấp các predefined role chỉ đọc cho từng lĩnh vực bạn cần thay cho Viewer:
Khả năng của agent
Xác minh kết nối
Ví dụ prompt
Quyền ghi
Allow writes trên bảng chi tiết của kết nối quyết định agent có được thay đổi gì trong Google Cloud hay không. Tùy chọn này bật theo mặc định, nhưng service account chỉ có Viewer và các role đọc BigQuery thì không thay đổi được gì, nên Google Cloud sẽ từ chối mọi thao tác ghi cho đến khi bạn cấp thêm quyền.
Để khóa thao tác ghi ngay trong CloudThinker, mở More → Workspace settings → Connections, chọn Google Cloud Platform, rồi tắt công tắc Allow writes trên bảng chi tiết.
Khắc phục sự cố
Không tạo được key: tính năng tạo key đã bị tắt
Không tạo được key: tính năng tạo key đã bị tắt
Nguyên nhân: organization policy
constraints/iam.disableServiceAccountKeyCreation đang được áp dụng.Cách khắc phục: nhờ admin quản lý organization policy cho phép tạo key trên project này, hoặc tạo key giúp bạn. Nếu ngoại lệ đã được cấp, hãy chờ vài phút: thay đổi policy cần thời gian mới có hiệu lực. Đồng thời kiểm tra xem một policy đặt ở cấp thấp hơn, trên project hoặc folder chứa project, có còn áp dụng ràng buộc này không.File tải lên bị từ chối hoặc bài kiểm tra thất bại ngay
File tải lên bị từ chối hoặc bài kiểm tra thất bại ngay
Nguyên nhân: file không phải JSON key gốc. Các trường hợp thường gặp là key P12, một đoạn được sao chép, hoặc file đã bị chỉnh sửa và mất các dấu xuống dòng trong
private_key.Cách khắc phục: tạo JSON key mới và tải lên đúng file đã tải xuống, không chỉnh sửa.Agent nhận PERMISSION_DENIED hoặc 'API not enabled'
Agent nhận PERMISSION_DENIED hoặc 'API not enabled'
Kiểm tra: service account có role trên project bạn hỏi, và API của dịch vụ đó (ví dụ Compute Engine hoặc Kubernetes Engine) đã được bật trong project.Cách khắc phục: cấp Viewer trên project hoặc folder chứa project, hoặc bật API trong APIs & Services. Không cần kết nối lại: yêu cầu tiếp theo sẽ dùng quyền mới.
Optimize báo không tìm thấy billing export
Optimize báo không tìm thấy billing export
Nguyên nhân: Optimize cần một bảng export Standard usage cost của Cloud Billing (tên dạng
gcp_billing_export_v1_...) trong project đã kết nối.Cách khắc phục: bật export Standard usage cost trong Billing → Billing export, trỏ tới một dataset cùng project với service account. Nếu Optimize báo bảng nằm ngoài project đã kết nối, hãy chuyển export hoặc tạo service account trong project chứa export. Nếu Optimize yêu cầu chọn bảng, hãy chọn bảng bạn muốn Optimize dùng.Kiểm tra hiển thị Timed out
Kiểm tra hiển thị Timed out
Nguyên nhân: bài kiểm tra không hoàn tất kịp thời. Endpoint của Google Cloud là công khai, nên hiếm khi lỗi nằm ở mạng của bạn.Cách khắc phục: kết nối lại. Nếu vẫn tiếp tục hết thời gian chờ, hãy liên hệ với chúng tôi.
Kết nối hiển thị Error
Kết nối hiển thị Error
Nguyên nhân: key đã bị xóa hoặc vô hiệu hóa, hoặc một organization policy (
constraints/iam.serviceAccountKeyExpiryHours) đã làm key hết hạn.Cách khắc phục: tạo key mới, rồi mở kết nối và nhấn Replace credentials để tải key lên. Thao tác này mở Edit Instance, cùng hộp thoại với Replace…. Các tác vụ theo lịch chạy lại khi trạng thái trở về Connected.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.
- Xóa các bản sao key trên máy. Sau khi tải file JSON lên, hãy xóa file khỏi thư mục tải xuống hoặc lưu vào secret manager. Bất kỳ ai giữ file đều có quyền truy cập của service account.
- Xoay vòng ít nhất mỗi 90 ngày. Giới hạn thời hạn của key bằng policy
constraints/iam.serviceAccountKeyExpiryHours. Để xoay vòng, tạo key mới, nhấn biểu tượng bút chì trên hàng của project, tải key lên bằng Replace… trong Edit Instance, rồi xóa key cũ trong tab Keys của service account. Xem Xoay vòng thông tin xác thực.
Liên quan
Bắt đầu nhanh với Optimize
Biến billing export thành các phát hiện về chi phí và đề xuất tiết kiệm.
Kết nối
Xoay vòng thông tin xác thực, đặt môi trường và đọc kết quả Discovery.