2. CSI 核心概念：三大服务接口定义与职责

CSI（Container Storage Interface）是容器编排系统（Kubernetes、Mesos、Nomad 等）与存储系统之间的标准插件协议。CSI 规范将存储驱动的功能抽象为 三个独立的 gRPC 服务：Identity、Controller 和 Node。每个服务负责存储生命周期中不同阶段的职责，这种分层设计使得驱动可以按需实现，降低了开发复杂度。

2.1 三大服务全景图

下图展示了三个服务在 Kubernetes 集群中的部署位置与调用关系。Controller 服务通常运行在控制平面（Deployment），Node 服务运行在每个工作节点（DaemonSet），Identity 服务则通常与 Controller 或 Node 服务共存。

2.2 Identity Service：驱动身份与能力声明

Identity 服务是 CSI 驱动的身份证，负责向容器编排系统报告插件的基本信息、支持的能力以及健康状态。该服务是所有 CSI 驱动必须实现的接口。

2.3 Controller Service：存储控制平面

Controller 服务运行在集群的控制平面，负责存储卷的生命周期管理，包括创建、删除、挂载到节点、快照、扩容等操作。该服务通常与后端存储系统（如 Ceph、NFS 服务器、云存储 API）直接交互。

2.4 Node Service：节点级卷操作

Node 服务运行在每个工作节点上，负责将卷挂载到 Pod 的文件系统。它执行实际的 mount、unmount、格式化等操作，是 CSI 驱动与节点操作系统交互的桥梁。

2.5 三大服务职责对比

2.6 接口调用流程示例

以下是一个典型的 PVC 创建到 Pod 挂载的完整流程，展示了三个服务如何协同工作：

1. Identity 探测：kubelet 调用 Probe 确认驱动就绪，调用 GetPluginCapabilities 获取支持的能力。
2. Controller 创建卷：external-provisioner 调用 CreateVolume，后端存储创建卷并返回卷 ID。
3. Controller 挂载到节点：external-attacher 调用 ControllerPublishVolume，将卷关联到目标节点。
4. Node 暂存：kubelet 调用 NodeStageVolume，将卷挂载到节点的暂存目录。
5. Node 发布：kubelet 调用 NodePublishVolume，将卷绑定挂载到 Pod 的挂载路径。
6. Pod 使用：容器启动，通过挂载路径读写数据。

2.7 gRPC 接口定义示例

以下是一个简化的 CSI Identity 服务 protobuf 定义，展示了接口的签名和参数结构：

syntax = "proto3";
package csi.v1;

service Identity {
    // 返回插件名称、版本、厂商信息
    rpc GetPluginInfo(GetPluginInfoRequest)
        returns (GetPluginInfoResponse) {}

    // 返回插件支持的能力集
    rpc GetPluginCapabilities(GetPluginCapabilitiesRequest)
        returns (GetPluginCapabilitiesResponse) {}

    // 健康检查，返回驱动是否就绪
    rpc Probe(ProbeRequest)
        returns (ProbeResponse) {}
}

message GetPluginInfoRequest {
    // 当前版本无必填参数，保留扩展
}

message GetPluginInfoResponse {
    string name = 1;           // 驱动名称，如 "csi.example.com"
    string vendor_version = 2; // 驱动版本，如 "1.0.0"
    map<string, string> manifest = 3; // 附加元数据
}

message ProbeResponse {
    bool ready = 1; // true 表示驱动就绪
}

Controller 和 Node 服务的 protobuf 定义类似，篇幅所限不再展开。完整的 CSI 规范 protobuf 文件可以在 CSI 官方仓库 中找到。