GeekIt

K8S命令速查

集群、Pod、工作负载、Service、存储、权限与排障等 138 条 kubectl 命令

共 138 条命令 · 10 类场景 · 点击右侧图标可复制

命令说明复制
kubectl version --short查看客户端与服务端版本,确认版本偏差
kubectl cluster-info查看 API Server 与核心组件地址
kubectl config view查看 kubeconfig 内容(--minify 隐藏证书)
kubectl config get-contexts列出全部上下文,确认当前操作的是哪个集群
kubectl config use-context prod-cluster切换上下文,多集群操作前必执行
kubectl config set-context --current --namespace=prod把当前上下文的默认命名空间改为 prod
kubectl get nodes -o wide查看节点状态、内网 IP、内核与容器运行时
kubectl describe node node-1查看节点资源分配、污点与事件
kubectl top nodes查看节点 CPU/内存实时用量(需 metrics-server)
kubectl api-resources列出集群支持的全部资源类型与简写
kubectl api-versions查看可用 API 版本,排查 CRD 未生效
kubectl get componentstatuses快速检查调度器、控制器与 etcd 健康状态
kubectl get events -A --sort-by=.lastTimestamp按时间排序查看全集群事件,定位异常
kubectl cordon node-1标记节点不可调度,准备维护
kubectl drain node-1 --ignore-daemonsets --delete-emptydir-data驱逐节点上的 Pod,维护前使用
kubectl uncordon node-1维护完成后恢复节点可调度
kubectl taint nodes node-1 key=value:NoSchedule给节点打污点,控制 Pod 调度
命令说明复制
kubectl get pods查看当前命名空间 Pod 状态(-A 全部命名空间)
kubectl get pods -o wide --show-labels查看 Pod IP、所在节点与标签,排查调度与网络
kubectl get pods --field-selector status.phase=Failed按字段筛选失败状态的 Pod
kubectl get pods -l app=web按标签筛选 Pod,确认副本是否齐全
kubectl describe pod web-7d9f8c6b5-x2v4n查看 Pod 详情、容器状态与事件原因
kubectl logs -f web-7d9f8c6b5-x2v4n实时跟踪容器日志
kubectl logs --tail=200 web-xxx -c app指定容器查看最近 200 行(多容器 Pod 必用 -c)
kubectl logs -p web-xxx查看上一次崩溃容器的日志,排查 CrashLoopBackOff
kubectl logs --since=30m web-xxx | grep -i error按时间范围取日志并过滤错误
kubectl logs -l app=web --tail=50 --prefix一次查看一组 Pod 的日志并带前缀区分
kubectl exec -it web-xxx -- sh进入容器(无 bash 时用 sh)
kubectl exec -it web-xxx -c app -- env查看指定容器环境变量,排查配置未注入
kubectl exec web-xxx -- cat /etc/resolv.conf查看容器 DNS 配置,排查解析异常
kubectl cp web-xxx:/app/logs/app.log ./app.log从 Pod 复制文件到本地(反向同理)
kubectl port-forward svc/web 8080:80把 Service 端口映射到本地,免暴露即可调试
kubectl top pod --sort-by=memory按内存占用排序查看 Pod 用量
kubectl get pod web-xxx -o jsonpath="{.status.podIP}"提取 Pod IP,配合脚本做连通性验证
kubectl run tmp-shell --rm -it --image=nicolaka/netshoot -- bash临时起一个排障容器,验证集群内网络
kubectl debug -it web-xxx --image=busybox --target=app以临时容器方式调试运行中的 Pod
命令说明复制
kubectl create deployment web --image=nginx:1.27 --replicas=3命令行快速创建 Deployment
kubectl get deploy,sts,ds,job,cronjob一次查看各类工作负载状态
kubectl scale deployment web --replicas=5调整副本数量
kubectl set image deployment/web nginx=nginx:1.28更新镜像触发滚动发布
kubectl rollout status deployment/web观察滚动发布进度,脚本中可判定成功与否
kubectl rollout history deployment/web查看发布历史与修订版本号
kubectl rollout undo deployment/web回滚到上一个版本
kubectl rollout undo deployment/web --to-revision=3回滚到指定修订版本
kubectl rollout restart deployment/web不修改镜像强制重启全部 Pod,触发配置重载
kubectl rollout pause deployment/web 与 resume暂停与恢复滚动发布,便于分批灰度
kubectl describe deployment web查看副本数、更新策略与最近事件
kubectl get rs查看 ReplicaSet,确认新旧版本副本切换情况
kubectl create job --from=cronjob/nightly-backup backup-manual手动触发一次 CronJob
kubectl get cronjob -o wide查看定时任务计划与最近调度时间
kubectl get hpa查看自动伸缩目标与当前副本数
kubectl describe hpa web排查 HPA 不扩容(指标缺失/阈值未达)
命令说明复制
kubectl get svc查看 Service 类型、ClusterIP 与端口映射
kubectl expose deployment web --port=80 --target-port=8080 --type=ClusterIP为 Deployment 快速创建 Service
kubectl get endpoints web查看 Service 后端 Pod IP,为空说明标签不匹配或 Pod 未就绪
kubectl get endpointslices -l kubernetes.io/service-name=web查看 EndpointSlice,确认后端就绪状态
kubectl describe svc web查看选择器、端口与后端 Endpoints
kubectl get ingress -A查看全部 Ingress 规则与地址
kubectl describe ingress web-ing查看域名、路径转发规则与后端服务
kubectl get networkpolicy -A查看网络策略,排查 Pod 间访问被拦截
kubectl run tmp-curl --rm -it --image=curlimages/curl -- curl -sI http://web.prod.svc在集群内验证 Service 访问是否正常
kubectl get svc web -o jsonpath="{.spec.clusterIP}"提取 ClusterIP,便于脚本内构造访问地址
kubectl get ingressclass确认集群可用的 Ingress 控制器
命令说明复制
kubectl create configmap app-config --from-file=app.conf从文件创建 ConfigMap
kubectl create configmap env-config --from-literal=ENV=prod --from-literal=TZ=Asia/Shanghai从字面量创建 ConfigMap
kubectl get configmap app-config -o yaml查看 ConfigMap 内容
kubectl create secret generic db-secret --from-literal=password=123456创建通用 Secret
kubectl create secret docker-registry harbor --docker-server=harbor.example.com --docker-username=user --docker-password=pass创建镜像拉取凭证,配合 imagePullSecrets 使用
kubectl create secret tls web-tls --cert=tls.crt --key=tls.key创建 TLS 证书 Secret 供 Ingress 使用
kubectl get secret db-secret -o jsonpath="{.data.password}" | base64 -d解码 Secret 内容,排查密码是否写错
kubectl describe secret db-secret查看 Secret 的键与字节大小(不显示明文)
kubectl get secret -A --field-selector type=kubernetes.io/tls列出全部 TLS 证书 Secret,检查是否即将过期
kubectl patch deployment web -p "{\"spec\":{\"template\":{\"metadata\":{\"annotations\":{\"reload\":\"$(date +%s)\"}}}}}"打补丁触发滚动重启,让新配置生效
kubectl get pod web-xxx -o yaml | grep -A3 envFrom确认环境变量是否来自 ConfigMap/Secret
命令说明复制
kubectl get pv查看集群级持久卷状态与容量
kubectl get pvc -A查看 PVC 绑定状态(Pending 多为无可用 PV 或 SC 异常)
kubectl describe pvc data-web-0查看 PVC 事件,定位动态供给失败原因
kubectl get storageclass查看可用存储类及默认标记
kubectl patch storageclass standard -p "{\"metadata\":{\"annotations\":{\"storageclass.kubernetes.io/is-default-class\":\"true\"}}}"把某个 StorageClass 设为默认
kubectl get pv pvc-xxxx -o yaml | grep -A5 nodeAffinity查看 PV 的节点亲和,排查 Pod 调度到错误节点
kubectl get pods -o custom-columns=NAME:.metadata.name,VOLUME:.spec.volumes[0].name自定义列查看 Pod 挂载的卷名
kubectl exec -it web-xxx -- df -h在容器内查看挂载点容量使用情况
kubectl exec -it web-xxx -- ls -l /data确认挂载目录内容与权限是否正确
kubectl delete pvc data-web-0删除 PVC(是否保留 PV 取决于回收策略,谨慎)
命令说明复制
kubectl get ns查看全部命名空间及状态
kubectl create ns prod创建命名空间
kubectl config set-context --current --namespace=prod切换默认命名空间,避免误操作其他环境
kubectl get sa -n prod查看命名空间内的 ServiceAccount
kubectl auth can-i delete pods -n prod检查当前身份是否有指定权限
kubectl auth can-i --list -n prod列出当前身份在命名空间内的全部权限
kubectl create role pod-reader --verb=get,list,watch --resource=pods -n prod创建仅可读 Pod 的 Role
kubectl create rolebinding dev-read --role=pod-reader --user=dev01 -n prod把 Role 绑定到指定用户
kubectl create clusterrolebinding dev-admin --clusterrole=view --user=dev01创建集群级只读绑定
kubectl describe clusterrole view查看内置 ClusterRole 的权限范围
kubectl get role,rolebinding -n prod查看命名空间内的授权关系
kubectl get clusterrolebinding | grep dev01反查某用户/组的集群级授权
命令说明复制
kubectl apply -f deploy.yaml声明式创建或更新资源,日常发布首选
kubectl apply -f ./manifests/批量应用目录下全部 YAML
kubectl apply -f deploy.yaml --dry-run=server服务端校验 YAML 是否能被正确接受
kubectl create deployment web --image=nginx --dry-run=client -o yaml > web.yaml生成 YAML 模板,再按需修改字段
kubectl get deploy web -o yaml > web-online.yaml导出现网配置,便于比对与备份
kubectl diff -f deploy.yaml对比文件与集群实际状态差异
kubectl delete -f deploy.yaml按文件删除资源
kubectl label pod web-xxx env=prod给资源打标签(--overwrite 覆盖已有值)
kubectl annotate deploy web note=hotfix添加注解,记录变更说明
kubectl edit deployment web在线编辑资源,保存后立即生效
kubectl patch svc web -p "{\"spec\":{\"type\":\"NodePort\"}}"用 patch 局部修改资源字段
kubectl kustomize overlays/prod渲染 Kustomize 结果,确认合并后的最终 YAML
kubectl apply -k overlays/prod应用 Kustomize 目录
kubectl get all -n prod一览命名空间内的常用资源(不含 ConfigMap/Secret 等)
命令说明复制
kubectl describe pod web-xxx | tail -30直接看事件区,多数异常原因都在这里
kubectl get pod web-xxx -o jsonpath="{.status.containerStatuses[*].state}"查看容器状态与退出码,定位崩溃原因
kubectl get pod web-xxx -o jsonpath="{.status.containerStatuses[*].lastState.terminated.exitCode}"查看上次退出码(137 多为 OOMKilled 或强杀)
kubectl logs web-xxx -p --tail=100崩溃前的日志,排查启动失败最关键
kubectl get events --field-selector involvedObject.name=web-xxx只看某个 Pod 相关事件
kubectl get pod web-xxx -o jsonpath="{.spec.nodeName}"确认 Pod 被调度到哪个节点,再查该节点
kubectl describe node node-1 | grep -A10 "Allocated resources"查看节点资源已分配量,判断是否资源不足
kubectl top pod -n prod --containers按容器维度查看资源占用
kubectl get pods -o wide | grep -v Running快速筛出非 Running 状态的 Pod
kubectl exec -it web-xxx -- nslookup kubernetes.default验证集群 DNS 是否正常
kubectl get endpoints webService 无法访问时先确认后端是否有 IP
kubectl run tmp-dns --rm -it --image=busybox:1.36 -- nslookup web.prod.svc临时 Pod 验证服务发现
kubectl debug node/node-1 -it --image=busybox进入节点命名空间排查系统层面问题
kubectl get leases -n kube-node-lease查看节点心跳租约,判断节点是否失联
kubectl -n kube-system logs deploy/coredns --tail=100查看 CoreDNS 日志,排查集群解析问题
kubectl -n kube-system describe pod -l k8s-app=kube-proxy检查 kube-proxy 是否正常,排查 Service 转发异常
命令说明复制
kubectl delete pod web-xxx删除 Pod,由控制器自动重建
kubectl delete pod web-xxx --grace-period=0 --force强制删除卡在 Terminating 的 Pod
kubectl delete deploy web删除 Deployment 及其 Pod
kubectl delete pods -l app=web按标签批量删除 Pod,实现整体重启
kubectl delete all -l env=test -n test按标签批量清理测试环境资源
kubectl delete ns test删除整个命名空间(资源全部回收,高危)
kubectl delete pod --field-selector status.phase=Succeeded清理已成功完成的 Pod
kubectl wait --for=condition=Ready pod -l app=web --timeout=120s等待 Pod 就绪,适合脚本与流水线
kubectl wait --for=condition=Available deploy/web --timeout=180s等待 Deployment 可用,判断发布结果
kubectl replace --force -f deploy.yaml重建资源方式应用配置(会短暂中断)
kubectl get pods --no-headers | wc -l统计 Pod 数量,配合脚本做巡检
kubectl get pods -o custom-columns=NAME:.metadata.name,NODE:.spec.nodeName自定义列输出,便于统计节点分布

