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 web | Service 无法访问时先确认后端是否有 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 | 自定义列输出,便于统计节点分布 |
常用命令组合
kubectl get pod <pod> -o wide && kubectl describe pod <pod> | tail -30 && kubectl logs <pod> --tail=200 && kubectl logs <pod> -p --tail=100kubectl set image deployment/web nginx=nginx:1.28 && kubectl rollout status deployment/web && kubectl rollout undo deployment/webkubectl create deployment web --image=nginx:1.27 --replicas=2 --dry-run=client -o yaml > web.yamlkubectl get endpoints <svc> && kubectl get pods -l app=<app> -o wide && kubectl run tmp --rm -it --image=curlimages/curl -- curl -sv http://<svc>.<ns>.svckubectl 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 状态
相关工具
Linux命令速查
文件、文本、权限、进程、网络、磁盘、systemd与防火墙等 Linux 常用命令速查手册
Docker命令速查
镜像、容器、网络、数据卷、Compose、Swarm、清理与排障等 Docker 常用命令速查手册
Nginx命令速查
服务管理、配置指令、反向代理、HTTPS、限流缓存、日志排查等 Nginx 常用命令速查手册
Windows CMD命令速查
文件目录、网络诊断、进程服务、系统信息、用户权限、注册表、批处理等 Windows CMD 常用命令速查手册
systemctl服务管理速查
服务启停、开机自启、unit文件编写、日志查看、定时器、依赖分析与排障等 systemctl 命令速查手册
Vim命令速查
模式切换、光标移动、编辑删除、搜索替换、寄存器宏、分屏窗口、配置与技巧等 Vim 常用命令速查手册
关于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 认证与云原生面试复习。