云容器引擎服务提供cstor-csi插件,基于Kubernetes容器存储接口(CSI),深度融合天翼云存储服务云硬盘、弹性文件存储、对象存储、并行文件和海量文件等,并完全兼容Kubernetes原生的存储服务。
插件介绍
cstor-csi插件包括cstor-csi-provisioner和cstor-csi-nodeplugin两部分。
cstor-csi-provisioner以无状态负载形态部署,通过将云存储服务的功能与 Kubernetes 的存储框架无缝集成,使用户能够通过 Kubernetes API 动态创建和删除存储卷,而无需直接与云存储服务进行交互;
cstor-csi-nodeplugin以守护进程形态部署在所有节点,将存储卷与节点上的容器运行时进行集成,并提供对存储卷的挂载、卸载和快照等操作的支持,以使容器可以方便地使用存储卷提供的持久性存储功能。
版本推荐
目前CSI版本中,4.0及以上版本为新版插件,4.0以下版本为旧版插件。两版插件的实现逻辑存在差异,建议优先采用新版插件。
新版插件完全兼容旧版插件的所有功能,不存在兼容性问题。
插件安装
前提条件
大部分资源池插件安装无需配置用户AK和SK,仅少部分资源池在安装前需要配置。如需配置AK和SK,请先到天翼云门户“用户”-“安全设置”-“用户AccessKey”中获取AK和SK。
预付费账号请检查天翼云账户余额是否在100元以上,cstor-csi插件开通的存储为按需付费方式,需要账户余额在100元以上才可正常开通。
强烈建议使用CStor-CSI的最新版本,至少选择4.0及其以上版本,越高的版本具备更多特性,更好的性能,更好的兼容性。最新CSI版本兼容之前的CSI版本。
操作步骤
登录“云容器引擎”管理控制台;
在集群列表页点击进入指定集群;
进入主菜单“插件”——“插件市场”,选择cstor-csi,点击“安装”即可;
如需指定AK/SK,则在弹出的安装界面,配置用户AK/SK,再点击“安装”;