常用命令组合

一个 Pod 全套排查kubectl get pod <pod> -o wide && kubectl describe pod <pod> | tail -30 && kubectl logs <pod> --tail=200 && kubectl logs <pod> -p --tail=100
发布与回滚kubectl set image deployment/web nginx=nginx:1.28 && kubectl rollout status deployment/web && kubectl rollout undo deployment/web
生成 YAML 模板kubectl create deployment web --image=nginx:1.27 --replicas=2 --dry-run=client -o yaml > web.yaml
服务不通快速定位kubectl get endpoints <svc> && kubectl get pods -l app=<app> -o wide && kubectl run tmp --rm -it --image=curlimages/curl -- curl -sv http://<svc>.<ns>.svc
节点维护流程kubectl cordon <node> && kubectl drain <node> --ignore-daemonsets --delete-emptydir-data && kubectl uncordon <node>

典型异常排查思路

1. CrashLoopBackOff

容器启动即退出:kubectl logs -p 看上次日志,重点查配置、依赖与启动命令

2. ImagePullBackOff

镜像拉取失败:核对镜像名/标签、imagePullSecrets 与仓库网络

3. Pending

调度失败:describe pod 看事件,多为资源不足、节点亲和冲突或 PVC 未绑定

4. OOMKilled(137)

