CloudCanal 社区版 docker 升级(Linux/MacOS)

[junyu-cloudcanal]

简述

本文档主要介绍在 Linux/MacOS 操作系统下，已经安装 CloudCanal docker 版用户如何升级 CloudCanal 新版本。

如果您从未安装过 CloudCanal , 请参考 全新安装 文档 CloudCanal 社区版 docker 版安装( Linux/MacOS)

升级步骤

1. 下载最新安装包

• https://cloudcanal-community.oss-cn-hangzhou.aliyuncs.com/latest/cloudcanal.7z

2. 解压缩新安装包

• 在相同目录下解压覆盖原来的文件
  • 7z x cloudcanal.7z

3. 控制台 DDL 变更

• 检查解压目录下 ddl_history.sql 文件，确认当前使用版本和升级版本是否存在元数据库 (cloudcanal_console) 变更
• 在 docker 宿主机上执行执行命令 mysql -uclougence -h127.0.0.1 -P25000 -p123456 登录元数据库(cloudcanal_console) , 执行相关 sql 进行变更
• 举个例子, 当前版本为1.0.3，在 ddl_history.sql 中我们看到1.0.4版本对应的表结构变更，执行以下表结构变更，避免启动console时报错
  

3. 备份容器数据(Linux)

升级会重建console和sidecar的volume，容器内部的配置和日志会丢失。可以执行scripts下的脚本备份配置和日志数据。备份后的内容会放在…/scripts/console_backup和…/scripts/sidecar_task_backup两个目录中。 这两个工具脚本在1.1.1.6以后支持。

Mac OS和Windows请手动备份容器内需要的日志和配置数据

容器重要配置和日志路径

### console容器内配置和日志路径
/home/clougence/cloudcanal/console/conf
/home/clougence/logs
### sidecar容器内配置和日志路径
/home/clougence/cloudcanal/sidecar/conf
/home/clougence/logs

4. 关闭旧版本容器(运行中)

• ./shutdown.sh

5. 更新到新版本容器

• ./upgrade.sh

6.启动新容器

• ./startup.sh

7. 确认已经升级到新版本

• docker ps | grep cloudcanal
  

相关文档

• CloudCanal 社区版 docker 全新安装(Linux/MacOS)

加入社区群

• CloudCanal 发展，离不开广大用户的支持，为了更好、更及时服务我们的用户，我们组建了微信交流群。请加我们的社群管理员吧，接头暗号:“加 cloudcanal 群”
  

FAQ

升级后sidecar启动异常，有logback相关的报错

答：备份使用老的logback.xml覆盖新的导致，可以使用新版的logback.xml，避免版本差异导致的异常

[wbbzj2006]

一直就是Waiting for console to start
[root@bi-cloud-canal01 cloudcanal]# sh startup.sh
No clougence_mysql_volume is in use, we will create clougence_mysql_volume…
clougence_mysql_volume
cloudcanal docker images are already in use.
cloudcanal-network is already in use.
cloudcanal is starting…
docker-compose.log is already in use.
View output from containers.

Usage: logs [options] [SERVICE…]

Options:
–no-color Produce monochrome output.
Unsupported config option for services service: ‘prometheus’
Waiting for console to start
…
Waiting for console to start
…
Waiting for console to start
…
Waiting for console to start
…