使用云盘静态存储卷,即使用预先在云硬盘控制台已建好的云盘实例,通过手动创建PV,创建PVC时使用已有PV的方式,实现容器内挂载云盘存储。
该模式下需要用户自建云盘及PV资源,一定程度上增加操作和管理复杂性,一般推荐使用动态创建存储的方式。
前提条件
已创建容器集群
已在插件市场安装存储插件cstor-csi,且插件正常运行
已在云硬盘控制台创建云盘
使用限制
参见“云硬盘概述”——“使用限制”
通过控制台使用云盘静态存储卷
1、创建持久卷(PV)
登录“云容器引擎”管理控制台;
在集群列表页点击进入指定集群;
进入主菜单“存储”——“持久卷”,单击左上角“创建持久卷”;
在创建对话框,配置持久卷PV的相关参数。配置项说明如下:
配置项 | 说明 |
---|---|
名称 | PV的名称,以pvc-开头 |
持久卷类型 | 当前支持云盘、弹性文件、对象存储、并行文件、海量文件和本地存储,这里选择云盘。 具体创建页中展示的存储类型由当前资源池支持情况决定。 |
存储驱动 | 采用默认CSI驱动 |
访问模式 |
说明:如果使用非共享盘存储,访问模式不能为ReadWriteMany。 |
云盘ID | 选择已有云盘实例。单击会弹出选择云盘会话,会话中会展示可使用的云盘信息,可使用条件包括:
|
挂载类型 | 当前支持ext4、xfs |
卷模式 |
说明:如果使用共享盘存储,卷模式仅支持块设备(Block)。 |
挂载选项 | 挂载参数,用户可根据自己的情况实际定制相关参数。 比如设置挂载参数为: discard:表示在挂载文件系统时指定 discard 参数,文件系统中删除文件后会自动触发 discard 操作,通知块设备释放掉未使用的 Block 。 |
标签 | 用于对 PV 对象进行标记和分类的元数据属性,可以赋予 PV 以自定义的属性或标识。 |
说明
静态导入场景下,回收策略均为默认Retain,cstor-csi不会删除数据。
参数配置完成后,点击“确定”。创建成功后,可以在持久卷列表查看,此时PV状态为“可用”。
2、创建持久卷声明(PVC)
进入主菜单“存储”——“持久卷声明”,单击左上角“创建持久卷声明”;
在创建对话框,配置持久卷声明PVC的相关参数。配置项说明如下:
配置项 | 说明 |
---|---|
名称 | PVC的名称 |
存储声明类型 | 当前支持云盘、弹性文件、对象存储、并行文件、海量文件和本地存储,这里选择云盘。 具体创建页中展示的存储类型由当前资源池支持情况决定。 |
分配模式 | 当前支持“使用存储类”和“已有存储卷” 这里选择“已有存储卷” |
持久卷名称 | 选择上一步创建的PV名称 |
参数配置完成后,点击“确定”。创建成功后,可以在持久卷声明列表查看。
进入持久卷声明列表页,等待PVC状态为“已绑定” 。
3、创建工作负载
登录“云容器引擎”管理控制台;
在集群列表页点击进入指定集群;
进入主菜单“工作负载”——“有状态”,单击左上角“创建SatefulSet”;
在创建对话框,数据卷栏中,选择添加数据卷,卷类型选择“使用已有PVC”,操作栏选择“添加已有PVC”;
在实例内容器栏,为容器设置挂载点。选择添加挂载点,选择数据卷为上一步创建,根据需要配置容器路径和权限;
所有的信息都配置完成后,单击 “提交” 。
创建成功后,您就可以正常使用数据卷。
通过kubectl命令行使用云盘静态存储卷
1、创建持久卷(PV)
使用kubectl连接集群,创建示例yaml文件pv-example.yaml:
apiVersion: v1
kind: PersistentVolume
metadata:
annotations:
pv.kubernetes.io/provisioned-by: disk.csi.cstor.com
name: pvc-test-disk #PV的名称,以pvc-开头
spec:
accessModes:
- ReadWriteOnce #访问模式
capacity:
storage: 10Gi #云盘容量
csi:
driver: disk.csi.cstor.com
fsType: ext4 #挂载类型
volumeAttributes:
diskUUID: {YOUR-DISK-UUID} #替换云盘ID
driverType: disk.csi.cstor.com
mode: VBD
shared: "false" #是否共享盘
type: SATA # 磁盘类型
volumeHandle: 0103-20-{resourceID} # 替换云盘resourceID
mountOptions:
- discard
nodeAffinity:
required:
nodeSelectorTerms:
- matchExpressions:
- key: topology.disk.csi.cstor.com/zone
operator: In
values:
- <your-node-zone-id> #替换为您待部署应用的节点所在的可用区,例如cn-huadong1-jsnj1A-public-ctcloud
volumeMode: Filesystem #卷模式
执行以下命令,创建PV
kubectl apply -f pv-example.yaml
查看创建的PV:登录“云容器引擎”管理控制台;在集群列表页点击进入指定集群;进入主菜单“存储”——“持久卷”,在持久卷列表查看。
2、创建持久卷声明(PVC)
使用kubectl连接集群,创建示例yaml文件pvc-example.yaml:
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
annotations:
volume.beta.kubernetes.io/storage-provisioner: disk.csi.cstor.com
name: cstor-pvc-disk
namespace: default
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 10Gi
volumeMode: Filesystem
volumeName: {YOUR-PV-NAME} #替换PV名称
执行以下命令,创建PVC
kubectl apply -f pvc-example.yaml
查看创建的PVC:
登录“云容器引擎”管理控制台;在集群列表页点击进入指定集群;进入主菜单“存储”——“持久卷声明”,在列表查看。
3、创建工作负载
使用kubectl连接集群,创建示例yaml文件sts-example.yaml:
apiVersion: "apps/v1"kind: "StatefulSet"metadata:
name: "test-sts"spec:
podManagementPolicy: "OrderedReady"
replicas: 1
revisionHistoryLimit: 10
template:
spec:
containers:
- image: "nginx:1.25-alpine"
imagePullPolicy: "IfNotPresent"
name: "container1"
resources:
limits:
cpu: "100m"
memory: "256Mi"
requests:
cpu: "100m"
memory: "256Mi"
terminationMessagePath: "/dev/termination-log"
terminationMessagePolicy: "File"
volumeMounts:
- mountPath: "/tmp"
name: "volume1"
dnsPolicy: "ClusterFirst"
restartPolicy: "Always"
schedulerName: "default-scheduler"
securityContext: {}
terminationGracePeriodSeconds: 30
volumes:
- name: "volume1"
persistentVolumeClaim:
claimName: "cstor-pvc-disk"
updateStrategy:
rollingUpdate:
partition: 0
type: "RollingUpdate"
执行以下命令,创建StatefulSet
kubectl apply -f sts-example.yaml
查看创建的有状态负载:
登录“云容器引擎”管理控制台;在集群列表页点击进入指定集群;进入主菜单“工作负载”——“有状态”,在列表查看。
验证数据持久化
登录“云容器引擎”管理控制台;
在集群列表页点击进入指定集群;
进入主菜单“工作负载”——“有状态”,进入负载详情;
在Pod列表页,选择“远程登录”,进入到容器内执行以下命令:
/dev/vdb 9.7G 24.0K 9.7G 0% /tmp
2、向/tmp 目录下写一个文件,执行echo "Hello World" > /tmp/test.log
3、查看/tmp目录下文件,执行ls /tmp,预期结果如下:
lost+found test.log
退出“远程登录”,对上一步中的Pod执行“销毁重建”,等待Pod重新运行正常;
对新建Pod,继续执行“远程登录”,进入到容器内查看数据。执行cat /tmp/test.log,预期结果如下:
Hello World
以上步骤说明,pod删除重建后,重新挂载云盘,数据仍然存在,说明云硬盘中的数据可持久化保存。