kubectl describe
查看资源的详细信息,包括事件、状态和配置
语法
kubectl describe <resource> [name] [flags]
参数
| 参数 | 说明 | 示例 | 级别 |
|---|---|---|---|
-n --namespace |
指定命名空间 | kubectl describe pod nginx -n production |
常用 |
-l --selector |
按标签选择资源 | kubectl describe pods -l app=web |
常用 |
--show-events |
是否显示事件(默认 true) | kubectl describe pod nginx --show-events=false |
进阶 |
示例
查看 Pod 详情
kubectl describe pod nginx-7d9b8c5f6-x2k4m
包含容器状态、事件、挂载等完整信息
查看节点详情
kubectl describe node worker-1
查看节点资源分配、污点、条件等
查看 Service 详情
kubectl describe svc my-service
查看端口映射、Endpoints 等
查看 Deployment 事件
kubectl describe deployment web-app
排查部署失败时查看 Events 部分
常见错误
Error from server (NotFound)
确认资源名称和命名空间是否正确,用 kubectl get 先确认
技巧
- 排查问题时重点看输出底部的 Events 部分
- describe node 可以看到节点的资源使用情况和可分配资源