PVC相关问题 on Huawei

创建PVC时， PVC的状态为Pending

Mon, 01 Jan 0001 00:00:00 +0000

现象描述

执行完成PVC的创建操作，一段时间后，PVC的状态仍然处于Pending。

根因分析

原因1：由于没有提前创建指定名称的StorageClass，导致Kubernetes在创建PVC时无法找到指定StorageClass名称。

原因2：由于存储池能力和StorageClass能力不匹配，导致huawei-csi选择存储池失败。

原因3：由于存储RESTful接口执行返回具体错误码（例如：50331651），导致huawei-csi在执行创建PVC时失败。

原因4：由于存储在huawei-csi设定的超时时间内没有返回，huawei-csi向Kubernetes返回超时错误。

原因5：其他原因。

解决措施或规避方法

创建PVC时，如果PVC处于Pending状态，需要根据以下不同的原因采取不同的解决措施。

使用远程访问工具（以PuTTY为例），通过管理IP地址，登录Kubernetes集群的任意master节点。
执行以下命令，查看PVC的详细信息。
```
kubectl describe pvc mypvc
```

根据PVC详细信息中Events信息，执行相应操作。

如果由原因1导致PVC处于Pending状态，执行以下步骤。

Events:
 Type Reason Age From Message
 ---- ------ ---- ---- -------
 Warning ProvisioningFailed 0s (x15 over 3m24s) persistentvolume-controller storageclass.storage.k8s.io "mysc" not found

删除PVC。
创建StorageClass，可参考配置存储类。
创建新的PVC，可参考配置持久卷。

如果由原因2导致PVC处于Pending状态，执行以下步骤。

Events:
 Type Reason Age From Message
 ---- ------ ---- ---- -------
 Normal Provisioning 63s (x3 over 64s) csi.huawei.com_huawei-csi-controller-b59577886-qqzm8_58533e4a-884c-4c7f-92c3-6e8a7b327515 External provisioner is provisioning volume for claim "default/mypvc"
 Warning ProvisioningFailed 63s (x3 over 64s) csi.huawei.com_huawei-csi-controller-b59577886-qqzm8_58533e4a-884c-4c7f-92c3-6e8a7b327515 failed to provision volume with StorageClass "mysc": rpc error: code = Internal desc = failed to select pool, the capability filter failed, error: failed to select pool, the final filter field: replication, parameters map[allocType:thin replication:True size:1099511627776 volumeType:lun]. please check your storage class

删除PVC。
删除StorageClass。
根据Events信息修改StorageClass.yaml文件。
创建StorageClass，详细请参考配置存储类。
创建新的PVC，详情请参考配置持久卷。

如果由原因3导致PVC处于Pending状态，请联系华为工程师处理。

删除PVC前，PVC的状态为Pending

Mon, 01 Jan 0001 00:00:00 +0000

现象描述

在执行删除PVC前，PVC的状态处于Pending。

根因分析

原因1：由于没有提前创建指定名称的StorageClass，导致Kubernetes在创建PVC时无法找到指定StorageClass名称。

原因2：由于存储池能力和StorageClass能力不匹配，导致huawei-csi选择存储池失败。

原因3：由于存储RESTful接口执行返回具体错误码（例如：50331651），导致huawei-csi在执行创建PVC时失败。

原因4：由于存储在huawei-csi设定的超时时间内没有返回，huawei-csi向Kubernetes返回超时错误。

原因5：其他原因。

解决措施或规避方法

删除Pending状态下的PVC，需要根据以下不同的原因采取不同的解决措施。

使用远程访问工具（以PuTTY为例），通过管理IP地址，登录Kubernetes集群的任意master节点。
执行以下命令，查看PVC的详细信息。
```
kubectl describe pvc mypvc
```

根据PVC详细信息中Events信息，执行相应操作。

如果由原因1导致PVC处于Pending状态，可以执行 **kubectl delete pvc **mypvc 命令，删除PVC。

Events:
 Type Reason Age From Message
 ---- ------ ---- ---- -------
 Warning ProvisioningFailed 0s (x15 over 3m24s) persistentvolume-controller storageclass.storage.k8s.io "mysc" not found

如果由原因2导致PVC处于Pending状态，可以执行** kubectl delete pvc **mypvc 命令，删除PVC。

Events:
 Type Reason Age From Message
 ---- ------ ---- ---- -------
 Normal Provisioning 63s (x3 over 64s) csi.huawei.com_huawei-csi-controller-b59577886-qqzm8_58533e4a-884c-4c7f-92c3-6e8a7b327515 External provisioner is provisioning volume for claim "default/mypvc"
 Warning ProvisioningFailed 63s (x3 over 64s) csi.huawei.com_huawei-csi-controller-b59577886-qqzm8_58533e4a-884c-4c7f-92c3-6e8a7b327515 failed to provision volume with StorageClass "mysc": rpc error: code = Internal desc = failed to select pool, the capability filter failed, error: failed to select pool, the final filter field: replication, parameters map[allocType:thin replication:True size:1099511627776 volumeType:lun]. please check your storage class

如果由原因3导致PVC处于Pending状态，可以执行** kubectl delete pvc** mypvc 命令，删除PVC。

通用临时卷扩容失败

Mon, 01 Jan 0001 00:00:00 +0000

现象描述

在Kubernetes版本低于1.25环境中，对LUN类型的通用临时卷扩容失败，显示PV已经扩容，但PVC未成功更新容量。

根因分析

该问题是由Kubernetes的 bug 导致，Kubernetes在1.25版本中修复了该问题。

PVC扩容的目标容量超过存储池容量导致扩容失败

Mon, 01 Jan 0001 00:00:00 +0000

现象描述

在低于1.23版本的Kubernetes环境中，对PVC进行扩容，当目标容量超过存储池容量时，扩容失败。

根因分析

Kubernetes社区已知问题，详情请参考处理扩充卷过程中的失败。

解决措施或规避方法

参考处理扩充卷过程中的失败。