kubectl 命令速查表 - Kubernetes 常用命令大全
面向应用开发与集群运维的 kubectl 命令手册，覆盖资源查询、Pod 诊断、副本伸缩与集群上下文切换。与直接读 YAML 相比，kubectl 是观察集群状态、控制变更的一致入口，CrashLoopBackOff、Pod 卡在 Pending、滚动更新失败这类高频事故都能在命令层面快速定位。读完可独立完成"看状态 → 查事件 → 看日志 → 恢复或回滚"的完整排障闭环。
典型使用场景
面向 Kubernetes 集群的运维与交付：查看资源状态、扩缩容、滚动更新、排查 Pod 处于 Pending/CrashLoopBackOff/ImagePullBackOff 等异常，以及查看日志与事件定位根因。
查询资源 Get 5
kubectl get pods -n prod列出指定命名空间的 Pod
kubectl get pods -o wide额外显示节点和 Pod IP
kubectl get pods -A列出所有命名空间的 Pod
kubectl get svc,ingress -n prod一次查 Service 和 Ingress
kubectl get events --sort-by=.lastTimestamp按时间排序看事件，定位调度/拉镜像失败
描述与诊断 Describe 5
kubectl describe pod <pod> -n prod看事件、容器状态、探针，排查 CrashLoop/Pending
kubectl logs <pod> -n prod查看 Pod 日志
kubectl logs <pod> --previous查看上一次崩溃容器的日志，CrashLoop 必用
kubectl logs <pod> -c <container>多容器 Pod 指定容器日志
kubectl exec -it <pod> -- sh进入 Pod 容器调试
伸缩与更新 Scale & Rollout 5
kubectl scale deploy/app --replicas=3声明式调整副本数，触发新 ReplicaSet 生成对应 Pod，扩容立即按需拉起
kubectl rollout status deploy/app阻塞等待滚动更新完成；超时未就绪说明新版本探针失败，应加 timeout 参数避免无限挂起
kubectl rollout undo deploy/app回滚到上一个版本，排障时首选而非手动改 image；可用 --to-revision 指定回滚目标
kubectl set image deploy/app c=app:1.1更新镜像触发滚动更新
kubectl delete pod <pod>删除 Pod，由控制器自动重建
上下文与配置 Context 4
kubectl config get-contexts列出所有集群上下文
kubectl config use-context <ctx>切换当前操作的集群，多集群必看
kubectl config set-context --current --namespace=prod设置默认命名空间，省去每次 -n
kubectl top pod -n prod查看 Pod CPU/内存用量，需 metrics-server
常见问题 FAQ 5
Q: 如何查看所有命名空间的 Pod？A: kubectl get pods -A 或 kubectl get pods --all-namespaces，可查看集群中所有命名空间的 Pod。
Q: kubectl apply 和 kubectl create 有什么区别？A: kubectl apply 是声明式（推荐），支持创建和更新；kubectl create 是命令式，重复执行会报错已存在。
Q: 如何查看 Pod 的日志？A: kubectl logs <pod> -n <namespace>，加 -f 实时跟踪，--previous 查看上一次崩溃容器的日志。
Q: 如何进入 Pod 的容器？A: kubectl exec -it <pod> -- sh（或 /bin/bash），多容器 Pod 用 -c <container> 指定容器。
Q: 如何查看集群节点状态？A: kubectl get nodes 查看所有节点状态，kubectl describe node <name> 查看节点详细信息。
高频补充命令（容量增强 · REQ-02） 35
kubectl cluster-info查看集群控制面端点与附加服务地址
kubectl config get-contexts列出全部上下文及当前所选上下文
kubectl config use-context <ctx>切换当前操作的集群上下文
kubectl api-resources列出集群支持的所有资源类型与简写
kubectl explain pod.spec.containers查看某字段的官方说明与类型（无需翻文档）
kubectl get all -n <ns>查看命名空间内的全部工作负载与网络资源
kubectl get pods -l app=web按标签选择器筛选 Pod
kubectl get pods -o wide显示 Pod 所在节点与 Pod IP
kubectl get events --sort-by=.lastTimestamp按时间排序查看集群事件（排障首选）
kubectl describe pod <pod>查看 Pod 详情、事件与状态原因
kubectl logs <pod> -c <container>查看指定容器的日志
kubectl exec -it <pod> -- bash在 Pod 内打开交互式 shell
kubectl port-forward <pod> 8080:80将本地端口转发到 Pod 端口便于调试
kubectl cp <pod>:/path ./local在 Pod 与本地之间复制文件
kubectl apply -f - <<EOF直接从标准输入创建/更新资源
kubectl create deployment web --image=nginx快速创建一个 Deployment
kubectl scale deployment web --replicas=3手动扩缩容副本数
kubectl rollout status deployment/web阻塞等待滚动更新完成
kubectl rollout undo deployment/web回滚到上一个稳定版本
kubectl rollout history deployment/web查看该 Deployment 的修订历史
kubectl set image deployment/web web=nginx:1.25更新容器镜像触发滚动发布
kubectl delete pod <pod> --grace-period=0强制立即删除 Pod（绕过优雅退出）
kubectl cordon <node>标记节点为不可调度（保留已有负载）
kubectl drain <node> --ignore-daemonsets驱逐节点上负载以便维护
kubectl uncordon <node>恢复节点可调度
kubectl taint nodes <node> key=value:NoSchedule给节点打污点，限制可调度 Pod
kubectl label nodes <node> disktype=ssd给节点打标签，供节点亲和性选择
kubectl top node查看各节点 CPU/内存使用率
kubectl top pod查看 Pod 资源使用率
kubectl get hpa查看水平自动扩缩（HPA）当前状态
kubectl apply -k <dir>使用 Kustomize 目录部署
kubectl get secret <name> -o jsonpath={.data.token}提取 secret 中某字段（base64）
kubectl create configmap <name> --from-file=./cfg从文件/目录创建配置映射
kubectl proxy在本地启动 API Server 代理便于调试
kubectl auth can-i create pods检查当前身份是否具备某权限
调试与输出格式化（REQ-02 补充） 22
kubectl get pods --field-selector=status.phase=Running只列出处于 Running 阶段的 Pod
kubectl get nodes --selector='!node-role.kubernetes.io/control-plane'仅列出工作节点，排除控制面
kubectl get pods --show-labels显示 Pod 携带的全部标签
kubectl get services --sort-by=.metadata.name按名称排序列出 Service
kubectl get pods --sort-by='.status.containerStatuses[0].restartCount'按重启次数排序 Pod，快速找异常
kubectl get pv --sort-by=.spec.capacity.storage按容量大小排序持久卷
kubectl get nodes -o jsonpath={.items[*].status.addresses[?(@.type=="ExternalIP")].address}提取全部节点的外网 IP
kubectl get secret my-secret -o go-template={{range $k,$v := .data}}{{$k}}:{{$v|base64decode}}{{end}}用模板一次性解码输出 Secret 键值
kubectl get pods -A -o=custom-columns='DATA:spec.containers[*].image'列出集群内运行的所有容器镜像
kubectl get node -o custom-columns='NODE_NAME:.metadata.name,STATUS:.status.conditions[?(@.type=="Ready")].status'自定义列查看节点就绪状态
kubectl diff -f ./my-manifest.yaml对比集群现状与应用清单后的差异
kubectl patch node k8s-node-1 -p {"spec":{"unschedulable":true}}局部更新节点为不可调度
kubectl patch deployment web --subresource=scale --type=merge -p {"spec":{"replicas":2}}通过 scale 子资源调整副本数
kubectl replace --force -f ./pod.json强制替换资源（先删除再重建）
kubectl expose deployment web --port=80 --target-port=8000为工作负载暴露一个 Service
kubectl logs -f -l name=myLabel --all-containers按标签流式跟踪全部容器日志
kubectl logs my-pod --previous查看上一次崩溃实例的日志
kubectl debug my-pod -it --image=busybox:1.28在 Pod 内创建交互式调试容器
kubectl debug node/my-node -it --image=busybox:1.28在节点上创建调试会话
kubectl cluster-info dump --output-directory=/path/to/cluster-state导出集群状态快照到指定目录
kubectl api-resources --verbs=list,get列出支持指定动词的资源类型
kubectl run nginx --image=nginx --dry-run=client -o yaml > pod.yaml生成 Pod 清单而不真正创建
参数矩阵
| 参数 | 作用 | 示例 |
|---|---|---|
-n | 指定命名空间，避免操作默认空间 | kubectl -n prod get pods |
-o | 输出格式（yaml/json/wide/name） | kubectl get pod web -o yaml |
--kubeconfig | 指定集群凭证文件 | kubectl --kubeconfig ~/.kube/prod get nodes |
-f | 按 YAML 文件创建/应用/删除资源 | kubectl apply -f deploy.yaml |
--dry-run=client | 仅校验不创建，可生成清单 | kubectl run nginx --image=nginx --dry-run=client -o yaml |
-l | 按标签筛选资源 | kubectl get pods -l app=web |
--previous | 查看上一次崩溃容器的日志 | kubectl logs web --previous |
-c | 指定多容器 Pod 中的某个容器 | kubectl logs web -c app |
--watch | 持续观察资源变化 | kubectl get pods --watch |
--record | 记录变更原因到修订历史 | kubectl set image deploy/web app=new:1.1 --record |
易错点与避坑指南
现象Pod 长时间处于 Pending。
原因节点资源不足、没有匹配的节点（taint/亲和），或 PVC 无法绑定。
处置kubectl describe pod 看 Events；检查节点资源（kubectl top nodes）与 PVC 状态；放宽资源请求或污点容忍。
现象Pod 反复重启，状态 CrashLoopBackOff。
原因应用启动即崩溃（配置错误、依赖未就绪、端口被占），或探针失败。
处置kubectl logs web --previous 看上一次崩溃日志；kubectl describe pod 看 Last State 与 Events；修正启动命令或探针阈值。
现象镜像拉取失败，状态 ImagePullBackOff / ErrImagePull。
原因镜像名/标签写错、私有仓库未配置 imagePullSecret、或节点无法访问仓库。
处置核对镜像地址与 tag；为私有仓库配置 imagePullSecrets；在节点上手动 crictl pull 验证网络。
现象kubectl top 报错 metrics not available。
原因集群未安装 metrics-server，不是命令写错。
处置确认 metrics-server 已部署（kubectl get apiservice v1beta1.metrics.k8s.io）；安装后再用 top。
现象误在本地把资源改到了生产集群。
原因当前 context 指向生产，操作时未确认集群。
处置任何写操作前执行 kubectl config get-contexts 与 kubectl config current-context 确认；用别名或工具防止误操作。
现象apply 之后改动未生效。
原因字段被其他控制器（如 HPA、Operator）覆盖，或字段不可变。
处置kubectl get 看实际值；对不可变字段（如 selector）需删除重建；排查是否有 controller 在管理该资源。
排障路径
1先看 Pod 状态与事件
kubectl describe pod webEvents 段通常有最直接的失败原因（FailedScheduling、BackOff、FailedMount 等）。
2读应用日志（含上一次崩溃）
kubectl logs web --previous -c appCrashLoop 时当前容器已退出，必须加 --previous 才能看到崩溃前的输出。
3确认节点资源与调度
kubectl top nodesPending 多半是 CPU/内存不足或没有可调度节点。
4查看完整修订历史以便回滚
kubectl rollout history deploy/web确认有可回滚版本后再 kubectl rollout undo deploy/web 回退。
提示
- 排障顺序：get 看状态 → describe 看事件 → logs 看应用错误，CrashLoop 加 --previous。
- 操作前先 kubectl config get-contexts 确认当前集群，避免在生产集群误操作。
- kubectl top 报错通常是没装 metrics-server，不是命令写错。
由 巧匠 维护
公开更新于 2026年9月10日，内容持续校对官方文档。