本文列出了常见的Kubectl命令,使用时确保将<namespace>、<pod-name>、<deployment-name>等占位符替换为你的集群和用例的实际值。

集群信息类

显示 Kubernetes 版本:kubectl version

显示集群信息:kubectl cluster-info

列出集群中的所有节点:kubectl get nodes

查看一个具体的节点详情:kubectl describe node <node-name>

列出所有命名空间:kubectl get namespaces

列出所有命名空间中的所有 pod:kubectl get pods --all-namespaces

Pod诊断类

列出特定命名空间中的pod:kubectl get pods -n <namespace>

查看一个Pod详情:kubectl describe pod <pod-name> -n <namespace>

查看Pod日志:kubectl logs <pod-name> -n <namespace>

尾部Pod日志:kubectl logs -f <pod-name> -n <namespace>

在pod中执行命令:kubectl exec -it <pod-name> -n <namespace> -- <command>

检查Pod准备情况:kubectl get pods <pod-name> -n <namespace> -o jsonpath='{.status.conditions[?(@.type=="Ready")].status}'

检查Pod事件:kubectl get events -n <namespace> --field-selector involvedObject.name=<pod-name>

Service诊断类

列出命名空间中的所有服务:kubectl get svc -n <namespace>

查看一个服务详情:kubectl describe svc <service-name> -n <namespace>

Deployment诊断类

列出命名空间中的所有Deployment:kubectl get deployments -n <namespace>

查看一个Deployment详情:kubectl describe deployment <deployment-name> -n <namespace>

查看滚动发布状态:kubectl rollout status deployment/<deployment-name> -n <namespace>

查看滚动发布历史记录:kubectl rollout history deployment/<deployment-name> -n <namespace>

StatefulSet诊断类

列出命名空间中的所有StatefulSet:kubectl get statefulsets -n <namespace>

查看一个StatefulSet详情:kubectl describe statefulset <statefulset-name> -n <namespace>

ConfigMap和Secret诊断类

列出命名空间中的 ConfigMap:kubectl get configmaps -n <namespace>

查看一个ConfigMap详情:kubectl describe configmap <configmap-name> -n <namespace>

列出命名空间中的 Secret:kubectl get secrets -n <namespace>

查看一个Secret详情:kubectl describe secret <secret-name> -n <namespace>

命名空间诊断类

查看一个命名空间详情:kubectl describe namespace <namespace-name>

资源使用情况类

检查 pod 的资源使用情况:kubectl top pod <pod-name> -n <namespace>

检查节点资源使用情况:kubectl top nodes

网络诊断类

显示命名空间中Pod的IP地址:kubectl get pods -n <namespace> -o custom-columns=POD:metadata.name,IP:status.podIP --no-headers

列出命名空间中的所有网络策略:kubectl get networkpolicies -n <namespace>

查看一个网络策略详情:kubectl describe networkpolicy <network-policy-name> -n <namespace>

持久卷 (PV) 和持久卷声明 (PVC) 诊断类

列出PV:kubectl get pv

查看一个PV详情:kubectl describe pv <pv-name>

列出命名空间中的PVC:kubectl get pvc -n <namespace>

查看PVC详情:kubectl describe pvc <pvc-name> -n <namespace>

节点诊断类

获取特定节点上运行的Pod列表:kubectl get pods --field-selector spec.nodeName=<node-name> -n <namespace>

资源配额和限制类

列出命名空间中的资源配额:kubectl get resourcequotas -n <namespace>

查看一个资源配额详情:kubectl describe resourcequota <resource-quota-name> -n <namespace>

自定义资源定义 (CRD) 诊断类

列出命名空间中的自定义资源:kubectl get <custom-resource-name> -n <namespace>

查看自定义资源详情:kubectl describe <custom-resource-name> <custom-resource-instance-name> -n <namespace>

资源伸缩和自动伸缩类

Deployment伸缩:kubectl scale deployment <deployment-name> --replicas=<replica-count> -n <namespace>

设置Deployment的自动伸缩:kubectl autoscale deployment <deployment-name> --min=<min-pods> --max=<max-pods> --cpu-percent=<cpu-percent> -n <namespace>

检查水平伸缩器状态:kubectl get hpa -n <namespace>

作业和CronJob诊断类

列出命名空间中的所有作业:kubectl get jobs -n <namespace>

查看一份工作详情:kubectl describe job <job-name> -n <namespace>

列出命名空间中的所有cron作业:kubectl get cronjobs -n <namespace>

查看一个cron作业详情:kubectl describe cronjob <cronjob-name> -n <namespace> 容量诊断:

列出按容量排序的持久卷 (PV):kubectl get pv --sort-by=.spec.capacity.storage

查看PV回收策略:kubectl get pv <pv-name> -o=jsonpath='{.spec.persistentVolumeReclaimPolicy}'

列出所有存储类别:kubectl get storageclasses

Ingress和服务网格诊断类

列出命名空间中的所有Ingress:kubectl get ingress -n <namespace>

查看一个Ingress详情:kubectl describe ingress <ingress-name> -n <namespace>

列出命名空间中的所有VirtualServices(Istio):kubectl get virtualservices -n <namespace>

查看一个VirtualService(Istio)详情:kubectl describe virtualservice <virtualservice-name> -n <namespace>

Pod网络诊断类

