管理持久卷
- 1: 扩容持久卷
- 2: 克隆持久卷
- 3: 变更持久卷
- 3.1: 开启PVC变更特性
- 3.1.1: 使用Helm开启PVC变更特性
- 3.1.2: 手动方式开启PVC变更特性
- 3.2: 配置PVC变更
1 - 扩容持久卷
OceanStor V700R001C10和OceanStor Dorado V700R001C10及以后版本，扩容后文件系统的容量存在最小限制，具体限制值参考对应存储的产品手册。
当容器使用的PVC容量不足时，需要对该PVC进行扩容操作。
前提条件
PVC已创建，所在的backend存在且支持扩容。
支持扩容的存储请参考 兼容性和特性 章节中的特性表格，支持扩容的Kubernetes版本请参考 Kubernetes特性矩阵 。
huawei-csi-controller启用了csi-resizer服务。
kubectl describe deploy huawei-csi-controller -n huawei-csi | grep csi-resizer命令回显示例如下则说明已启用csi-resizer服务。
csi-resizer: Image: k8s.gcr.io/sig-storage/csi-resizer:v1.9.0
操作步骤
执行命令，查询StorageClass是否支持扩容。其中，mysc 为需要查看的StorageClass名称。
kubectl get sc mysc命令结果示例如下：
NAME PROVISIONER RECLAIMPOLICY VOLUMEBINDINGMODE ALLOWVOLUMEEXPANSION AGE mysc csi.huawei.com Delete Immediate true 172m如果ALLOWVOLUMEEXPANSION的值为true，表示当前StorageClass已经支持扩容，请跳转至步骤 3 。
执行以下命令，将“allowVolumeExpansion“的值修改为“true“。其中，mysc 为需要修改的StorageClass名称。
kubectl patch sc mysc --patch '{"allowVolumeExpansion":true}'执行命令，查询PVC的StorageClass名称。其中，mypvc 为需要扩容的PVC名称。
kubectl get pvc mypvc命令结果示例如下：
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE mypvc Bound pvc-3383be36-537c-4cb1-8f32-a415fa6ba384 2Gi RW0 mysc 145m执行以下命令进行扩容。
kubectl patch pvc mypvc -p '{"spec":{"resources":{"requests":{"storage":"120Gi"}}}}'其中，"mypvc“是需要扩容的PVC名称，“120Gi”是扩容后的容量大小。请根据实际情况进行替换。
- PVC容量的规格取决于存储规格限制和主机规格限制。以OceanStor Dorado 6.1.2/OceanStor Pacific系列 8.1.0对接CentOS 7为例，当使用的是ext4文件系统时，容量限制见 表2 ；当使用的是XFS文件系统时，容量限制见 表3 。如果使用的是NFS或者裸设备，容量需满足使用的华为存储设备型号和版本所要求的规格约束。
- 如果PVC容量不在规格范围内，可能会由于存储规格限制或主机文件系统规格限制导致创建PVC或Pod失败。
- 如果扩容的目标容量超过存储池容量导致扩容失败，请参考 PVC扩容的目标容量超过存储池容量导致扩容失败 。
执行命令，检查容量修改是否生效。
kubectl get pvc命令结果示例如下，如果CAPACITY字段已变更为指定容量，说明扩容成功。
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE mypvc Bound pvc-3383be36-537c-4cb1-8f32-a415fa6ba384 120Gi RWO mysc 24s
2 - 克隆持久卷
本章节描述如何克隆PVC。
在克隆PVC时，需要指定数据源。如下是一个克隆PVC示例，在该示例中，使用“mypvc”作为数据源，新创建了一个名叫“myclone”的PVC。
kind: PersistentVolumeClaim
apiVersion: v1
metadata:
name: myclone
spec:
storageClassName: mysc
dataSource:
name: mypvc
kind: PersistentVolumeClaim
volumeMode: Filesystem
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 2Gi
- 指定的storageClassName必须和dataSource中的源卷的StorageClass需一致。
- 克隆卷的容量必须不小于源卷容量，建议和源卷容量保持一致。
前提条件
系统中已经存在源PVC，且源PVC所在的backend支持克隆。支持克隆的存储请参考 兼容性和特性 章节中的特性表格，支持克隆的Kubernetes版本请参考 Kubernetes特性矩阵 。
操作步骤
执行以下命令，基于克隆卷的配置文件创建PVC。
kubectl create -f myclone.yaml
3 - 变更持久卷
3.1 - 开启PVC变更特性
当前华为CSI安装时默认关闭PVC变更特性，如需要使用该特性，请按照以下步骤开启。
3.1.1 - 使用Helm开启PVC变更特性
前提条件
已使用Helm安装华为CSI。
操作步骤
使用远程访问工具（以PuTTY为例），通过管理IP地址，登录Kubernetes集群的任意master节点。
执行以下命令检查PVC变更特性是否开启。
其中helm-huawei-csi为安装时指定的Helm Chart名称，huawei-csi为安装时指定的Helm Chart命名空间。组件包路径请参考 表1 。
helm get values helm-huawei-csi -n huawei-csi -a | grep volumeModify -A 1命令结果示例如下：
- 若回显内容为“enabled: true”，则表示特性开启，可跳过后续步骤。
- 若回显内容为“enabled: false”，请按照后续步骤开启PVC变更特性。
volumeModify: enabled: false进入/helm/esdk目录，执行命令，配置卷变更CRD。
# kubectl apply -f ./crds/volume-modify/ customresourcedefinition.apiextensions.k8s.io/volumemodifyclaims.xuanwu.huawei.io configured customresourcedefinition.apiextensions.k8s.io/volumemodifycontents.xuanwu.huawei.io configured
如回显中存在“Warning: resource customresourcedefinitions/volumemodifycontents.xuanwu.huawei.io is missing the kubectl.kubernetes.io/last-applied-configuration…”提示，可忽略该提示。该提示出现原因是由于Helm安装应用时使用的是kubectl create命令而不是kubectl apply命令。helm get values helm-huawei-csi -n huawei-csi -a > ./update-values.yaml执行vi update-values.yaml命令打开 4 中获取的文件，修改以下配置。修改完成后，按Esc，并输入**:wq!**，保存修改。
csiExtender: volumeModify: enabled: true执行以下命令更新华为CSI服务。
helm upgrade helm-huawei-csi ./ -n huawei-csi -f ./update-values.yaml执行命令检查服务是否启动。
kubectl get pod -n huawei-csi命令结果示例如下，其中huawei-csi为华为CSI部署命名空间。
NAME READY STATUS RESTARTS AGE huawei-csi-controller-6dfcc4b79f-9vjtq 10/10 Running 0 24m huawei-csi-node-tqs87 3/3 Running 0 20m
3.1.2 - 手动方式开启PVC变更特性
前提条件
已使用手动方式安装华为CSI。
操作步骤
使用远程访问工具（以PuTTY为例），通过管理IP地址，登录Kubernetes集群的任意master节点。
进入manual/esdk工作目录下，执行以下命令，配置卷变更CRD。
kubectl apply -f ./crds/volume-modify/执行以下命令。组件包路径请参考 表1 。
kubectl apply -f ./deploy/huawei-csi-controller-extender.yaml执行命令检查服务是否启动。
kubectl get pod -n huawei-csi命令结果示例如下，其中huawei-csi为华为CSI部署命名空间。
NAME READY STATUS RESTARTS AGE huawei-csi-controller-6dfcc4b79f-9vjtq 10/10 Running 0 24m huawei-csi-node-tqs87 3/3 Running 0 24m
3.2 - 配置PVC变更
PVC变更特性使用CRD实现，当前资源说明如下。
表 1 资源说明
- VolumeModifyClaim资源支持创建/删除/查询，不支持更新。
- VolumeModifyContent资源仅支持查询，用于展示单个PVC变更详情，请勿手动创建/删除/修改。
- VolumeModifyContent资源被VolumeModifyClaim管理，请勿手动管理VolumeModifyContent资源。
3.2.1 - 创建PVC变更
前提条件
待变更PVC关联的存储后端已经组成双活存储后端，若未组成双活存储后端，请参考 更新存储后端信息 章节配置。
PVC变更文件说明
PVC变更文件样例模板为/examples/volumemodifyclaim.yaml，具体配置项如下表所示：
表 1 参数说明
名称必须满足DNS 子域名的命名规则，支持数字、小写字母、中划线（-）和点（.）的组合，并且必须以小写字母数字字符开头和结尾，最大长度不超过63个字符。 注意：在PVC变更过程中，会对原StorageClass进行备份，备份StorageClass的名称为“<原StorageClass名称><VolumeModifyClaim名称>”，且需符合StorageClass命名规则。 | ||||
| 当且仅当spec.parameters.hyperMetro为"true"时生效。
|
- spec.source.kind和spec.source.name用于指定卷变更范围，例如配置为StorageClass和对应名称时，将会变更使用目标StorageClass发放的所有的处于Bound状态的PVC。
- 当所有关联的PVC完成变更后，华为CSI会替换原有的StorageClass，并增加VolumeModifyClaim的spec.parameters参数，使得PVC满足StorageClass定义。
典型场景配置请参考如下示例：
变更普通卷为双活卷
配置变更普通卷为双活卷示例如下：
apiVersion: xuanwu.huawei.io/v1
kind: VolumeModifyClaim
metadata:
name: myvmc
spec:
source:
kind: StorageClass
name: mysc
parameters:
hyperMetro: "true"
创建PVC变更资源
- 变更的双活卷仅支持双活AA模式。
- 如果变更场景为普通卷变更为双活卷，则仅支持变更主站点端存储卷。
- 创建PVC变更资源期间，请勿使用华为CSI管理PVC。
- 不支持对同一个PVC创建多个VolumeModifyClaim资源，若存在对目标PVC的多次变更，请在单次变更完成之后再执行。
使用PVC变更文件创建PVC变更资源步骤如下。
使用远程访问工具（以PuTTY为例），通过管理IP地址，登录Kubernetes集群的任意master节点。
执行以下命令，创建PVC变更。
kubectl create -f volumemodifyclaim.yaml参考 查询PVC变更 查询创建结果。
3.2.2 - 查询PVC变更
本章节介绍如何使用Kubectl查询PVC变更状态，当前华为CSI通过CRD提供以下API。
查询VolumeModifyClaim
使用kubectl查询VolumeModifyClaim步骤如下。
使用远程访问工具（以PuTTY为例），通过管理IP地址，登录Kubernetes集群的任意master节点。
执行以下命令，查询PVC变更。其中 vmc-name 为VolumeModifyClaim资源名称。
kubectl get volumemodifyclaims <vmc-name> -owide命令结果示例如下：
NAME STATUS READY SOURCEKIND SOURCENAME STARTEDAT COMPLETEDAT AGE myvmc Completed 1/1 StorageClass mysc 2024-06-06T03:19:13Z 2024-06-06T03:19:16Z 2m2s表 1 回显说明
- Pending：初始状态。
- Creating：VolumeModifyClaim完成基本校验，且服务端已经接收变更任务，但是该任务还未执行完成。
- Completed：所有关联的PVC均完成变更。
- Rollback：关联的PVC部分完成变更时，用户执行了删除PVC变更操作。
- Deleting：关联的PVC全部完成变更时，用户执行了删除PVC变更操作。
VolumeModifyClaim支持使用kubectl查看Events信息，当VolumeModifyClaim无法满足创建要求，或者创建过程中出现错误时，服务端将记录Events信息。参考命令如下：kubectl describe volumemodifyclaims local-to-hypermetro
查询VolumeModifyContent
VolumeModifyContent由VolumeModifyClaim资源创建，记录了单个PVC的变更详情，使用kubectl查询VolumeModifyContent步骤如下。
使用远程访问工具（以PuTTY为例），通过管理IP地址，登录Kubernetes集群的任意master节点。
执行命令，查询PVC变更。其中myvmc-uid为VolumeModifyContent资源名称。
kubectl get volumemodifycontents myvmc-uid -owide命令结果示例如下：
NAME STATUS MODIFYCLAIMNAME SOURCEVOLUME STARTEDAT COMPLETEDAT AGE myvmc-uid Completed myvmc default/mypvc 2024-06-06T03:19:07Z 2024-06-06T03:19:09Z 36m表 2 回显说明
VolumeModifyContent资源状态，可取值如下：
- Pending：初始状态。
- Creating：VolumeModifyContent完成基本校验，且服务端已经接收变更任务，但是该任务还未执行完成。
- Completed：关联的PVC完成变更。
- Rollback：正在回滚PVC变更。
VolumeModifyContent支持使用kubectl查看Events信息，当VolumeModifyContent无法满足创建要求，或者变更PVC出现错误时，服务端将记录Events信息。参考命令如下：kubectl describe volumemodifycontents myvmc-uid
3.2.3 - 删除PVC变更
- 当VolumeModifyClaim的STATUS值为Creating时，删除VolumeModifyClaim资源，将会在存储侧删除此次变更创建的资源，然后移除集群资源。在删除后，如果继续使用原有的StorageClass进行PVC管理，需要将关联的存储后端恢复为非双活存储后端。
- 当VolumeModifyClaim的STATUS值为Pending或Completed时，删除VolumeModifyClaim资源，仅会移除集群资源，不会和存储交互，即不会在存储侧删除变更创建的资源。
- VolumeModifyContent被VolumeModifyClaim管理，请勿手动管理VolumeModifyContent资源。
- 若待变更PVC中已有部分PVC满足变更要求，当批量变更失败时，会移除掉所有PVC的变更，导致已满足变更条件的PVC不再满足。
- 若待变更PVC已经在存储侧被手动管理，则可能导致变更失败。使用变更特性时，请勿手动管理存储卷。
当前章节介绍如何使用kubectl删除PVC变更，基于步骤如下。
操作步骤
使用远程访问工具（以PuTTY为例），通过管理IP地址，登录Kubernetes集群的任意master节点。
执行 命令，删除PVC变更。其中 vmc-name 为VolumeModifyClaim资源名称。
kubectl delete volumemodifyclaims <vmc-name>参考 查询PVC变更 查询创建结果。