容器存儲接口 CSI

Container Storage Interface (CSI) 是從 v1.9 引入的容器存儲接口，並於 v1.13 版本正式 GA。實際上，CSI 是整個容器生態的標準存儲接口，同樣適用於 Mesos、Cloud Foundry 等其他的容器集群調度系統。

版本信息

Kubernetes	CSI Spec	Status
v1.9	v0.1.0	Alpha
v1.10	v0.2.0	Beta
v1.11-v1.12	v0.3.0	Beta
v1.13	v0.3.0, v1.0.0	GA

Sidecar 容器版本

Container Name	Description	CSI spec	Latest Release Tag
external-provisioner	Watch PVC and create PV	v1.0.0	v1.0.1
external-attacher	Operate VolumeAttachment	v1.0.0	v1.0.1
external-snapshotter	Operate VolumeSnapshot	v1.0.0	v1.0.1
node-driver-registrar	Register kubelet plugin	v1.0.0	v1.0.2
cluster-driver-registrar	Register CSIDriver Object	v1.0.0	v1.0.1
livenessprobe	Monitors health of CSI driver	v1.0.0	v1.0.2

原理

類似於 CRI，CSI 也是基於 gRPC 實現。詳細的 CSI SPEC 可以參考 這裏，它要求插件開發者要實現三個 gRPC 服務：

• Identity Service：用於 Kubernetes 與 CSI 插件協調版本信息

• Controller Service：用於創建、刪除以及管理 Volume 存儲卷

• Node Service：用於將 Volume 存儲卷掛載到指定的目錄中以便 Kubelet 創建容器時使用（需要監聽在 /var/lib/kubelet/plugins/[SanitizedCSIDriverName]/csi.sock）

由於 CSI 監聽在 unix socket 文件上， kube-controller-manager 並不能直接調用 CSI 插件。爲了協調 Volume 生命週期的管理，並方便開發者實現 CSI 插件，Kubernetes 提供了幾個 sidecar 容器並推薦使用下述方法來部署 CSI 插件：

Recommended CSI Deployment Diagram

該部署方法包括：

• StatefuelSet：副本數爲 1 保證只有一個實例運行，它包含三個容器

  • 用戶實現的 CSI 插件

  • External Attacher：Kubernetes 提供的 sidecar 容器，它監聽 VolumeAttachment 和 PersistentVolume 對象的變化情況，並調用 CSI 插件的 ControllerPublishVolume 和 ControllerUnpublishVolume 等 API 將 Volume 掛載或卸載到指定的 Node 上
  • External Provisioner：Kubernetes 提供的 sidecar 容器，它監聽 PersistentVolumeClaim 對象的變化情況，並調用 CSI 插件的 ControllerPublish 和 ControllerUnpublish 等 API 管理 Volume
• Daemonset：將 CSI 插件運行在每個 Node 上，以便 Kubelet 可以調用。它包含 2 個容器

  • 用戶實現的 CSI 插件

  • Driver Registrar：註冊 CSI 插件到 kubelet 中，並初始化 NodeId（即給 Node 對象增加一個 Annotation csi.volume.kubernetes.io/nodeid）

配置

• API Server 配置：

--allow-privileged=true
--feature-gates=CSIPersistentVolume=true,MountPropagation=true
--runtime-config=storage.k8s.io/v1alpha1=true

• Controller-manager 配置：

--feature-gates=CSIPersistentVolume=true

• Kubelet 配置：

--allow-privileged=true
--feature-gates=CSIPersistentVolume=true,MountPropagation=true

示例

Kubernetes 提供了幾個 CSI 示例，包括 NFS、ISCSI、HostPath、Cinder 以及 FlexAdapter 等。在實現 CSI 插件時，這些示例可以用作參考。

Name	Status	More Information
Cinder	v0.2.0	A Container Storage Interface (CSI) Storage Plug-in for Cinder
DigitalOcean Block Storage	v0.0.1 (alpha)	A Container Storage Interface (CSI) Driver for DigitalOcean Block Storage
AWS Elastic Block Storage	v0.0.1(alpha)	A Container Storage Interface (CSI) Driver for AWS Elastic Block Storage (EBS)
GCE Persistent Disk	Alpha	A Container Storage Interface (CSI) Storage Plugin for Google Compute Engine Persistent Disk
OpenSDS	Beta	For more information, please visit releases and https://github.com/opensds/nbp/tree/master/csi
Portworx	0.2.0	CSI implementation is available here which can be used as an example also.
RBD	v0.2.0	A Container Storage Interface (CSI) Storage RBD Plug-in for Ceph
CephFS	v0.2.0	A Container Storage Interface (CSI) Storage Plug-in for CephFS
ScaleIO	v0.1.0	A Container Storage Interface (CSI) Storage Plugin for DellEMC ScaleIO
vSphere	v0.1.0	A Container Storage Interface (CSI) Storage Plug-in for VMware vSphere
NetApp	v0.2.0 (alpha)	A Container Storage Interface (CSI) Storage Plug-in for NetApp's Trident container storage orchestrator
Ember CSI	v0.2.0 (alpha)	Multi-vendor CSI plugin supporting over 80 storage drivers to provide block and mount storage to Container Orchestration systems.
Nutanix	beta	A Container Storage Interface (CSI) Storage Driver for Nutanix
Quobyte	v0.2.0	A Container Storage Interface (CSI) Plugin for Quobyte

下面以 NFS 爲例來看一下 CSI 插件的使用方法。

首先需要部署 NFS 插件：

git clone https://github.com/kubernetes-csi/drivers
cd drivers/pkg/nfs
kubectl create -f deploy/kubernetes

然後創建一個使用 NFS 存儲卷的容器

kubectl create -f examples/kubernetes/nginx.yaml

該例中已直接創建 PV 的方式使用 NFS

apiVersion: v1
kind: PersistentVolume
metadata:
  name: data-nfsplugin
  labels:
    name: data-nfsplugin
  annotations:
    csi.volume.kubernetes.io/volume-attributes: '{"server":"10.10.10.10","share":"share"}'
spec:
  accessModes:
  - ReadWriteOnce
  capacity:
    storage: 100Gi
  csi:
    driver: csi-nfsplugin
    volumeHandle: data-id
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: data-nfsplugin
spec:
  accessModes:
  - ReadWriteOnce
  resources:
    requests:
      storage: 100Gi
  selector:
    matchExpressions:
    - key: name
      operator: In
      values: ["data-nfsplugin"]

也可以用在 StorageClass 中

kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
  name: csi-sc-nfsplugin
provisioner: csi-nfsplugin
parameters:

---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: request-for-storage
spec:
  accessModes:
  - ReadWriteOnce
  resources:
    requests:
      storage: 5Gi
  storageClassName: csi-sc-nfsplugin

參考文檔

• Kubernetes CSI Documentation
• CSI Volume Plugins in Kubernetes Design Doc