Điều kiện tiên quyết
- Một cluster có API server mà CloudThinker truy cập được qua internet. Lệnh chạy trên cloud của CloudThinker, nên endpoint chỉ riêng tư sẽ làm bài kiểm tra kết nối thất bại. Nếu bạn giới hạn truy cập API (public access CIDR của EKS, authorized network của GKE, authorized IP range của AKS), hãy thêm egress IP của CloudThinker thay vì mở cho
0.0.0.0/0. Tài liệu này không công bố danh sách egress IP của CloudThinker: hãy hỏi đầu mối CloudThinker của bạn, hoặc liên hệ chúng tôi. Xem Truy cập dịch vụ riêng tư để biết các phương án khác. - Quyền
kubectlvào cluster đó, đủ để tạo namespace, ClusterRole và ClusterRoleBinding. - Cluster managed (EKS, GKE, AKS) cấp kubeconfig đăng nhập qua exec plugin
aws,gcloudhoặcaz, và các plugin này không chạy được trong CloudThinker. Bước 2 tạo một kubeconfig dùng được. Kubernetes tự kiểm tra token của service account, nên bạn không cần ánh xạ token trong IAM của cloud (ví dụ không cần EKS access entry). - Tùy chọn: Metrics Server trong cluster. Không có Metrics Server, agent vẫn báo cáo trạng thái pod và điều kiện node, nhưng không có mức dùng CPU và bộ nhớ theo thời gian thực.
- Vai trò Admin trong workspace CloudThinker, vai trò có thể thêm và sửa kết nối. Xem Vai trò.
Mỗi workspace có một kết nối Kubernetes, và agent làm việc trong current context của kubeconfig. Hãy tải lên kubeconfig cho đúng một cluster bạn muốn kiểm tra. Với nhiều cluster, dùng mỗi cluster một workspace, hoặc thêm kết nối Rancher để xem inventory và sức khỏe của các cluster mà Rancher quản lý.
Thiết lập
1
Tạo service account chỉ đọc
Lưu manifest này thành
Áp dụng manifest:Lệnh này tạo namespace
cloudthinker-reader.yaml. Manifest cũng tạo một Secret là token của service account, và chỉ bạn đọc Secret này ở bước 2. Phần Quyền yêu cầu giải thích role cho phép những gì.cloudthinker-reader.yaml
cloudthinker-reader.yaml
cloudthinker, service account cloudthinker-reader, một ClusterRole chỉ đọc gắn với service account đó và một Secret chứa token dài hạn.Trạng thái thành công: kubectl get secret cloudthinker-reader-token -n cloudthinker liệt kê Secret với số DATA là 3. Kubernetes điền token vài giây sau khi bạn áp dụng, nên nếu DATA hiện 0, hãy đợi rồi chạy lại lệnh.2
Tạo kubeconfig cho service account đó
Chạy từ shell có context Kết quả phải là hostname hoặc IP public. Nếu thấy Trên các bản macOS cũ, thay
kubectl hiện tại là cluster đích. Trước tiên, đọc và kiểm tra địa chỉ API server:127.0.0.1, localhost hoặc địa chỉ riêng như 10.x hay 192.168.x (thường gặp với kind, minikube, k3d hoặc khi đi qua proxy cục bộ), CloudThinker không truy cập được, nên hãy dừng lại và xử lý quyền truy cập trước.Sau đó, trong cùng shell, tạo file cloudthinker-kubeconfig.yaml có nhúng sẵn token và chứng chỉ CA:base64 --decode bằng base64 -D, và giữ dòng EOF kết thúc ở ngay đầu dòng.Trạng thái thành công: kubectl --kubeconfig cloudthinker-kubeconfig.yaml get nodes liệt kê các node của bạn. Đây cũng là lệnh CloudThinker chạy để kiểm tra kết nối.3
Tải kubeconfig lên CloudThinker
Mở More → Workspace settings → Connections, chọn Kubernetes và tải
cloudthinker-kubeconfig.yaml lên trường KUBECONFIG. Nhấn Connect.Trạng thái thành công: kết nối hiển thị Connecting và Verifying, rồi chuyển sang trạng thái Connected.Chi tiết kết nối
Nhúng mọi thứ vào file. Kubeconfig trỏ đến file chứng chỉ cục bộ, hoặc đăng nhập qua plugin
exec, cần những file và công cụ mà CloudThinker không có. File dùng token ở bước 2 tránh được cả hai.
Quyền yêu cầu
Manifest ở bước 1 cấp quyền đọc (get, list, watch) cho các tài nguyên agent cần kiểm tra, cùng log pod và metrics. Manifest này không đọc được Secret.
Quyền đọc áp dụng trên toàn cluster, kể cả kube-system, vì ClusterRoleBinding cấp role trong mọi namespace. Để chỉ bao phủ một số namespace, thay ClusterRoleBinding bằng một RoleBinding tới cùng ClusterRole đó trong từng namespace. Khi đó, các tài nguyên cấp cluster như node, namespace và persistent volume sẽ không xuất hiện trong câu trả lời, vì RoleBinding không cấp được chúng.
Custom resource không nằm trong role, nên agent không thấy các đối tượng dựa trên CRD như application của Argo CD hay virtual service của Istio. Để agent thấy được, hãy thêm vào ClusterRole một rule với API group của từng resource.
Quyền ghi
Agent chỉ chạy thay đổi nhưscale, rollout restart, cordon, drain hoặc apply khi bạn yêu cầu trong cuộc hội thoại, và role chỉ đọc ở trên khiến các thay đổi này thất bại với 403. Allow writes trên bảng chi tiết của kết nối là lớp kiểm soát thứ hai. Công tắc này bật theo mặc định, nhưng không thể nới rộng những gì role cho phép.
Để khóa cả thao tác ghi trong CloudThinker, mở More → Workspace settings → Connections, chọn Kubernetes và tắt công tắc Allow writes trên bảng chi tiết.
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.
Để cho phép một thay đổi cụ thể, chỉ cấp đúng những gì thay đổi đó cần:
- Scale và rollout restart tác động lên workload trong namespace. Dùng một Role trong từng namespace liên quan, với
patchtrêndeploymentsvàgetcùngpatchtrêndeployments/scale. Với StatefulSet, thêm tương tự chostatefulsetsvàstatefulsets/scale. Với DaemonSet, thêmdaemonsets(chỉ restart, vì DaemonSet không scale). - Apply cần
get,createvàpatchtrên từng loại tài nguyên trong manifest bạn áp dụng, ở các namespace mà manifest nhắm tới. - Cordon và drain tác động lên node, vốn là tài nguyên cấp cluster, nên Role trong namespace không cho phép được. Dùng ClusterRole với
patchtrênnodesvàcreatetrênpods/eviction. Role đọc đã có sẵngetvàlisttrên pod và DaemonSet mà drain cần.
cloudthinker-reader, nên một kubeconfig bao phủ cả đọc lẫn thay đổi. Nếu bạn định cấp quyền ghi ngay từ đầu, hãy đổi tên account (ví dụ cloudthinker-agent) trong cả hai manifest và ở bước 2.
Ví dụ sau cho phép scale deployment trong một namespace, cùng cordon và drain. Thay payments bằng namespace của bạn, lưu thành cloudthinker-write.yaml và chạy kubectl apply -f cloudthinker-write.yaml.
kubectl auth can-i patch deployments/scale -n payments --as=system:serviceaccount:cloudthinker:cloudthinker-reader in ra yes.
Khả năng của agent
Xác minh kết nối
Ví dụ prompt
Xoay vòng token
Kubernetes là dịch vụ chỉ cho một kết nối, nên khi kết nối đang hoạt động tốt sẽ không có biểu tượng bút chì hay hộp thoại Edit Instance. Hãy tạo token mới trước và xóa Secret cũ sau cùng: xóa trước sẽ cắt kết nối tới cluster khi bạn chưa có token thay thế hoạt động được.1
Tạo Secret token thứ hai
Lưu nội dung sau thành Áp dụng file:Trạng thái thành công:
cloudthinker-reader-token-2.yaml: một token thứ hai cho cùng service account, để cả hai cùng dùng được trong lúc bạn hoán đổi.kubectl get secret cloudthinker-reader-token-2 -n cloudthinker liệt kê Secret với số DATA là 3.2
Tạo kubeconfig từ token mới
Lặp lại bước 2 của phần Thiết lập, dùng
cloudthinker-reader-token-2 thay cho cloudthinker-reader-token.Trạng thái thành công: kubectl --kubeconfig cloudthinker-kubeconfig.yaml get nodes liệt kê các node của bạn.3
Hoán đổi trong CloudThinker
Khi kết nối đang hiển thị Connected, nhấn Disconnect trên bảng chi tiết Kubernetes, rồi kết nối lại và tải lên kubeconfig mới. Khi kết nối hiển thị Error, nhấn Replace credentials trên bảng chi tiết và tải kubeconfig mới lên, không cần ngắt kết nối.Trạng thái thành công: kết nối hiển thị Connected.
4
Xóa Secret cũ
Đến lúc này mới xóa token đã được thay thế:
- Agent và các automation theo lịch không dùng được cluster trong khoảng giữa lúc ngắt và lúc kết nối lại.
- Quá trình khám phá chạy lại và tiêu tốn credit.
- Allow writes trở về trạng thái bật. Hãy tắt lại nếu trước đó bạn đã tắt.
- Kiểm tra các Rule có nêu tên kết nối Kubernetes vẫn còn liệt kê kết nối này.
kubectl create token cloudthinker-reader -n cloudthinker --duration=<time>. Kết nối sẽ hỏng khi token đó hết hạn, nên mỗi lần như vậy bạn phải tạo và tải lên lại kubeconfig.
Khắc phục sự cố
Khi kiểm tra thất bại, CloudThinker hiển thịFailed to connect to Kubernetes: kèm dòng lỗi đầu tiên của kubectl get nodes. Đối chiếu dòng đó với các mục dưới đây.
Unable to connect to the server
Unable to connect to the server
CloudThinker không truy cập được API server trong kubeconfig. Kiểm tra địa chỉ
server truy cập được từ internet, không chỉ từ VPN của bạn, và allowlist của API server (nếu có) cho phép truy cập từ bên ngoài. Chạy kubectl --kubeconfig cloudthinker-kubeconfig.yaml get nodes từ một máy bên ngoài mạng của bạn để xác nhận.Error from server (Forbidden) trong câu trả lời
Error from server (Forbidden) trong câu trả lời
ClusterRole không bao phủ tài nguyên đó. Xác nhận ClusterRoleBinding đã được áp dụng, rồi thêm tài nguyên vào role.
getting credentials: exec, hoặc no such file or directory
getting credentials: exec, hoặc no such file or directory
Kubeconfig phụ thuộc vào một lệnh hoặc đường dẫn file cục bộ. Thay bằng kubeconfig dùng token ở bước 2.
Câu trả lời không có mức dùng CPU hoặc bộ nhớ
Câu trả lời không có mức dùng CPU hoặc bộ nhớ
Metrics Server chưa được cài hoặc chưa sẵn sàng. Chạy
kubectl top nodes để kiểm tra. Trạng thái pod, event và điều kiện node vẫn hoạt động khi không có Metrics Server.Connection 'k8s' already exists. Only one instance is allowed.
Connection 'k8s' already exists. Only one instance is allowed.
k8s là kết nối Kubernetes, và mỗi workspace chỉ có một kết nối này. Không có biểu tượng bút chì để sửa, nên để trỏ CloudThinker sang cluster khác, hãy nhấn Disconnect trên bảng chi tiết Kubernetes rồi kết nối lại bằng kubeconfig kia.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.
- Giữ Secret ngoài role. Manifest ở trên không bao giờ cấp quyền đọc Secret, nên agent không đọc được đối tượng Secret. Log pod và ConfigMap thì đọc được, nên hãy bỏ
pods/loghoặcconfigmapskhỏi role nếu chúng chứa dữ liệu nhạy cảm. Giá trị env đặt trực tiếp trong pod spec đọc được quapods, nên hãy chuyển các giá trị nhạy cảm vào Secret. - Xoay vòng token. Secret token không tự hết hạn, nên hãy xoay vòng theo lịch thông thường của bạn. Xem Xoay vòng token.
- Thu hồi bằng một lệnh. Xóa Secret token để cắt quyền truy cập ngay, hoặc xóa namespace
cloudthinkercùng ClusterRole và binding để gỡ bỏ toàn bộ.
Liên quan
Rancher
Đọc inventory và quyền truy cập trên các cluster mà Rancher quản lý
Giám sát sức khỏe Kubernetes
Dùng kết nối này cho bài kiểm tra sức khỏe cluster định kỳ
Approvals
Quyết định thay đổi cluster nào được chạy, chờ người duyệt hoặc bị từ chối
Tổng quan kết nối
Cách trạng thái kết nối, kiểm tra và khám phá hoạt động