容器与云原生 / 系统课时
事件与资源详情
事件与资源详情
当 Pod 处于 Pending、ImagePullBackOff 或反复启动失败时,只看状态名称通常不够。本课将把资源详情和 Event 按固定顺序组合起来,快速定位失败发生在哪个阶段。
学习目标
- 能从
kubectl describe中识别状态、条件和最近事件 - 能按时间和关联对象筛选命名空间内的 Event
- 能区分调度、镜像拉取与容器启动失败的主要线索
构造镜像拉取失败场景
下面创建一个引用无效镜像地址的 Pod,用于稳定观察 ErrImagePull 与 ImagePullBackOff。保存为 image-pull-demo.yaml。
apiVersion: v1
kind: Pod
metadata:
name: image-pull-demo
spec:
containers:
- name: app
image: registry.invalid/demo/app:v1
command: ["sh", "-c", "sleep 3600"]执行创建命令:
kubectl apply -f image-pull-demo.yaml预期输出:
pod/image-pull-demo created稍等片刻后查看状态:
kubectl get pod image-pull-demo预期输出:
NAME READY STATUS RESTARTS AGE
image-pull-demo 0/1 ImagePullBackOff 0 <TIME>状态可能暂时显示 Pending 或 ErrImagePull,随后进入带退避重试的 ImagePullBackOff。
用资源详情建立上下文
kubectl describe 会把对象规格、运行状态、条件、容器状态和相关 Event 汇总到同一视图。排查时先确认对象名称与命名空间,再从上到下读取。
kubectl describe pod image-pull-demo预期输出节选:
Name: image-pull-demo
Namespace: default
Node: <NODE>
Containers:
app:
Image: registry.invalid/demo/app:v1
State: Waiting
Reason: ImagePullBackOff
Conditions:
Initialized: True
Ready: False
ContainersReady: False
PodScheduled: True
Events:
Type Reason Age From Message
Normal Scheduled <TIME> default-scheduler Successfully assigned default/image-pull-demo to <NODE>
Warning Failed <TIME> kubelet Failed to pull image "registry.invalid/demo/app:v1": <DETAIL>
Warning BackOff <TIME> kubelet Back-off pulling image "registry.invalid/demo/app:v1"这里的关键判断是:PodScheduled=True 说明调度已经完成,失败发生在节点拉取镜像阶段;State=Waiting 和 Reason=ImagePullBackOff 则表明容器尚未真正启动。不同运行时和网络环境产生的 <DETAIL> 会不同。
单独查询并排序 Event
Event 是命名空间级资源,默认查询当前命名空间。按创建时间排序并限定关联对象,可以去掉无关噪声。
kubectl get events --sort-by=.metadata.creationTimestamp --field-selector involvedObject.name=image-pull-demo预期输出:
LAST SEEN TYPE REASON OBJECT MESSAGE
<TIME> Normal Scheduled pod/image-pull-demo Successfully assigned default/image-pull-demo to <NODE>
<TIME> Warning Failed pod/image-pull-demo Failed to pull image "registry.invalid/demo/app:v1": <DETAIL>
<TIME> Warning BackOff pod/image-pull-demo Back-off pulling image "registry.invalid/demo/app:v1"Event 可能被合并计数,也会按集群配置在一段时间后过期,因此它适合定位近期控制面和节点动作,不应被当作永久审计日志。
按失败阶段定位
遇到 Pending 时,先看 PodScheduled 条件和 FailedScheduling Event。常见原因包括资源不足、节点选择器不匹配、污点未容忍或 PVC 尚未绑定。
遇到 ErrImagePull 或 ImagePullBackOff 时,重点检查镜像名称、标签、仓库网络、认证 Secret 和节点到仓库的连通性。若 Event 显示未授权,应核对 imagePullSecrets;若显示名称解析或超时,应继续检查 DNS、代理和防火墙。
遇到 CrashLoopBackOff 时,说明镜像已拉取且容器至少启动过一次。此时应结合容器 Last State、退出码、重启次数以及 kubectl logs --previous 判断进程为何退出,而不是继续排查调度器。
修复并验证
将镜像改为可拉取的版本后重新应用,再等待 Pod 就绪。
kubectl set image pod/image-pull-demo app=busybox:1.36
kubectl wait --for=condition=Ready pod/image-pull-demo --timeout=60s预期输出:
pod/image-pull-demo image updated
pod/image-pull-demo condition met最后确认状态并清理资源。
kubectl get pod image-pull-demo
kubectl delete pod image-pull-demo预期输出:
NAME READY STATUS RESTARTS AGE
image-pull-demo 1/1 Running 0 <TIME>
pod "image-pull-demo" deleted实际 AGE 和命令完成时间会因集群环境不同而变化。