openeuler/canal

canal Docker镜像文档

镜像概述和主要用途

canal是由Alibaba开发的开源实时数据同步项目，该Docker镜像是canal的官方镜像，基于openEuler构建。其核心功能是捕获和解析MySQL binlog（二进制日志），允许下游系统近实时消费变更数据。

• 维护者：openEuler CloudNative SIG
• 获取帮助：openEuler CloudNative SIG、openEuler社区

核心功能和特性

• 实时数据同步：捕获MySQL binlog并解析，实现数据变更的近实时同步
• binlog解析：支持解析MySQL ROW格式的binlog
• 基于openEuler：镜像构建于openEuler系统，免费使用且无每用户速率限制
• 多架构支持：支持amd64和arm64架构

支持的标签及Dockerfile链接

canal Docker镜像的标签由canal版本和基础镜像版本组成，具体如下：

使用场景和适用范围

适用于需要实时同步MySQL数据变更的场景，包括但不限于：

• 数据仓库实时同步
• 缓存数据更新
• 业务数据复制
• 数据备份与容灾
• 微服务间数据一致性维护

使用方法和配置说明

准备工作

MySQL配置

对于自建MySQL，需启用binlog并配置为ROW格式，修改my.cnf如下：

[mysqld]
log-bin=mysql-bin        # 启用binlog
binlog-format=ROW        # 设置binlog格式为ROW
server_id=1              # MySQL复制所需的服务器ID，不可与Canal的slaveId冲突

注意：阿里云RDS for MySQL默认已启用binlog，且账号已具备必要的binlog dump权限，可跳过此步骤。

用户授权

需为Canal用户授予作为MySQL从库的权限。若账号已存在，可直接使用GRANT命令：

sql
CREATE USER 'canal' IDENTIFIED BY 'canal';
GRANT SELECT, REPLICATION SLAVE, REPLICATION CLIENT ON *.* TO 'canal'@'%';
-- GRANT ALL PRIVILEGES ON *.* TO 'canal'@'%';  # 如需全部权限可使用此命令
FLUSH PRIVILEGES;

启动容器

使用以下命令启动canal容器：

bash
docker run -d --name my-canal -p 30306:3306 openeuler/canal:{Tag}

替换{Tag}为实际使用的镜像标签，如1.1.8-oe2403sp1

容器启动后，可通过以下命令查看运行日志：

bash
docker logs my-canal

问题与反馈

如有任何问题或需使用特殊功能，请在openeuler-docker-images提交issue或pull request。