版本升级(K8s Legacy)
本文主要介绍如何在 Kubernetes 环境下更新 CloudCanal 版本。
如果您从未安装过 CloudCanal，请参考 CloudCanal 全新安装(K8S Linux/MacOs) 文档。
升级步骤
下载安装包
登录官方网站，点击 下载私有部署版 按钮。
解压缩新安装包
在相同目录下解压覆盖原来的文件。
7z x cloudcanal.7z -o./cloudcanal_home
进入安装脚本目录
进入 k8s 安装脚本目录
cd cloudcanal_home/install_on_kubernetes
升级
使用以下任一种方式升级。
方式一：使用脚本升级
更新到新版本并自动重启。
## CentOS / Rhel / Ubuntu / MacOS
./upgrade.sh
方式二：使用 Helm Chart 升级
- 使用脚本导入镜像到所有 Node 节点：
cd ./cloudcanal_home/install_on_kubernetes/scripts/
./install_new_images.sh
注意
脚本会自动将当前目录下的镜像（如 console.tar、sidecar.tar 等）加载到所有 Node 节点，请确保已配置好 SSH 无密登录。
若你希望手动导入镜像，请先将 ./cloudcanal_home/images 目录下的所有 .tar 文件（如 console.tar、sidecar.tar 等）手动传输到每个 Node 节点，再分别在每个节点上执行以下命令：
docker load -i console.tar
docker load -i sidecar.tar
docker load -i mysql.tar
docker load -i prometheus.tar
- 拉取 Helm Chart 并修改配置。
wget -cO cloudcanal-helm-0.1.0.tgz https://gitee.com/clougence/cloudcanal-helm/releases/download/0.1.0/cloudcanal-helm-0.1.0.tgz --no-check-certificate
tar -xzvf cloudcanal-helm-0.1.0.tgz
cd cloudcanal-helm
vim values.yaml
# 配置镜像地址、版本号、存储类等，按需修改
clougence:
...
imageTag: 4.7.2.0 # 需手动修改为实际版本号
storageClassName: local-path # 可修改为自定义的存储类；若保持默认值，请确保相关镜像已导入所有 Node 节点
...
信息
建议先备份原有 values.yaml 配置文件内容，再将其中的关键配置拷贝至新版 Chart 中，以避免配置丢失或错误覆盖。
- 使用 Helm 升级部署。
helm upgrade cloudcanal ./ -f values.yaml -n cloudcanal
确认已升级
执行以下命令查看 CloudCanal 相关节点已升级到新版本。
kubectl get po -n cloudcanal
FAQ
CloudCanal 元数据库结构不一致怎么办？
解压目录下 ddl_history.sql 文件，检查 当前版本 和 升级版本 是否存在 系统元数据 变更。
如有变更，在宿主机上使用命令或客户端登录元数据库(cloudcanal_console)，执行相关 SQL 进行变更。
kubectl exec -it mysql-xxx -n cloudcanal bash
mysql -uroot -p123456
例如：当前版本为 1.0.3，在新包 ddl_history.sql 中看到 1.0.4 版本及往后的变更如下图。按序执行这些变更到元数据库即可。
特殊版本怎么处理？
2.2.6.12 之后新增自定义告警接口，在 configmap 里进行编辑后，重启节点后生效。
kubectl edit cm console-config -n cloudcanal
console.config.alert.custom.alerturl=
