canal/otter-all

Otter Docker镜像文档

1. 镜像概述

本镜像为Otter数据同步工具的Docker化部署包，基于canal/otter-osbase:v1基础镜像构建。镜像集成了Otter的manager（管理端）和node（节点端）组件，通过预配置的目录结构、权限设置及启动脚本，提供开箱即用的Otter运行环境，简化数据同步服务的部署流程。

2. 核心功能与特性

• 组件集成：内置Otter manager.deployer和node.deployer部署包，无需额外下载安装
• 环境预配置：自动创建必要目录（如日志目录/home/admin/manager/logs、/home/admin/node/logs及zkData目录），并设置权限
• 用户权限管理：统一使用admin用户运行服务，确保目录访问权限一致性
• 启动脚本集成：通过/alidata/bin/main.sh作为入口点，配合/home/admin/app.sh启动命令，实现服务自动化启动
• 环境变量配置：默认设置DOCKER_DEPLOY_TYPE=VM，并扩展PATH包含MySQL相关工具路径

3. 使用场景

• 分布式数据同步任务部署与管理
• 数据库主从复制或多节点数据同步
• 需要快速搭建Otter服务的开发、测试或生产环境
• 容器化环境下的数据同步服务集成

4. 使用方法

4.1 基本运行命令

bash
docker run -d --name otter-service otter-image:latest

4.2 自定义配置运行

如需挂载外部配置或日志目录，可使用以下命令：

bash
docker run -d \
  --name otter-service \
  -v /host/path/manager/conf:/home/admin/manager/conf \
  -v /host/path/node/conf:/home/admin/node/conf \
  -v /host/path/logs:/home/admin/manager/logs \
  -p 8080:8080 \  # manager web端口
  -p 2088:2088 \  # node通信端口
  otter-image:latest

4.3 Docker Compose配置示例

yaml
version: '3'
services:
  otter:
    image: otter-image:latest
    container_name: otter-service
    ports:
      - "8080:8080"
      - "2088:2088"
    volumes:
      - ./manager/conf:/home/admin/manager/conf
      - ./node/conf:/home/admin/node/conf
      - ./logs:/home/admin/manager/logs
      - ./zkData:/home/admin/zkData
    environment:
      - DOCKER_DEPLOY_TYPE=VM  # 可根据部署环境调整
    restart: unless-stopped

5. 配置说明

5.1 环境变量

5.2 目录结构

5.3 启动流程

1. 容器启动时执行ENTRYPOINT ["/alidata/bin/main.sh"]，作为入口脚本
2. 入口脚本完成初始化后，调用CMD ["/home/admin/app.sh"]启动Otter服务
3. 服务启动后，可通过映射的manager端口（默认8080）访问Web管理界面

5.4 权限说明

• 所有服务文件及目录所有权为admin:admin
• 可执行脚本（如/home/admin/*.sh、/home/admin/bin/*.sh）已添加执行权限
• 日志及数据目录具备读写权限，支持持久化存储