Chuyển đến nội dung chính
Kết nối Argo CD để agent của CloudThinker liệt kê các ứng dụng, giải thích vì sao một ứng dụng mất đồng bộ hoặc suy giảm, đọc Kubernetes event và log của pod, và sync ứng dụng qua quy trình phê duyệt của bạn. Kết nối đăng nhập bằng một API token của Argo CD và hoạt động với cả Argo CD tự lưu trữ lẫn Akuity Platform.

Điều kiện tiên quyết

  • Máy chủ Argo CD mà CloudThinker truy cập được qua HTTPS. Địa chỉ localhost hoặ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 kubectl vào namespace argocd, để sửa ConfigMap argocd-cm và argocd-rbac-cm.
Nếu máy chủ nằm trong mạng riêng, xem Truy cập dịch vụ riêng.

Thiết lập

Hãy tạo một tài khoản cloudthinker 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.
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 kubectl -n argocd edit configmap argocd-rbac-cm và thêm các dòng sau vào policy.csv hiện có:
Hãy sửa ConfigMap hiện có thay vì apply một ConfigMap mới. 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.
Nhấn Connect.Trạng thái thành công: hộp thoại đóng lại và kết nối hiển thị Connected. Trạng thái này chưa chứng minh token hay RBAC hoạt động, vì vậy hãy chạy prompt xác minh bên dưới.

Chi tiết kết nối

READ_ONLY mặc định là Full access. Hãy chuyển sang Read-only, trừ khi bạn muốn agent đề xuất sync và thay đổi. RBAC vẫn chặn mọi thao tác mà tài khoản chưa được cấp quyền.

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

Bạn sẽ nhận được bảng tên ứng dụng kèm trạng thái sync như Synced hoặc OutOfSync, tình trạng sức khỏe như Healthy hoặc Degraded, và số lượng tổng kết ở cuối.

Ví dụ prompt

Hãy nêu tên ứng dụng. Agent dùng tên thật trong danh sách ứng dụng và không tự đoán tên. Prompt sync cần Full access và quyền applications, sync.

Khắc phục sự cố

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.
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.
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.
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.
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 đó.
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 cloudthinker riêng chỉ có quyền dùng API key, không bao giờ dùng token của admin.
  • 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.