Kubernetes（K8s）全场景命令宝典：从新手入门到故障排查全覆盖
本文整合 K8s 核心资源操作、集群管理、运维优化、故障定位等全场景命令。
一、新手入门：核心基础操作
聚焦 “查看 - 创建 - 删除” 核心流程，帮助新手快速建立 K8s 资源认知，覆盖 Pod、Deployment、Service 等高频资源。
1. 集群与节点基础
kubectl cluster-info：查看集群基本信息（API Server、CoreDNS 地址，确认集群连通性）。
kubectl get nodes：列出所有节点状态（Ready 为正常，加 -o wide 显示节点 IP、操作系统）。
kubectl get ns：查看所有命名空间（常用 default（默认）、kube-system（系统组件）、kube-public（公共资源））。
kubectl config set-context --current --namespace=<命名空间名>：切换默认命名空间（后续命令无需重复加 -n）。2. Pod 基础操作
- 查看与筛选：
kubectl get pods：查看当前命名空间下所有 Pod。
kubectl get pods -n <命名空间>：查看指定命名空间 Pod（如 kubectl get pods -n kube-system）。
kubectl get pods -l <标签键>=<标签值>：按标签筛选 Pod（如 kubectl get pods -l app=nginx）。
kubectl get pods -o wide：显示 Pod 节点位置、IP、容器镜像等详情。- 创建与删除：
kubectl run <Pod名> --image=<镜像名>：快速创建单 Pod（如 kubectl run nginx-pod --image=nginx:1.24）。
kubectl create pod <Pod名> --image=<镜像名> --port=<端口>：指定端口创建 Pod（如 kubectl create pod nginx-pod --image=nginx:1.24 --port=80）。
kubectl apply -f <Pod.yaml>：通过 YAML 文件创建 Pod（生产推荐，配置更灵活）。
kubectl delete pod <Pod名>：删除指定 Pod（Deployment 管理的 Pod 会自动重建）。
kubectl delete pod <Pod名> --grace-period=0 --force：强制删除无响应的 Pod（跳过优雅退出）。
kubectl delete pods --all：删除当前命名空间所有 Pod（谨慎使用）。
kubectl delete pods -l <标签键>=<标签值>：按标签批量删除 Pod（如 kubectl delete pods -l app=nginx）。- 交互与调试：
kubectl logs <Pod名>：查看 Pod 日志（默认最新日志，排查启动失败）。
kubectl exec -it <Pod名> -- /bin/bash：进入 Pod 容器终端（如查看 Nginx 配置：cat /etc/nginx/nginx.conf）。
kubectl exec -it <Pod名> -c <容器名> -- /bin/bash：多容器 Pod 指定容器进入终端。
kubectl port-forward <Pod名> <本地端口>:<容器端口>：本地端口转发（如 kubectl port-forward nginx-pod 8080:80，访问 localhost:8080 测试服务）。
kubectl cp <本地文件路径> <命名空间>/<Pod名>:<容器内路径>：本地文件复制到 Pod（如 kubectl cp./test.txt default/nginx-pod:/tmp/）。
kubectl cp <命名空间>/<Pod名>:<容器内路径> <本地文件路径>：从 Pod 复制文件到本地。3. Deployment 基础操作
kubectl get deploy 或 kubectl get deployments：查看当前命名空间下的 Deployment。
kubectl get deploy <Deployment名> -o wide：查看指定 Deployment 详情（副本数、可用数、镜像）。
kubectl create deployment <Deployment名> --image=<镜像名>：快速创建 Deployment（如 kubectl create deployment nginx-deploy --image=nginx:1.24）。
kubectl create deployment <Deployment名> --image=<镜像名> --replicas=<副本数>：指定副本数创建（如 --replicas=3 实现高可用）。
kubectl apply -f <Deployment.yaml>：通过 YAML 创建 / 更新 Deployment。
kubectl delete deploy <Deployment名>：删除 Deployment（关联 Pod 会自动删除）。4. Service 与 Ingress 基础
kubectl get svc 或 kubectl get services：查看当前命名空间下的 Service。
kubectl get svc <Service名> -o wide：查看指定 Service 详情（ClusterIP、端口映射、关联 Pod）。
kubectl create svc clusterip <Service名> --tcp=<容器端口>:<Service端口>：创建 ClusterIP Service（集群内部访问，如 kubectl create svc clusterip nginx-svc --tcp=80:80）。
kubectl expose deploy <Deployment名> --type=NodePort --port=80：通过 Deployment 创建 NodePort Service（暴露服务到集群外部，节点 IP+NodePort 访问）。
kubectl get ingress 或 kubectl get ing：查看当前命名空间下的 Ingress 规则（需提前部署 Ingress Controller，如 nginx-ingress）。
kubectl apply -f <Ingress.yaml>：通过 YAML 创建 Ingress 规则。
kubectl delete ingress <Ingress名>：删除 Ingress 规则。二、运维进阶：资源管理与集群优化
覆盖节点调度、存储配置、版本控制、资源配额等运维核心场景，保障集群稳定高效运行。
1. 节点管理与调度
kubectl cordon <节点名>：标记节点为 “不可调度”（避免新 Pod 调度到待维护节点）。
kubectl uncordon <节点名>：解除 “不可调度” 标记，恢复节点调度。
kubectl drain <节点名> --ignore-daemonsets --delete-emptydir-data：驱逐节点上所有 Pod（节点维护前执行，忽略 DaemonSet，删除 EmptyDir 临时数据）。
kubectl delete node <节点名>：从集群中删除节点（需先排空 Pod 或确认节点下线）。
kubectl describe node <节点名>：查看节点详细信息（资源使用、已调度 Pod、标签与污点）。
kubectl label nodes <节点名> <标签键>=<标签值>：为节点添加标签（用于 Pod 调度筛选，如 kubectl label nodes node-1 env=prod）。
kubectl label nodes <节点名> <标签键>-：删除节点指定标签（如 kubectl label nodes node-1 env-）。2. Deployment 高级操作
- 副本与镜像管理：
kubectl scale deploy <Deployment名> --replicas=<新副本数>：调整副本数（如 kubectl scale deploy nginx-deploy --replicas=5 应对流量高峰）。
kubectl set image deploy <Deployment名> <容器名>=<新镜像>：更新容器镜像（触发滚动更新，如 kubectl set image deploy nginx-deploy nginx=nginx:1.25）。- 版本控制与回滚：
kubectl rollout status deploy <Deployment名>：查看 Deployment 滚动更新状态。
kubectl rollout history deploy <Deployment名>：查看更新历史（每个版本的配置变更）。
kubectl rollout history deploy <Deployment名> --revision=<版本号>：查看指定版本的详细变更记录。
kubectl rollout undo deploy <Deployment名>：回滚到上一个版本。
kubectl rollout undo deploy <Deployment名> --to-revision=<版本号>：回滚到指定版本（需先通过 rollout history 查看版本号）。
kubectl pause deploy <Deployment名>：暂停更新（修改多配置时使用，避免频繁触发滚动更新），恢复用 kubectl resume deploy <Deployment名>。3. StatefulSet 与 DaemonSet 操作
- StatefulSet（有状态服务，如数据库、分布式存储）：
kubectl get sts 或 kubectl get statefulsets：查看当前命名空间下的 StatefulSet。
kubectl get sts <StatefulSet名> -o wide：查看指定 StatefulSet 详情（Pod 固定序号、关联 PVC）。
kubectl scale sts <StatefulSet名> --replicas=<新副本数>：有序调整副本数（有状态服务扩缩容）。
kubectl set image sts <StatefulSet名> <容器名>=<新镜像>：更新容器镜像（触发有序滚动更新）。
kubectl rollout status sts <StatefulSet名>：查看 StatefulSet 更新状态。
kubectl rollout undo sts <StatefulSet名>：回滚 StatefulSet 到上一个版本。
kubectl delete sts <StatefulSet名>：删除 StatefulSet（默认不删除关联 PVC，需手动清理）。
kubectl delete sts <StatefulSet名> --cascade=foreground：删除 StatefulSet 并优先清理关联 Pod。- DaemonSet（集群级守护进程，如日志收集、网络插件）：
kubectl get ds 或 kubectl get daemonsets：查看当前命名空间下的 DaemonSet。
kubectl get ds -n kube-system：查看系统级 DaemonSet（如 calico、kube-proxy、flannel）。
kubectl describe ds <DaemonSet名> -n <命名空间>：查看 DaemonSet 调度规则（节点选择器、容忍策略）。
kubectl set image ds <DaemonSet名> <容器名>=<新镜像> -n <命名空间>：更新 DaemonSet 容器镜像。
kubectl delete ds <DaemonSet名> -n <命名空间>：删除 DaemonSet（节点上的守护进程 Pod 会自动删除）。4. 配置与密钥管理
- ConfigMap（存储非敏感配置）：
kubectl get cm 或 kubectl get configmaps：查看当前命名空间下的 ConfigMap。
kubectl get cm <ConfigMap名> -o yaml：查看 ConfigMap 完整配置（键值对内容）。
kubectl describe cm <ConfigMap名>：查看 ConfigMap 详情（创建时间、数据项）。
kubectl create cm <ConfigMap名> --from-literal=<键1>=<值1> --from-literal=<键2>=<值2>：通过字面量创建（如 kubectl create cm app-config --from-literal=env=prod --from-literal=log_level=info）。
kubectl create cm <ConfigMap名> --from-file=<本地文件路径>：通过本地文件创建（如 kubectl create cm app-config --from-file=./app.conf）。
kubectl apply -f <ConfigMap.yaml>：通过 YAML 创建 ConfigMap。
kubectl delete cm <ConfigMap名>：删除 ConfigMap。- Secret（存储敏感信息）：
kubectl get secrets：查看当前命名空间下的 Secret。
kubectl get secret <Secret名> -o yaml：查看 Secret 配置（内容为 Base64 编码）。
kubectl get secret <Secret名> -o jsonpath='{.data.<键名>}' | base64 -d：解码 Secret 指定键值（如 kubectl get secret db-secret -o jsonpath='{.data.db-password}' | base64 -d）。
kubectl create secret generic <Secret名> --from-literal=<键1>=<值1>：创建通用 Secret（如 kubectl create secret generic db-secret --from-literal=db-user=root --from-literal=db-password=123456）。
kubectl create secret docker-registry <Secret名> --docker-server=<镜像仓库地址> --docker-username=<用户名> --docker-password=<密码>：创建镜像仓库认证 Secret（用于拉取私有镜像）。
kubectl create secret tls <Secret名> --cert=<证书文件路径> --key=<密钥文件路径>：创建 TLS 证书 Secret（用于 Ingress HTTPS 配置）。
kubectl apply -f <Secret.yaml>：通过 YAML 创建 Secret。
kubectl delete secret <Secret名>：删除 Secret。5. 存储卷（PV/PVC/StorageClass）操作
- PersistentVolume（PV，集群级存储资源）：
kubectl get pv 或 kubectl get persistentvolumes：查看集群所有 PV。
kubectl get pv <PV名> -o wide：查看指定 PV 详情（容量、访问模式、状态、存储类）。
kubectl describe pv <PV名>：查看 PV 详细信息（绑定的 PVC、存储后端配置、访问模式）。
kubectl apply -f <PV.yaml>：通过 YAML 创建 PV。
kubectl delete pv <PV名>：删除 PV（需确保 PV 状态为 Released 或 Available，否则加 --force 强制删除）。- PersistentVolumeClaim（PVC，Pod 存储申请）：
kubectl get pvc 或 kubectl get persistentvolumeclaims：查看当前命名空间下的 PVC。
kubectl get pvc <PVC名> -n <命名空间> -o wide：查看指定 PVC 详情（绑定的 PV、容量、状态）。
kubectl describe pvc <PVC名> -n <命名空间>：查看 PVC 绑定事件、存储需求（如容量、存储类、访问模式）。
kubectl apply -f <PVC.yaml>：通过 YAML 创建 PVC（自动绑定匹配的 PV）。
kubectl delete pvc <PVC名> -n <命名空间>：删除 PVC（默认释放关联 PV，PV 状态变为 Released）。- StorageClass（动态创建 PV）：
kubectl get sc 或 kubectl get storageclasses：查看集群所有 StorageClass。
kubectl get sc <StorageClass名> -o yaml：查看指定 StorageClass 配置（后端存储插件、参数、是否为默认存储类）。
kubectl describe sc <StorageClass名>：查看 StorageClass 详情（创建时间、参数说明）。
kubectl apply -f <StorageClass.yaml>：通过 YAML 创建 StorageClass。
kubectl delete sc <StorageClass名>：删除 StorageClass（需确保无关联 PVC 使用）。
kubectl patch sc <StorageClass名> -p '{"metadata":{"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'：设置默认 StorageClass（无需 PVC 指定存储类时自动使用）。6. 资源配额与限制范围
- ResourceQuota（资源配额）：
kubectl get quota 或 kubectl get resourcequotas：查看当前命名空间下的资源配额（限制 CPU、内存、PVC 等总使用量）。
kubectl describe quota <配额名> -n <命名空间>：查看资源配额详细配置（CPU / 内存限制、PVC 数量限制等）。
kubectl apply -f <ResourceQuota.yaml>：通过 YAML 创建资源配额。
kubectl delete quota <配额名> -n <命名空间>：删除资源配额。- LimitRange（限制范围）：
kubectl get limits 或 kubectl get limitranges：查看当前命名空间下的限制范围（为 Pod / 容器设置默认资源请求与限制）。
kubectl describe limits <限制名> -n <命名空间>：查看限制范围详细配置（Pod 默认 CPU / 内存请求、容器最大资源限制等）。
kubectl apply -f <LimitRange.yaml>：通过 YAML 创建限制范围。
kubectl delete limits <限制名> -n <命名空间>：删除限制范围。7. 运维实用工具命令
kubectl get <资源类型> <资源名> -o yaml > <备份文件>.yaml：备份资源配置（如 kubectl get deploy nginx-deploy -o yaml > nginx-deploy-backup.yaml）。
kubectl replace --force -f <资源文件>.yaml：强制替换资源（配置无法通过 apply 更新时使用，先删后建）。
kubectl wait --for=condition=Ready pod/<Pod名> --timeout=<时间>：等待 Pod 就绪（脚本化部署用，如 kubectl wait --for=condition=Ready pod/nginx-pod --timeout=60s）。
kubectl wait --for=condition=Available deploy/<Deployment名> --timeout=5m：等待 Deployment 达到 “可用” 状态。
kubectl api-versions：查看集群支持的所有 API 版本（如 apps/v1、networking.k8s.io/v1、v1）。
kubectl api-resources：查看集群支持的所有资源类型（含缩写、API 组、命名空间归属、是否可命名）。
kubectl explain <资源类型>：查看资源 API 文档（如 kubectl explain pod 查看 Pod 所有字段，kubectl explain pod.spec.containers 查看容器配置字段）。
kubectl get <资源类型> --all-namespaces：查看所有命名空间下的指定资源（如 kubectl get pods --all-namespaces 查看全集群 Pod）。
kubectl get <资源类型> -o jsonpath='{range.items[*]}{.metadata.name}{"\t"}{.status.<字段>}{"\n"}{end}'：自定义输出资源信息（如 kubectl get pods -o jsonpath='{range.items[*]}{.metadata.name}{"\t"}{.status.podIP}{"\n"}{end}' 输出 Pod 名与 IP）。
kubectl annotate pods <Pod名> <注解键>=<注解值>：为 Pod 添加注解（存储非筛选用元信息，如 kubectl annotate pods nginx-pod description="test environment pod"）。
kubectl annotate pods <Pod名> <注解键>-：删除 Pod 指定注解。三、故障排查：快速定位与解决问题
聚焦 Pod 异常、网络故障、存储问题、组件故障等场景，提供高效排查命令与方法。
1. Pod 故障排查
- 日志深度分析：
kubectl logs <Pod名> -f：实时跟踪 Pod 日志（类似 tail -f，查看实时报错）。
kubectl logs <Pod名> --tail=<行数>：查看最新 N 行日志（如 kubectl logs nginx-pod --tail=200 避免刷屏）。
kubectl logs <Pod名> --since=<时间>：查看指定时间内日志（如 --since=1h 查看 1 小时内日志，--since=30m 查看 30 分钟内日志）。
kubectl logs <Pod名> -c <容器名>：多容器 Pod 指定容器查看日志（如 kubectl logs nginx-pod -c sidecar）。
kubectl logs <Pod名> --previous 或 kubectl logs <Pod名> -p：查看 Pod 上一次启动的日志（排查 Pod 重启原因）。- Pod 详情与事件：
kubectl describe pod <Pod名> -n <命名空间>：查看 Pod 详细信息（核心排查命令，Events 字段显示故障原因，如 “镜像拉取失败”“挂载卷失败”“资源不足调度失败”）。
kubectl get events：查看当前命名空间下的所有集群事件（按时间排序，定位近期异常）。
kubectl get events -n <命名空间> --sort-by='.lastTimestamp'：按事件发生时间排序。
kubectl get events -n <命名空间> --field-selector=involvedObject.kind=Pod,involvedObject.name=<Pod名>：查看指定 Pod 的所有关联事件。
kubectl get events -n <命名空间> --field-selector=type=Warning：仅查看警告级别的事件（快速定位问题）。- 容器进程与文件：
kubectl exec -it <Pod名> -- ps aux：查看 Pod 内进程（确认进程是否正常启动，是否有僵尸进程）。
kubectl exec -it <Pod名> -- netstat -tuln：查看 Pod 内网络端口监听情况（排查端口占用）。
kubectl exec -it <Pod名> -- df -h：查看 Pod 内磁盘使用情况（排查磁盘满导致的异常）。
kubectl cp <命名空间>/<Pod名>:<容器内路径> <本地路径>：从 Pod 复制文件到本地（如复制日志文件、配置文件分析：kubectl cp default/nginx-pod:/var/log/nginx/error.log./）。2. 网络故障排查
kubectl exec -it <Pod名> -- ping <目标Pod IP>：测试 Pod 间网络连通性（排查集群网络插件故障，如 calico、flannel 异常）。
kubectl exec -it <Pod名> -- ping <目标节点IP>：测试 Pod 到节点的网络连通性。
kubectl exec -it <Pod名> -- curl <Service ClusterIP>:<端口>：测试 Pod 到 Service 的访问（确认 Service 是否关联 Pod，Endpoints 是否就绪）。
kubectl exec -it <Pod名> -- curl <Ingress域名>：测试 Pod 到 Ingress 域名的访问（排查 Ingress 规则是否生效）。
kubectl describe svc <Service名> -n <命名空间>：查看 Service 详情（检查 Endpoints 列表，确认 Pod IP 是否在列，若为空则 Service 未关联 Pod）。
kubectl get endpoints <Service名> -n <命名空间>：直接查看 Service 关联的 Endpoints（Pod IP: 端口列表）。
kubectl debug <Pod名> -it --image=nicolaka/netshoot：创建网络调试容器（内置 ping、traceroute、tcpdump、nslookup 等工具，排查 DNS 解析、路由异常）。
kubectl get svc kube-dns -n kube-system：查看 CoreDNS 服务状态（DNS 解析异常时，先确认 CoreDNS 是否正常运行）。
kubectl logs <CoreDNS Pod名> -n kube-system：查看 CoreDNS 日志（排查 DNS 解析失败原因）。3. 存储故障排查
kubectl exec -it <Pod名> -- df -h：查看 Pod 内磁盘挂载情况（确认 PVC 是否正常挂载，挂载路径是否正确，磁盘空间是否充足）。
kubectl exec -it <Pod名> -- ls <挂载路径>：检查挂载路径下是否有文件（确认存储挂载后可正常读写）。
kubectl describe pvc <PVC名> -n <命名空间>：查看 PVC 绑定状态（排查 PVC 无法绑定 PV 的原因，如 PV 资源不足、访问模式不匹配、存储类不匹配）。
kubectl describe pv <PV名>：查看 PV 存储后端配置（确认存储服务是否正常，如 NFS 共享目录是否存在、Ceph 集群是否连通、云存储卷是否可用）。
kubectl get pvc <PVC名> -o jsonpath='{.spec.volumeName}'：查看 PVC 绑定的 PV 名称（快速关联 PVC 与 PV，定位对应存储资源）。
kubectl get pv <PV名> -o jsonpath='{.status.phase}'：查看 PV 状态（Bound 为正常绑定，Pending 为待绑定，Released 为已释放但未清理）。
kubectl debug node <节点名> -it --image=busybox：在节点上创建调试 Pod（排查节点本地存储或远程存储挂载问题，如测试 NFS 挂载：mount -t nfs <NFS服务器IP>:<共享目录> /tmp/test）。4. 节点与资源监控
kubectl top nodes：查看所有节点 CPU、内存使用率（需部署 metrics-server，识别节点资源瓶颈，如 CPU 使用率过高、内存不足）。
kubectl top nodes <节点名>：查看指定节点资源使用详情（CPU / 内存使用率、Pod 总数、命名空间分布）。
kubectl top pods：查看当前命名空间下 Pod 的 CPU、内存使用情况（定位高资源消耗 Pod）。
kubectl top pods -n <命名空间>：查看指定命名空间下 Pod 的资源使用。
kubectl top pods <Pod名> -n <命名空间> --containers：查看指定 Pod 内每个容器的资源使用情况（精准定位高资源消耗的容器）。
kubectl describe node <节点名>：查看节点资源限制与已使用资源（如节点内存不足会导致 Pod 被驱逐，Events 字段会显示 “Evicted” 事件）。
kubectl get pods --field-selector=spec.nodeName=<节点名>,status.phase=Failed：查看指定节点上失败的 Pod（定位节点相关的 Pod 异常）。5. 集群组件故障排查
- 核心组件状态查看：
kubectl get cs 或 kubectl get componentstatuses：查看 K8s 核心组件（scheduler、controller-manager、etcd）状态（均为 Healthy 为正常）。
kubectl get pods -n kube-system：查看系统组件 Pod（如 kube-apiserver-<节点名>、kube-controller-manager-<节点名>、kube-scheduler-<节点名>、etcd-<节点名>、网络插件 Pod）。- 核心组件日志分析：
kubectl logs kube-apiserver-<节点名> -n kube-system：查看 API Server 日志（集群控制面核心，排查认证、授权、资源创建失败问题）。
kubectl logs kube-controller-manager-<节点名> -n kube-system：查看 Controller Manager 日志（排查控制器异常，如 Deployment、StatefulSet 无法创建 Pod）。
kubectl logs kube-scheduler-<节点名> -n kube-system：查看 Scheduler 日志（排查 Pod 调度失败原因，如节点污点、资源不足）。
kubectl logs etcd-<节点名> -n kube-system：查看 etcd 日志（排查集群数据存储异常，如数据损坏、集群脑裂）。- 配置与连通性校验：
kubectl config view：查看当前 K8s 配置文件（~/.kube/config）内容（确认集群地址、用户认证信息是否正确）。
kubectl config get-contexts：查看所有可用的 K8s 上下文（不同集群 / 用户的配置）。
kubectl config use-context <上下文名>：切换到指定的 K8s 上下文（如从测试集群切换到生产集群）。
kubectl cluster-info dump：导出集群详细信息（包含所有组件状态、配置、日志片段，用于深度排查）。
kubectl debug <Pod名> -it --image=busybox --share-processes --copy-to=<调试Pod名>：复制原 Pod 创建调试 Pod（共享进程空间，可查看原 Pod 进程、网络配置，不影响原 Pod 运行）。6. 其他排查命令
kubectl get pods -o jsonpath='{range.items[*]}{.metadata.name}{"\t"}{.status.phase}{"\t"}{.status.containerStatuses[0].ready}{"\n"}{end}'：批量查看 Pod 状态与容器就绪情况（快速定位集群内异常 Pod）。
kubectl api-resources --verbs=list --namespaced -o name | xargs -n 1 kubectl get --show-kind --ignore-not-found -n <命名空间>：查看指定命名空间下的所有资源（巡检资源残留，如未删除的 PVC、ConfigMap）。
kubectl get <资源类型> -n <命名空间> --sort-by='.metadata.creationTimestamp'：按资源创建时间排序（定位近期创建的异常资源）。
kubectl patch <资源类型> <资源名> -n <命名空间> -p '{"spec":{"<字段>":<值>}}'：临时修改资源配置（紧急排查时使用，如 kubectl patch pod nginx-pod -p '{"spec":{"restartPolicy":"Never"}}' 修改 Pod 重启策略）。