Điều kiện tiên quyết
- Tài khoản Harness có các organization, project và dữ liệu chi phí mà bạn muốn agent đọc.
- Quyền tạo service account và gán role binding. Để thử nghiệm nhanh cho cá nhân, có thể dùng API key của chính bạn.
- Identifier (không phải tên hiển thị) của organization hoặc project mặc định bạn muốn đặt.
- Vai trò Admin trong workspace CloudThinker, có quyền thêm và sửa kết nối. Xem Vai trò.
Thiết lập
1
Tạo service account
Trong Harness, mở Account Settings → Access Control → Service Accounts và tạo một service account tên
cloudthinker. Sau đó thêm role binding cho quyền chỉ đọc:Service account cấp account bao quát cả dữ liệu delivery của project lẫn dữ liệu chi phí cấp account.
2
Tạo token
Mở service account, chọn API Keys → API Key và lưu một key mới. Trong key đó, chọn Token, đặt ngày hết hạn và nhấn Generate Token.Sao chép token ngay. Token bắt đầu bằng
sat. và Harness chỉ hiển thị một lần. Key cá nhân từ My API Keys trong hồ sơ của bạn tạo token pat. theo cách tương tự.3
Thêm kết nối trong CloudThinker
Trên thanh bên, nhấn More → Workspace settings → Connections, giữ ở tab Builtin Connections và chọn Harness. Điền:
- API key: token bạn đã tạo
- Harness URL: giữ
https://app.harness.iotrừ khi bạn dùng cluster khác hoặc bản cài tự quản lý. Để tìm URL của bạn, đăng nhập Harness và sao chép scheme và host từ thanh địa chỉ trình duyệt, ví dụhttps://<your-host>. - Default organization và Default project: tùy chọn. Đặt cả hai hoặc để trống cả hai.
Chi tiết kết nối
Sao chép identifier chính xác như hiển thị trong cài đặt của tài nguyên trong Harness. Tên hiển thị như “Payments Team” sẽ không khớp.
Quyền yêu cầu
Token kế thừa quyền của service account hoặc user của nó. Cấp quyền xem cho mọi thứ agent cần kiểm tra:Khả năng của agent
Mọi thao tác tạo, cập nhật hoặc xóa đều đi qua Approvals.
Mọi thay đổi do agent thực hiện đều đi qua Approvals của workspace trước. Ở chế độ mặc định Auto · Rules + AI · Ask me, AI judgment có thể cho một thay đổi an toàn chạy mà không cần hỏi. Allow Rule cũng vậy, sau khi CloudThinker bật Rule enforcement cho workspace của bạn. Chọn Manual nếu bạn muốn tự phê duyệt mọi thay đổi.
Kết nối này không có công tắc Allow writes, nên để giữ chỉ đọc, chỉ cấp role xem cho token. Agent không thể chạy, chạy lại hoặc ngắt một pipeline execution, bật/tắt feature flag, sync GitOps application hay phê duyệt một Harness approval step. Các điều khiển đó không thuộc kết nối này.
Xác minh kết nối
Ví dụ prompt
Khắc phục sự cố
Yêu cầu báo cần phạm vi project
Yêu cầu báo cần phạm vi project
Tài nguyên cần cả identifier của organization và project. Đặt Default organization và Default project, hoặc yêu cầu agent liệt kê organization và project trước, rồi lặp lại yêu cầu với các identifier đó.
Không tìm thấy organization hoặc project
Không tìm thấy organization hoặc project
Bạn đã dùng tên hiển thị thay vì identifier. Sao chép identifier từ cài đặt của tài nguyên trong Harness.
Agent từ chối chạy hoặc chạy lại pipeline
Agent từ chối chạy hoặc chạy lại pipeline
Đây là thiết kế có chủ đích. Hãy chạy, chạy lại hoặc ngắt pipeline trong Harness. Agent vẫn có thể kiểm tra execution và chẩn đoán lý do 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.
- Ưu tiên service account thay vì key cá nhân: kết nối vẫn hoạt động khi quyền truy cập của một người thay đổi hoặc họ rời đi.
- Token có hạn: đặt ngày hết hạn cho token và thay thế trước khi hết hạn.
Liên quan
Kết nối CircleCI
Kiểm tra trạng thái pipeline và phân tích workflow lỗi.
Approvals
Kiểm soát thay đổi Harness nào phải chờ người duyệt.