安装成功后将跳转到插件实例列表页,可以看到插件安装状态。如果插件安装失败,可以查看失败日志,通过工单反馈问题。
插件使用
cstor-csi插件安装完成后,会默认创建示例存储类,可以在“存储”——“存储类”列表中查看。
说明
默认创建的存储类仅作为建议配置,用户可根据实际使用场景自行创建存储类。
默认存储类的类型由云容器引擎服务根据集群所在资源池已上线的存储产品决定。例如,若华北2资源池未上线云盘极速型SSD,则默认不会创建该类型的存储类。
部分存储类型仅在特定资源池或可用区支持,且需基于存储产品的可用性及用户配置进行构建,不一定在CSI安装时展示。您需自行创建存储类以启用动态存储能力。
cstor-csi默认创建存储类型、对应驱动及应用场景等说明如下:
| 产品 | provisioner | storageClass | type | 类型 | 绑定模式 | 应用场景 | 备注 |
|---|---|---|---|---|---|---|---|
| 云硬盘 | disk.csi.cstor.com | cstor-csi-disk-sata-sc | SATA | 普通IO | 立即绑定 | 由SATA存储介质构成的云硬盘。提供可靠的块存储,可运行关键应用程序 | 无 |
| cstor-csi-disk-sata-sc-topology | SATA | 普通IO | 延迟绑定 | 由SATA存储介质构成的云硬盘。提供可靠的块存储,可运行关键应用程序 | 为延迟绑定模式,它将在Pod调度后,根据调度所在的可用区,才创建该可用区的云硬盘。 | ||
| cstor-csi-disk-sas-sc | SAS | 高IO | 立即绑定 | 由SAS存储介质构成的云硬盘。提供高IO和低延迟性能,支持NoSQL/关系型数据库,数据仓库,文件系统等应用 | 无 | ||
| cstor-csi-disk-ssd-genric-sc | SSD-genric | 通用型SSD | 立即绑定 | 通用型SSD类型,由SSD存储介质构成的云硬盘。提供可靠的块存储,适用于企业关键应用 | 无 | ||
| cstor-csi-disk-ssd-sc | SSD | 超高IO | 立即绑定 | 由SSD存储介质构成的云硬盘。适用于超大带宽的读写密集型应用场景 | 无 | ||
| cstor-csi-disk-fast-ssd-sc | FAST-SSD | 极速型SSD | 立即绑定 | 由SSD存储介质构成的云硬盘。适用于超大IOPS、超大带宽和超低时延的大型数据库应用场景 | 无 | ||
| cstor-csi-disk-xssd0-sc | XSSD-0 | XSSD-0 | 立即绑定 | 高吞吐、低时延的场景
| 无 | ||
| cstor-csi-disk-xssd1-sc | XSSD-1 | XSSD-1 | 立即绑定 | 超高吞吐和超低时延的场景
| 无 | ||
| cstor-csi-disk-xssd2-sc | XSSD-2 | XSSD-2 | 立即绑定 | 超高IOPS、超高吞吐量和超低时延
| 无 | ||
| 弹性文件 | nas.csi.cstor.com | cstor-csi-nas-capacity-sc | capacity | 容量型 | 立即绑定 | 适用于大容量、低时延的业务,如代码存储、日志存储、Web服务、虚拟桌面等 | 挂载弹性文件时,不涉及可用区概念,支持跨可用区访问 |
| cstor-csi-nas-capacity-performance-sc | performance | 性能型 | 立即绑定 | 适用于海量小文件、随机IO密集型以及时延敏感型业务,如高性能计算、文件共享、内容管理等 | |||
| 对象存储 | zos.csi.cstor.com | cstor-csi-zos-standard-sc | STANDARD | 标准存储 | 立即绑定 | 提供高可靠、高可用、高性能的存储服务,适用于频繁访问(平均一月访问多次)的存储场景,比如移动应用、网站、音视频、社交图片、大数据分析等业务场景。 | 由于storageClass中需要保存用户对象存储的AK/SK的secret信息,不便于在部署时安装,所以需要用户在使用过程中自行构建storageClass |
| cstor-csi-zos-standard-ia-sc | STANDARD_IA | 低频存储 | 立即绑定 | 提供高可靠、低成本的存储服务,适用于不频繁访问(平均一月访问一次)的存储场景,但在需要时也能快速实时访问数据的业务场景,比如数据备份、监控数据存储等场景。 | |||
| 海量文件存储 | oceanfs.csi.cstor.com | cstor-csi-oceanfs-massive-sc-sharepath | massive | 容量型 | 立即绑定 | 天翼云推出的全托管、可扩展海量文件系统,满足海量数据、高带宽型应用场景的需求。OceanFS能够弹性扩展至PB规模,具备高可用性和持久性,适用于多种应用场景,包括HPC、媒体处理、文件共享、内容管理和Web服务等。 | |
| cstor-csi-oceanfs-massive-sc-subpath | massive | 容量型 | 立即绑定 | 天翼云推出的全托管、可扩展海量文件系统,满足海量数据、高带宽型应用场景的需求。OceanFS能够弹性扩展至PB规模,具备高可用性和持久性,适用于多种应用场景,包括HPC、媒体处理、文件共享、内容管理和Web服务等。 | |||
| 并行文件存储 | hpfs.csi.cstor.com | cstor-csi-hpfs-perf-sc | hpfs_perf | 性能型 | 立即绑定 | 天翼云提供的高性能并行文件存储,支持全 NVMe 闪存、RDMA 技术,最高提供千万 IOPS 和 TBps 吞吐,同时保证亚毫秒级时延。具有高性能,高可靠性,高可扩展性的特点,充分满足影视渲染、气象分析、石油勘探、EDA 仿真、基因分析、AI 训练、自动驾驶等数据密集型场景的需求。 | |
| 本地存储 | local.csi.cstor.com | cstor-csi-local-localpv-sc | 无 | 本地存储 | 立即绑定 | 天翼云CCSE容器引擎,基于云主机/裸金属的已有的文件系统,提供的本地存储的能力。 |
插件升级/更新
您可以在控制台看插件实例,并根据需要对插件进行升级或者更新。
登录“云容器引擎”管理控制台;
在集群列表页点击进入指定集群;
进入主菜单“插件”——“插件市场”,选择cstor-csi,点击进入查看详情。在插件详情页可以看到版本列表,在说明中可以获取各版本发布变更内容,根据需要确定升级版本;
进入主菜单“插件”——“插件实例”,选择cstor-csi,可以选择版本进行升级,也可以更新插件配置。
说明
如果当前插件版本已是最新版,“插件实例”列表页将不可见“升级”按钮。
插件卸载
登录“云容器引擎”管理控制台;
在集群列表页点击进入指定集群;
进入主菜单“插件”——“插件实例”,选择cstor-csi,点击“卸载”。