运行网络诊断Pod(例如 busybox)进行调试:kubectl run -it --rm --restart=Never --image=busybox net-debug-pod -- /bin/sh

测试从Pod到特定端点的连接:kubectl exec -it <pod-name> -n <namespace> -- curl <endpoint-url>

跟踪从一个Pod到另一个Pod的网络路径:kubectl exec -it <source-pod-name> -n <namespace> -- traceroute <destination-pod-ip>

检查Pod的DNS解析:kubectl exec -it <pod-name> -n <namespace> -- nslookup <domain-name>

配置和资源验证类

验证Kubernetes YAML文件而不应用它:kubectl apply --dry-run=client -f <yaml-file>

验证pod的安全上下文和功能:kubectl auth can-i list pods --as=system:serviceaccount:<namespace>:<serviceaccount-name>

RBAC和安全类

列出命名空间中的角色和角色绑定:kubectl get roles,rolebindings -n <namespace>

查看角色或角色绑定详情:kubectl describe role <role-name> -n <namespace>

服务帐户诊断类

列出命名空间中的服务帐户:kubectl get serviceaccounts -n <namespace>

查看一个服务帐户详情:kubectl describe serviceaccount <serviceaccount-name> -n <namespace>

排空节点和解除封锁

排空节点以进行维护:kubectl drain <node-name> --ignore-daemonsets

解除对节点的封锁:kubectl uncordon <node-name>

资源清理类

强制删除 pod(不推荐):kubectl delete pod <pod-name> -n <namespace> --grace-period=0 --force

Pod亲和性和反亲和性

列出 pod 的 pod 亲和性规则:kubectl get pod <pod-name> -n <namespace> -o=jsonpath='{.spec.affinity}'

列出 pod 的 pod 反亲和性规则:kubectl get pod <pod-name> -n <namespace> -o=jsonpath='{.spec.affinity.podAntiAffinity}'

Pod安全策略 (PSP)

列出所有Pod安全策略(如果启用):kubectl get psp

事件类

查看最近的集群事件:kubectl get events --sort-by=.metadata.creationTimestamp

按特定命名空间过滤事件:kubectl get events -n <namespace>

节点故障排除

检查节点情况:kubectl describe node <node-name> | grep Conditions -A5

列出节点容量和可分配资源:kubectl describe node <node-name> | grep -E "Capacity|Allocatable"

临时容器(Kubernetes 1.18+):

运行临时调试容器:kubectl debug -it <pod-name> -n <namespace> --image=<debug-image> -- /bin/sh

资源指标(需要指标服务器)

获取Pod的CPU和内存使用情况:kubectl top pod -n <namespace>

kuelet诊断

查看节点上的kubelet日志:`kubectl logs -n kube-system kubelet-<node-name>``

使用Telepresence 进行高级调试

使用Telepresence调试pod:telepresence --namespace <namespace> --swap-deployment <pod-name>

Kubeconfig和上下文

列出可用的上下文:kubectl config get-contexts

切换到不同的上下文:kubectl config use-context <context-name>

Pod安全标准(PodSecurity 准入控制器)类

列出PodSecurityPolicy (PSP) 违规行为:kubectl get psp -A | grep -vE 'NAME|REVIEWED'

Pod中断预算 (PDB) 诊断类

列出命名空间中的所有PDB:kubectl get pdb -n <namespace>

查看一个PDB详情:kubectl describe pdb <pdb-name> -n <namespace>

资源锁诊断(如果使用资源锁)

列出命名空间中的资源锁:kubectl get resourcelocks -n <namespace>

服务端点和DNS

列出服务的服务端点:kubectl get endpoints <service-name> -n <namespace>

检查Pod中的DNS配置:kubectl exec -it <pod-name> -n <namespace> -- cat /etc/resolv.conf

自定义指标(Prometheus、Grafana)

查询Prometheus指标:用于kubectl port-forward访问Prometheus和Grafana服务来查询自定义指标。

Pod 优先级和抢占

列出优先级:kubectl get priorityclasses

Pod开销(Kubernetes 1.18+)

列出 pod 中的开销:kubectl get pod <pod-name> -n <namespace> -o=jsonpath='{.spec.overhead}'

存储卷快照诊断(如果使用存储卷快照)

列出存储卷快照:kubectl get volumesnapshot -n <namespace>

查看存储卷快照详情:kubectl describe volumesnapshot <snapshot-name> -n <namespace>

资源反序列化诊断

反序列化并打印Kubernetes资源:kubectl get <resource-type> <resource-name> -n <namespace> -o=json

节点污点

列出节点污点:kubectl describe node <node-name> | grep Taints

更改和验证 Webhook 配置

列出变异 webhook 配置:kubectl get mutatingwebhookconfigurations

列出验证 Webhook 配置:kubectl get validatingwebhookconfigurations

节点条件(Kubernetes 1.17+)

自定义查询输出:kubectl get nodes -o custom-columns=NODE:.metadata.name,READY:.status.conditions[?(@.type=="Ready")].status -l 'node-role.kubernetes.io/worker='

审核日志

检索审核日志(如果启用):检查 Kubernetes 审核日志配置以了解审核日志的位置。

节点操作系统详细信息

获取节点的操作系统信息:kubectl get node <node-name> -o jsonpath='{.status.nodeInfo.osImage}'