从2.x或3.x升级至4.x版本

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

备份存储后端配置

如果您已按照以上须知评估风险后，确认需要从2.x或3.x版本的CSI升级至4.11.0版本，请按照以下操作步骤备份存储后端配置：

使用远程访问工具（以PuTTY为例），通过管理IP地址，登录Kubernetes集群的任意master节点。
执行以下命令备份后端信息到configmap.json文件中。OpenShift平台使用oc替换kubectl命令。
```
kubectl get cm huawei-csi-configmap -n huawei-csi -o json > configmap.json
```

请按照升级华为CSI 中的步骤进行升级。

请将备份存储后端配置中备份的后端信息，按照存储后端管理章节的说明配置存储后端。其中通过备份后端信息配置存储后端命令如下。
```
oceanctl create backend -f configmap.json -i json -n huawei-csi
```

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

如果您旧版本CSI使用Helm部署，请按照以下操作步骤升级华为CSI。

使用远程访问工具（以PuTTY为例），通过管理IP地址，登录Kubernetes集群的任意master节点。
将目标版本CSI组件包拷贝到master节点的任意目录下。
进入到helm/esdk的工作目录下，目录路径请参见表1 。
```
cd helm/esdk
```
执行kubectl apply -f ./crds/backend/命令，更新存储后端CRD
```
kubectl apply -f ./crds/backend/
```
（可选） 请务必按照检查卷快照依赖组件章节检查快照依赖组件，确认无误后执行执行以下命令更新快照CRD，如果controller.snapshot.enabled参数设置为false或Kubernetes版本低于v1.20，可跳过本步骤，详情请参考表2 。
```
kubectl apply -f ./crds/snapshot-crds/ --validate=false
```
执行以下命令，获取原有服务配置文件。其中helm-huawei-csi为旧版本安装时指定的Helm Chart名称，huawei-csi为旧版本安装时指定的Helm Chart命名空间。
```
helm get values helm-huawei-csi -n huawei-csi -a > ./update-values.yaml
```

执行vi update-values.yaml命令打开 6 中获取的文件，修改images配置项，更新镜像至最新版本。需要修改的参数请参考表1 。

表 1 images配置项

容器名称	描述	K8s版本要求	修改为
storage-backend-controller	huawei-csi镜像。	v1.16+	storage-backend-controller:4.11.0
storage-backend-sidecar	华为后端管理storageBackendContent资源的镜像	v1.16+	storage-backend-sidecar:4.11.0
huawei-csi-driver	华为后端管理storageBackendClaim资源的镜像。	v1.16+	huawei-csi:4.11.0
huawei-csi-extender	huawei-csi-extender镜像	v1.16+	huawei-csi-extender:4.11.0
images.sidecar.livenessProbe	livenessprobe sidecar镜像。 CCE或CCE Agile升级华为CSI Mon, 01 Jan 0001 00:00:00 +0000 前提条件已下载新版本CSI的软件包。操作步骤参考 CCE或CCE Agile卸载华为CSI 卸载CSI。参考 CCE或CCE Agile平台安装华为CSI 安装新版本的CSI。