Cheat Sheet — kubectl cho Spring trên Kubernetes

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 wideDạ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 yamlXuấ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=.lastTimestampSự 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> --previousLog 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/shMở 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.
kubectl cp <pod>:/tmp/recording.jfr ./recording.jfr -n <ns>Sao chép file giữa máy local và container — hay dùng để lấy heap dump hoặc file JFR đã ghi trong pod ra phân tích.

Triển khai, rollout & scale

Triển khai, rollout & scale
MụcÝ nghĩa & cách dùng
kubectl apply -f k8s/Áp dụng manifest trong thư mục theo kiểu khai báo (declarative): tạo mới hoặc cập nhật tài nguyên cho khớp file. Là cách deploy chuẩn qua CI/CD.
kubectl rollout status deploy/loyalty-api -n <ns>Theo dõi tiến trình rollout tới khi hoàn tất hoặc timeout — dùng trong pipeline để biết deploy mới đã sẵn sàng nhận traffic chưa.
kubectl rollout history deploy/loyalty-api -n <ns>Danh sách các revision đã triển khai của Deployment kèm change-cause — tra cứu trước khi quyết định rollback.
kubectl rollout undo deploy/loyalty-api -n <ns>Quay về revision ngay trước đó (thêm --to-revision=<n> để về một revision cụ thể) khi bản mới gây lỗi.
kubectl rollout restart deploy/loyalty-api -n <ns>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.
kubectl scale deploy/loyalty-api --replicas=4 -n <ns>Đổ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.

Kết nối, tài nguyên & ngữ cảnh

Kết nối, tài nguyên & ngữ cảnh
MụcÝ nghĩa & cách dùng
kubectl port-forward svc/loyalty-api 8080:8080 -n <ns>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-contextXem 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.
kubectl annotate deploy/loyalty-api note='hotfix 2026-10' -n <ns>Gắn annotation (metadata mô tả, không dùng để chọn tài nguyên như label) — thường để ghi lý do thay đổi hoặc thông tin cho công cụ bên ngoài.