Chuyển đến nội dung chính
CloudThinker chạy Google Cloud CLI trên các project của bạn để trả lời câu hỏi về compute, GKE, BigQuery, lưu trữ, danh tính và chi phí. Bạn kết nối bằng JSON key của một service account, và các IAM role của service account đó quyết định agent truy cập được những gì.
Kết nối chỉ nhận JSON key của service account. Workload Identity Federation và impersonation không được hỗ trợ.

Đ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 enabled vớ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.
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.
Sau đó kết nối trong CloudThinker:
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

Rule phê duyệt áp dụng cho toàn bộ một kết nối, nên quyền cấp trên folder gộp cả project production lẫn dev sẽ nhận cùng một bộ rule cho tất cả. Hãy dùng mỗi project một kết nối khi chúng cần rule phê duyệt khác nhau.
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:
Viewer không thay đổi được gì, nên là điểm khởi đầu an toàn. Tuy vậy, Viewer đọc được cả dữ liệu lẫn cấu hình: trong BigQuery, Viewer đọc được mọi dataset còn giữ quyền đọc mặc định ở cấp project. Để agent không truy cập một dataset nhạy cảm, hãy gỡ quyền mặc định đó khỏi dataset, hoặc dùng custom role thay cho Viewer.

Khả năng của agent

Xác minh kết nối

Câu trả lời liệt kê đúng các project ID của bạn. Nếu cấp quyền trên folder hoặc organization, mọi project bên dưới đều phải xuất hiện.

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ố

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