内存超限被内核杀掉:调大 requests/limits,或排查内存泄漏

5. Service 访问不通

先查 endpoints 是否为空,再看标签选择器、容器端口与 NetworkPolicy

6. 集群内 DNS 异常

起 netshoot/busybox 验证解析,查 CoreDNS 与 kube-proxy 状态

共 138 条 kubectl 命令 · 按 Ctrl+F 或上方搜索框快速定位

关于K8S命令速查

在线 Kubernetes 命令速查手册,按集群与上下文、Pod 查看调试、工作负载发布、Service 与 Ingress、配置与密钥、存储卷、命名空间与权限、排障排查、YAML 管理、批量清理等 10 类场景整理 120+ 条常用 kubectl 命令,每条附中文说明与典型用法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅,无需安装任何环境。涵盖 kubectl get、describe、logs、exec、port-forward、apply、delete、rollout status/undo、scale、set image、expose、create secret、top pod、drain、cordon、cordon/uncordon、auth can-i、config use-context 等高频命令,并附 CrashLoopBackOff、ImagePullBackOff、Pending、OOMKilled、Service 无 Endpoints 等典型异常排查思路。适用于 K8s 集群日常运维、应用发布与回滚、故障定位、YAML 编写校验,以及 CKA/CKS 认证与云原生面试复习。

核心能力

  • 涵盖 kubectl get、describe、logs、exec、port-forward、apply、delete、rollout status/undo、scale、set image、expose、create secret、top pod、drain、cordon、cordon/uncordon、auth can-i、config use-context 等高频命令,并附 CrashLoopBackOff、ImagePullBackOff、Pending、OOMKilled、Service 无 Endpoints 等典型异常排查思路

适用场景

适用于 K8s 集群日常运维、应用发布与回滚、故障定位、YAML 编写校验,以及 CKA/CKS 认证与云原生面试复习。K8S命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

K8S命令速查是免费的吗?需要注册或安装吗?
K8S命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
K8S命令速查支持哪些功能?
涵盖 kubectl get、describe、logs、exec、port-forward、apply、delete、rollout status/undo、scale、set image、expose、create secret、top pod、drain、cordon、cordon/uncordon、auth can-i、config use-context 等高频命令,并附 CrashLoopBackOff、ImagePullBackOff、Pending、OOMKilled、Service 无 Endpoints 等典型异常排查思路。
K8S命令速查适合哪些场景使用?
适用于 K8s 集群日常运维、应用发布与回滚、故障定位、YAML 编写校验,以及 CKA/CKS 认证与云原生面试复习。