容器与云原生 / 系统课时

事件与资源详情

事件与资源详情

当 Pod 处于 Pending、ImagePullBackOff 或反复启动失败时,只看状态名称通常不够。本课将把资源详情和 Event 按固定顺序组合起来,快速定位失败发生在哪个阶段。

学习目标

  • 能从 kubectl describe 中识别状态、条件和最近事件
  • 能按时间和关联对象筛选命名空间内的 Event
  • 能区分调度、镜像拉取与容器启动失败的主要线索

构造镜像拉取失败场景

下面创建一个引用无效镜像地址的 Pod,用于稳定观察 ErrImagePull 与 ImagePullBackOff。保存为 image-pull-demo.yaml。

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"]

执行创建命令:

bash
kubectl apply -f image-pull-demo.yaml

预期输出:

text
pod/image-pull-demo created

稍等片刻后查看状态:

bash
kubectl get pod image-pull-demo

预期输出:

text
NAME              READY   STATUS             RESTARTS   AGE
image-pull-demo   0/1     ImagePullBackOff   0          <TIME>

状态可能暂时显示 Pending 或 ErrImagePull,随后进入带退避重试的 ImagePullBackOff。

用资源详情建立上下文

kubectl describe 会把对象规格、运行状态、条件、容器状态和相关 Event 汇总到同一视图。排查时先确认对象名称与命名空间,再从上到下读取。

bash
kubectl describe pod image-pull-demo

预期输出节选:

text
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 是命名空间级资源,默认查询当前命名空间。按创建时间排序并限定关联对象,可以去掉无关噪声。

bash
kubectl get events --sort-by=.metadata.creationTimestamp --field-selector involvedObject.name=image-pull-demo

预期输出:

text
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 就绪。

bash
kubectl set image pod/image-pull-demo app=busybox:1.36
kubectl wait --for=condition=Ready pod/image-pull-demo --timeout=60s

预期输出:

text
pod/image-pull-demo image updated
pod/image-pull-demo condition met

最后确认状态并清理资源。

bash
kubectl get pod image-pull-demo
kubectl delete pod image-pull-demo

预期输出:

text
NAME              READY   STATUS    RESTARTS   AGE
image-pull-demo   1/1     Running   0          <TIME>
pod "image-pull-demo" deleted

实际 AGE 和命令完成时间会因集群环境不同而变化。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

事件与资源详情

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通