Điều kiện tiên quyết
- Máy chủ Argo CD mà CloudThinker truy cập được qua HTTPS. Địa chỉ
localhosthoặc địa chỉ nội bộ trong cluster sẽ không hoạt động. - Quyền admin trên Argo CD, để bạn tạo tài khoản local và sinh token cho tài khoản đó.
- Argo CD CLI trên máy của bạn để sinh token.
- Chỉ với bản tự lưu trữ: quyền
kubectlvào namespaceargocd, để sửa ConfigMapargocd-cmvàargocd-rbac-cm.
Thiết lập
Hãy tạo một tài khoảncloudthinker riêng thay vì dùng admin. Khi đó token chỉ mang đúng các quyền RBAC bạn cấp, và bạn có thể thu hồi token mà không ảnh hưởng đến ai khác.
- Argo CD tự lưu trữ
- Akuity Platform
1
Tạo tài khoản local có quyền dùng API key
Thêm tài khoản
cloudthinker chỉ dùng được API key, không đăng nhập được giao diện web:2
Sinh token
Đăng nhập bằng tài khoản admin, rồi sinh token cho tài khoản mới:Sao chép token. Chỉ thêm
--insecure vào cả hai lệnh khi máy chủ dùng chứng chỉ tự ký. Nếu không có --expires-in, token sẽ không bao giờ hết hạn, vì vậy hãy đặt thời hạn và sinh token mới trước khi token cũ hết hạn.Trạng thái thành công: lệnh thứ hai in ra một chuỗi token dài.3
Cấp quyền đọc cho tài khoản
Chạy Hãy sửa ConfigMap hiện có thay vì apply một ConfigMap mới.
kubectl -n argocd edit configmap argocd-rbac-cm và thêm các dòng sau vào policy.csv hiện có:kubectl apply với một argocd-rbac-cm mới sẽ thay thế toàn bộ policy của bạn và có thể khóa người dùng khác. Để agent được phép thay đổi, hãy thêm các dòng trong mục Quyền yêu cầu.4
Thêm kết nối trong CloudThinker
Mở More → Workspace settings → Connections, giữ nguyên tab Builtin Connections, rồi chọn ArgoCD. Điền:
- ARGOCD_BASE_URL: địa chỉ máy chủ, ví dụ
https://argocd.example.com - ARGOCD_API_TOKEN: token bạn đã sao chép
- NODE_TLS_REJECT_UNAUTHORIZED (xác minh TLS): Verify TLS (default), hoặc Skip TLS verification nếu dùng chứng chỉ tự ký
- READ_ONLY: đổi thành Read-only. Biểu mẫu mặc định là Full access.
Chi tiết kết nối
Quyền yêu cầu
Các dòng quyền đọc ở bước thiết lập đã bao quát mọi thao tác đọc:applications, get cho phép đọc trạng thái ứng dụng, resource tree, tài nguyên được quản lý và event, còn logs, get cho phép agent đọc log của pod. Thêm một dòng cho mỗi loại thay đổi bạn muốn agent đề xuất:
Khả năng của agent
Mọi thay đổi đều đi qua Approvals, và yêu cầu bị từ chối sẽ không được thử lại. Để agent được sync, hãy đặt READ_ONLY thành Full access và thêm quyền
applications, sync. Thiếu một trong hai, agent chỉ đọc được.
Xác minh kết nối
Ví dụ prompt
applications, sync.
Khắc phục sự cố
Connect fails with fetch failed
Connect fails with fetch failed
CloudThinker không truy cập được ARGOCD_BASE_URL, hoặc chứng chỉ của máy chủ bị từ chối. Kiểm tra địa chỉ là HTTPS công khai, không phải
localhost hay tên nội bộ trong cluster. Với chứng chỉ tự ký, đặt NODE_TLS_REJECT_UNAUTHORIZED thành Skip TLS verification.Yêu cầu trả về 401
Yêu cầu trả về 401
Token bị thiếu, đã hết hạn, hoặc được sinh cho một tài khoản khác. Chạy lại
argocd account generate-token --account cloudthinker --expires-in 90d, sửa kết nối và dán token mới.Permission denied (code 7)
Permission denied (code 7)
Vai trò RBAC của tài khoản không cho phép thao tác đó. Kiểm tra các dòng
policy.csv trong mục Quyền yêu cầu: đọc log cần logs, get, còn sync cần applications, sync.Danh sách ứng dụng trống
Danh sách ứng dụng trống
Vai trò chưa được cấp quyền vào các project đó. Mẫu
*/* trong policy bao gồm mọi project; nếu bạn đã thu hẹp mẫu này, hãy thêm các project mà agent cần thấy.Không dùng được sync, tạo, cập nhật hoặc xóa
Không dùng được sync, tạo, cập nhật hoặc xóa
READ_ONLY đang đặt là Read-only. Sửa kết nối và chuyển sang Full access nếu bạn muốn agent đề xuất các thay đổi đó.
Sinh token thất bại
Sinh token thất bại
Tài khoản chưa có khả năng
apiKey. Chạy argocd account get --account cloudthinker để kiểm tra, rồi làm lại bước thiết lập đầu tiên.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.
- Tài khoản riêng: cấp cho CloudThinker một tài khoản
cloudthinkerriêng chỉ có quyền dùng API key, không bao giờ dùng token củaadmin. - Giữ xác minh TLS ở production: chỉ bỏ qua với máy chủ local hoặc dev dùng chứng chỉ tự ký.
Liên quan
Kết nối Kubernetes
Cho phép agent đọc các cluster mà Argo CD deploy tới.
Approvals
Kiểm soát những lần sync và thay đổi nào phải chờ người duyệt.