kubectl 常用命令速查表

列出所有集群上下文，切錯集群是常見事故

kubectl config get-contexts

切換當前上下文，操作前先確認這一條

kubectl config use-context prod-cn

查看當前在哪個集群，腳本里可做前置校驗

kubectl config current-context

把默認命名空間固定下來，省去每次 -n

kubectl config set-context --current --namespace=staging

列出命名空間

kubectl get ns

一次看某命名空間下的主要資源

kubectl get all -n app

多顯示 IP 與所在節點，排查調度與網絡必備

kubectl get pods -o wide -n app

查所有命名空間的 Pod

kubectl get pods -A --field-selector=status.phase!=Running

持續監聽列表變化，滾動更新時觀察用

kubectl get pods -w -n app

導出某個資源的完整 YAML（含運行時狀態）

kubectl get pod web-0 -o yaml > pod-backup.yaml

導出時去掉集群生成的字段，方便重新套用

kubectl get deploy web -o yaml -n app

在終端查字段含義與取值範圍，不用翻文檔

kubectl explain deploy.spec.strategy --recursive

列出集群支持的所有資源類型與簡寫

kubectl api-resources --namespaced=true

聲明式應用配置，重複執行安全

kubectl apply -f k8s/ -n app

按文件刪除資源

kubectl delete -f k8s/ -n app

創建命名空間

kubectl create ns staging

查看 Pod 詳情，末尾 Events 段是排障重點

kubectl describe pod web-0 -n app

查看容器日誌

kubectl logs web-0 -n app --tail=200

跟蹤指定容器日誌，多容器 Pod 必須帶 -c

kubectl logs -f web-0 -c app -n app

看上一次崩潰前的日誌，CrashLoopBackOff 必用

kubectl logs web-0 --previous -n app

只看最近一段時間的日誌

kubectl logs web-0 --since=10m --timestamps -n app

進入容器，多數精簡鏡像沒有 bash

kubectl exec -it web-0 -n app -- /bin/sh

查看容器內實際生效的環境變量

kubectl exec web-0 -n app -- printenv

在本地與 Pod 之間複製文件

kubectl cp ./dump.sql app/web-0:/tmp/dump.sql

把 Pod 端口轉發到本地，調試未暴露的服務

kubectl port-forward pod/web-0 8080:80 -n app

臨時排錯容器，退出即清理

kubectl run tmp --rm -it --image=busybox:1.36 --restart=Never -- sh

取 Pod IP，方便寫進腳本

kubectl get pod web-0 -o jsonpath="{.status.podIP}" -n app

刪除 Pod，被控制器管理的會自動重建

kubectl delete pod web-0 -n app

強制刪除卡在 Terminating 的 Pod

kubectl delete pod web-0 --grace-period=0 --force -n app

看重啓次數，判斷是否在反覆崩潰

kubectl get pod web-0 -o jsonpath="{.status.containerStatuses[*].restartCount}" -n app

列出 Deployment 及副本就緒情況

kubectl get deploy -n app -o wide

調整副本數，擴容最直接的方式

kubectl scale deploy/web --replicas=3 -n app

滾動更新鏡像版本

kubectl set image deploy/web web=registry.example.com/app:1.1 -n app

直接編輯線上配置，保存即生效

kubectl edit deploy/web -n app

用一行 JSON 改字段，腳本里比 edit 合適

kubectl patch deploy/web --type=merge -p "{\"spec\":{\"replicas\":2}}" -n app

配置水平自動擴縮容

kubectl autoscale deploy/web --min=2 --max=10 --cpu-percent=70 -n app

查看 ReplicaSet，歷史版本都留在這裡

kubectl get rs -n app

確認線上實際跑的是哪個鏡像

kubectl get deploy web -o jsonpath="{.spec.template.spec.containers[*].image}" -n app

打註釋，記錄發佈信息

kubectl annotate deploy/web note="release-1.1" --overwrite -n app

打標籤，供 Service 選擇器與選擇器查詢使用

kubectl label deploy/web tier=web --overwrite -n app

觀察滾動更新進度，發佈後必看

kubectl rollout status deploy/web -n app --timeout=120s

查看歷史版本與變更原因

kubectl rollout history deploy/web -n app

回滾到上一個版本，出事後最快止血

kubectl rollout undo deploy/web -n app

回滾到指定版本，先看 history 再定

kubectl rollout undo deploy/web --to-revision=2 -n app

原地重啓全部 Pod，配置變更後常用

kubectl rollout restart deploy/web -n app

