升级 DCE 5.0 组件¶
DCE 5.0 组件的升级包含升级 DCE 5.0 产品功能模块、升级 DCE 5.0 基础设施模块。
- DCE 5.0 产品功能模块由容器管理、全局管理、可观测性等十几个子模块构成，主要指
manifest.yaml 文件中的
components部分。 - DCE 5.0 基础设施模块的组件特指 manifest.yaml 文件中的
infrastructures部分。
Warning
- 由于 DCE 5.0 包含较多产品模块，所以使用安装器升级 DCE 5.0 组件时，建议逐版本升级，请勿跨多个版本进行升级！
- 升级 DCE 5.0 组件可能会覆盖您的业务数据，请先备份好数据，重要！！！
前提条件¶
离线升级操作步骤¶
本次操作步骤演示如何从 v0.20.0 升级到 v0.21.0。目
第 1 步：下载 DCE 5.0 离线包¶
可以在下载中心下载最新版本。 本文以 v0.21.0 为例。
下载完毕后解压离线包，以 AMD64 架构离线包为例：
第 2 步：配置 clusterConfig.yaml¶
Note
- 需要确保集群配置文件 clusterConfig.yaml 与安装时使用的参数一致
- 目前仅对 imagesAndCharts 的 builtin 方式进行了测试
文件在解压后的离线包 offline/sample 目录下，参考配置文件如下：
clusterConfig.yaml
apiVersion: provision.daocloud.io/v1alpha4
kind: ClusterConfig
metadata:
spec:
clusterName: my-cluster
loadBalancer:
type: metallb
istioGatewayVip: 172.30.**.**/32
insightVip: 172.30.**.**/32
masterNodes:
- nodeName: "g-master1"
ip: 172.30.**.**
ansibleUser: "root"
ansiblePass: "*****"
workerNodes:
- nodeName: "g-worker1"
ip: 172.30.**.**
ansibleUser: "root"
ansiblePass: "*****"
- nodeName: "g-worker2"
ip: 172.30.**.**
ansibleUser: "root"
ansiblePass: "*****"
fullPackagePath: "/home/installer/offline"
osRepos:
type: builtin
isoPath: "/home/installer/CentOS-7-x86_64-DVD-2207-02.iso"
osPackagePath: "/home/installer/os-pkgs-centos7-v0.4.4.tar.gz"
imagesAndCharts:
type: builtin
addonPackage:
binaries:
type: builtin # (1)
- official-service(if omit or empty), builtin or external
第 3 步：配置 manifest.yaml（可选）¶
文件在解压后的离线包 offline/sample 目录下。
配置 DCE 5.0 产品功能模块¶
DCE 5.0 产品功能模块的组件特指 manifest.yaml 文件中的 components 部分。
如果有些产品组件不需要升级，可以在对应组件下选择关闭。如果采用以下配置，更新时将不会对 Kpanda（容器管理）进行升级：
配置 DCE 5.0 基础设施模块¶
DCE 5.0 基础设施模块的组件特指 manifest.yaml 文件中的 infrastructures 部分，如下配置就是基础设施中的 hwameiStor 组件：
Note
目前仅支持对当前环境中已经安装的产品组件进行升级，不存在的组件将会跳过升级步骤。
第 4 步：开始升级¶
升级 DCE 5.0 产品功能模块¶
Note
如果升级组件依赖数据库，在执行升级命令前，需先创建数据库信息。操作步骤如下：
- 确认 manifest 中新增的产品组件已开启
-
运行如下命令，执行第 11 步：
执行升级命令：
./offline/dce5-installer cluster-create -c ./offline/sample/clusterConfig.yaml -m ./offline/sample/manifest.yaml --upgrade gproduct
升级 DCE 5.0 基础设施模块¶
执行升级命令：
./offline/dce5-installer cluster-create -c ./offline/sample/clusterConfig.yaml -m ./offline/sample/manifest.yaml --upgrade infrastructure
升级 DCE 5.0¶
执行升级命令：
./offline/dce5-installer cluster-create --help
provision DaoCloud 5.0 clusters and install software stacks
Usage:
dce5-installer cluster-create [flags]
Flags:
-c, --clusterConfig string The cluster config file
-y, --dry-run Dump installer scripts only
-h, --help help for cluster-create
-m, --manifest string manifest BOM file
--max-tasks int Controls the maximum number of concurrent tasks. Must be positive number. (default 4)
--multi-arch Whether to use the multi-arch image import mode.
--serial Disable concurrent run
-u, --upgrade string Choose the component which you want to upgrade, for example tinder,cluster,infrastructure,hwameistor,middleware,gproduct,addon .
Global Flags:
-s, --customized-script string (Optional)Your override script path
-d, --debug Enable debug output
-l, --logfile string The installation log to be dump (default "/var/log/dce5.log")
-z, --minimized-replicas Whether to minimized all components replicas as small as possible.
-j, --steps string (Optional)Debug Only, to specific a range of steps to be executed(format, 2+; 1,2,4; 3 ) (default "1+")
-t, --tinder-host-ip string (Optional)The desired host IP on tinder node if it is not on default route.
./offline/dce5-installer cluster-create -c ./offline/sample/clusterConfig.yaml -m ./offline/sample/manifest.yaml --upgrade infrastructure,gproduct
升级参数说明：
install-app或cluster-create，代表安装 DCE 5.0 的安装模式类型。如果最初的环境是通过cluster-create来安装的，则升级时也采用这个命令--upgrade可以简写为-u，目前支持升级：- DCE 5.0 产品功能模块（gproduct）
- 基础设施模块（infrastructure）
- 本地存储模块（hwameistor）
- 如果需要一起升级产品功能模块和基础设施模块，则可以指定参数
--upgrade infrastructure,gproduct - 安装器自 v0.12.0 支持了
--multi-arch参数，主要是用户在当前环境存在多架构镜像时，进行升级过程中添加该参数可以避免覆盖原有的多架构镜像。
第 5 步：升级成功提示¶
Note
如果你在使用 -m ./offline/sample/manifest.yaml 运行命令时报错，可以尝试执行以下替换操作：
- 对于 DCE 5.0 社区版，替换为
-m ./offline/sample/manifest-community.yaml - 对于 DCE 5.0 商业版，替换为
-m ./offline/sample/manifest-enterprise.yaml