Các lệnh kubectl hằng ngày khi vận hành ứng dụng Spring Boot trên Kubernetes: xem trạng thái, đọc log, rollout, scale, port-forward và gỡ lỗi pod.
Module 11
Xem trạng thái tài nguyên
Xem trạng thái tài nguyên
Mục
Ý nghĩa & cách dùng
kubectl get pods -n <ns>
Liệt kê pod trong namespace: trạng thái, số lần restart, tuổi. Thêm -w để theo dõi thay đổi theo thời gian thực khi rollout/debug.
kubectl get deploy,svc,ingress -n <ns>
Xem cùng lúc Deployment, Service và Ingress — ba tài nguyên đưa traffic tới ứng dụng Spring: deploy quản lý pod, svc cân bằng tải nội bộ, ingress mở ra ngoài.
kubectl get pods -n <ns> -o wide
Dạng wide: thêm cột IP của pod và node đang chạy — cần khi truy vết traffic hoặc nghi ngờ lỗi theo node.
kubectl get deploy loyalty-api -n <ns> -o yaml
Xuất manifest đầy đủ dạng YAML của một tài nguyên, gồm cả trạng thái server quản lý — dùng để đối chiếu cấu hình thực tế với file đã apply.
kubectl get pods -n <ns> -o jsonpath='{.items[0].status.podIP}'
jsonpath trích đúng một trường từ output JSON — ví dụ lấy IP của pod đầu tiên để script hóa kiểm tra hoặc gọi thẳng vào pod.
kubectl describe pod <pod> -n <ns>
Chi tiết một pod: container, probe, volume, limit/request và đặc biệt là mục Events ở cuối — nơi đầu tiên cần xem khi pod Pending, CrashLoopBackOff hoặc probe fail.
kubectl get events -n <ns> --sort-by=.lastTimestamp
Sự kiện của namespace xếp theo thời gian: lịch sử kéo image, scheduling, probe fail, OOMKilled — đọc từ dưới lên để dựng timeline sự cố.
Log & truy cập vào container
Log & truy cập vào container
Mục
Ý nghĩa & cách dùng
kubectl logs <pod> -n <ns>
Log hiện tại của container chính — với Spring Boot là nơi xem log khởi động, stack trace và thông điệp lỗi.
kubectl logs <pod> -n <ns> --previous
Log của lần chạy trước đã chết — bắt buộc xem khi pod CrashLoopBackOff vì log hiện tại chỉ là lần khởi động mới đang lặp lại.
kubectl logs -f deploy/loyalty-api -n <ns>
Đuôi log theo thời gian thực (-f) theo Deployment: kubectl tự chọn một pod, tiện khi theo dõi rollout hoặc tái hiện lỗi.
kubectl logs <pod> -c <container> -n <ns>
Chỉ định container trong pod nhiều container (ví dụ container ứng dụng thay vì sidecar/init) khi đọc log.
kubectl exec -it <pod> -n <ns> -- /bin/sh
Mở shell tương tác vào container đang chạy để kiểm tra file, biến môi trường, kết nối mạng. Image tối giản (distroless/JRE-only) có thể không có shell — khi đó dùng kubectl debug hoặc kiểm tra từ bên ngoài.
Khởi động lại toàn bộ pod của Deployment theo rolling update mà không đổi image — dùng để nạp lại ConfigMap/Secret đã thay đổi hoặc thoát trạng thái kẹt.
Đổi số replica ngay lập tức. Lưu ý: nếu HPA đang quản lý Deployment, giá trị này sẽ bị HPA ghi đè theo metric.
kubectl delete pod <pod> -n <ns>
Xóa một pod: ReplicaSet sẽ tạo pod thay thế — cách kiểm chứng self-healing và graceful shutdown (preStop, terminationGracePeriodSeconds) có hoạt động đúng không.
Chuyển tiếp cổng local 8080 vào Service trong cluster — gọi thử Actuator (localhost:8080/actuator/health) mà không cần mở Ingress. Chỉ dùng để debug, không phải kênh traffic thật.
kubectl top pod -n <ns>
CPU/RAM thực dùng của pod — đối chiếu với requests/limits và heap JVM. Cần metrics-server đã cài trong cluster, nếu không lệnh sẽ báo không có dữ liệu.
kubectl config current-context
Xem context hiện tại (cluster + user + namespace mặc định) — kiểm tra trước mọi lệnh ghi để tránh thao tác nhầm cluster production.
kubectl config use-context <context>
Chuyển context làm việc, ví dụ từ cluster dev sang staging trước khi apply.
kubectl label pod <pod> version=v2 -n <ns>
Gắn hoặc đổi label trên pod/tài nguyên — label là cơ chế Service/selector và các truy vấn -l dựa vào, ví dụ kubectl get pods -l app=loyalty-api.