暫停發佈，配合 set image 可在觀察後再放行

kubectl rollout pause deploy/web -n app

恢復被暫停的發佈

kubectl rollout resume deploy/web -n app

列出 Service 及其 ClusterIP 與端口

kubectl get svc -n app -o wide

查看 Service 背後真實的 Pod IP，為空說明選擇器沒匹配上

kubectl get endpoints web -n app

查看 Service 詳情，含選擇器與端口映射

kubectl describe svc web -n app

為 Deployment 快速建一個 Service

kubectl expose deploy/web --port=80 --target-port=8080 --type=ClusterIP -n app

轉發 Service 端口，不依賴 Ingress 就能本地驗證

kubectl port-forward svc/web 8080:80 -n app

列出 Ingress 與暴露的域名

kubectl get ingress -n app

查看 Ingress 規則與後端解析結果

kubectl describe ingress web -n app

列出網絡策略，Pod 之間不通先查它

kubectl get netpol -n app

取 ClusterIP，寫進配置或腳本用

kubectl get svc web -o jsonpath="{.spec.clusterIP}" -n app

列出 ConfigMap

kubectl get cm -n app

從文件創建 ConfigMap

kubectl create cm app-config --from-file=config/app.yaml -n app

查看 ConfigMap 內容

kubectl describe cm app-config -n app

列出 Secret，值默認是 base64 不是加密

kubectl get secret -n app

從字面量創建 Secret

kubectl create secret generic db --from-literal=password=changeit -n app

解出 Secret 明文，排查配置不生效

kubectl get secret db -o jsonpath="{.data.password}" -n app | base64 -d

列出 ServiceAccount，Pod 訪問 API 用的身份

kubectl get sa -n app

驗證某個身份有沒有權限，RBAC 排查用

kubectl auth can-i get pods --as=system:serviceaccount:app:web -n app

列出節點與狀態

kubectl get nodes -o wide

查看節點詳情，含已分配資源與污點

kubectl describe node node-1

查看節點實際資源佔用，需裝 metrics-server

kubectl top nodes

查看 Pod 資源佔用，定位誰在喫內存

kubectl top pods -n app --sort-by=memory

標記節點不可調度，但不影響已有 Pod

kubectl cordon node-1

驅逐節點上的 Pod，維護前必做

kubectl drain node-1 --ignore-daemonsets --delete-emptydir-data

恢復節點可調度

kubectl uncordon node-1

給節點加污點，只讓能容忍的 Pod 調度上去

kubectl taint nodes node-1 dedicated=gpu:NoSchedule

按時間倒序看事件，集群層面的問題都在這

kubectl get events --sort-by=.lastTimestamp -n app | tail -30

實時監聽事件流，復現問題時開着

kubectl get events -w -n app

篩出所有失敗狀態的 Pod

kubectl get pod --field-selector=status.phase=Failed -A

取未就緒原因，比翻 describe 快

kubectl get pod web-0 -o jsonpath="{.status.conditions[?(@.type==\"Ready\")].reason}" -n app

給已有 Pod 注入臨時容器，共享進程命名空間

kubectl debug -it web-0 --image=busybox:1.36 --target=app -n app

在節點上開排錯 Pod，能看宿主機文件系統

kubectl debug node/node-1 -it --image=busybox:1.36

一次看 Pod 內所有容器日誌

kubectl logs web-0 --all-containers --prefix -n app

等待 Pod 就緒，腳本里做同步點

kubectl wait --for=condition=Ready pod/web-0 --timeout=60s -n app

配合 jq 精查狀態字段，比 jsonpath 好寫

kubectl get pod web-0 -o json -n app | jq .status

看字段到底被誰改的，排查配置被篡改

kubectl get pod web-0 -o yaml --show-managed-fields -n app

查看控制面地址與附加組件位置

kubectl cluster-info

查看客戶端與服務端版本，注意版本偏差

kubectl version --short

服務端試跑，真校驗字段與准入策略但不落盤

kubectl apply --dry-run=server -f deploy.yaml -n app

預覽 apply 會改哪些字段，變更前先看

kubectl diff -f deploy.yaml -n app

查看存儲卷與聲明，Pending 多為存儲類問題

kubectl get pv,pvc -n app

查看自動擴縮容狀態與當前指標

kubectl get hpa -n app

列出集群安裝的自定義資源定義

kubectl get crd | head -30

列出支持列舉的命名空間級資源，備份腳本常用

kubectl api-resources --verbs=list --namespaced -o name