4. CRI 核心接口详解：RuntimeService 与 ImageService 的 RPC 方法、关键参数与返回结构

CRI（Container Runtime Interface）是 kubelet 与容器运行时之间的核心 gRPC 协议。它定义了 RuntimeService（容器与 Pod 生命周期管理）和 ImageService（镜像管理）两大服务。理解每个 RPC 方法的语义、参数约束与返回结构，是进行性能调优和故障排查的基础。

4.1 RuntimeService：Pod 与容器生命周期管理

RuntimeService 负责管理 Pod 沙箱（Sandbox）和容器的完整生命周期。kubelet 通过以下核心 RPC 方法与运行时交互。

4.2 ImageService：镜像生命周期管理

ImageService 负责镜像的拉取、列表、状态查询和删除。这些操作通常涉及网络 I/O 和磁盘 I/O，是集群启动和扩缩容时的关键性能路径。

4.3 关键返回结构详解

理解返回结构中的字段，有助于诊断运行时状态和性能问题。

4.3.1 ContainerStatus 返回结构

message ContainerStatus {
  string id = 1;                    // 容器 ID
  ContainerState state = 2;         // CONTAINER_CREATED, RUNNING, EXITED, UNKNOWN
  google.protobuf.Timestamp created_at = 3;
  google.protobuf.Timestamp started_at = 4;
  google.protobuf.Timestamp finished_at = 5;
  int32 exit_code = 6;              // 退出码
  string reason = 7;                // 退出原因（如 OOMKilled, Error）
  string message = 8;               // 详细错误信息
  repeated Mount mount = 9;         // 当前挂载点
  map<string, string> labels = 10;
  map<string, string> annotations = 11;
  map<string, string> info = 12;   // 扩展信息（Verbose=true 时填充）
}

4.3.2 PodSandboxStatus 返回结构

message PodSandboxStatus {
  string id = 1;
  PodSandboxState state = 2;        // SANDBOX_READY, SANDBOX_NOTREADY
  google.protobuf.Timestamp created_at = 3;
  NetworkStatus network = 4;        // IP 地址、DNS 配置
  LinuxPodSandboxStatus linux = 5;  // 命名空间路径
  map<string, string> labels = 6;
  map<string, string> annotations = 7;
  map<string, string> info = 8;
}

4.3.3 Image 返回结构

message Image {
  string id = 1;                    // 镜像 ID（digest）
  repeated string repo_tags = 2;    // 如 ["nginx:latest", "nginx:1.21"]
  repeated string repo_digests = 3; // 如 ["nginx@sha256:abc..."]
  uint64 size = 4;                  // 镜像大小（字节）
  string uid = 5;                   // 用户 ID
  string username = 6;              // 用户名
  map<string, string> spec = 7;    // 镜像配置
}

4.4 CRI 核心接口调用流程（SVG 架构图）

4.5 性能调优关键指标与监控

针对上述 RPC 方法，建议在 kubelet 和运行时侧采集以下指标，用于识别性能瓶颈：

4.6 返回结构中的性能关键字段

在调优时，应特别关注返回结构中的以下字段：

• ContainerStatus.state：状态转换延迟（从 CONTAINER_CREATED 到 RUNNING）是衡量容器启动性能的核心指标。
• ContainerStatus.started_at / finished_at：用于计算容器运行时长和重启频率。
• ContainerStatus.exit_code：非零退出码（如 137=OOMKilled, 139=Segfault）指示资源或代码问题。
• PodSandboxStatus.network.ip：IP 分配延迟（通常由 CNI 插件引起）。
• Image.size：镜像大小直接影响拉取和容器启动时间。
• ImageFsInfo.ImageFilesystems：磁盘空间不足会导致镜像拉取失败或容器启动失败。