datastax/zdm-ansible

ZDM Proxy部署自动化套件镜像

概述

该Docker镜像提供一套完整的自动化部署套件，专门用于快速、可靠地部署零停机迁移代理(ZDM Proxy)。ZDM Proxy是实现系统（尤其是数据库）零停机迁移的关键组件，能够在迁移过程中维持服务连续性，确保业务不中断。本镜像通过自动化部署流程，简化ZDM Proxy的配置与启动过程，降低人工操作复杂度。

核心功能与特性

• 自动化部署流程：内置脚本自动完成ZDM Proxy的依赖检查、配置文件生成、服务启动等全流程操作
• 零停机迁移支持：深度适配ZDM Proxy的核心能力，确保迁移过程中数据同步与服务可用性
• 环境适应性：支持通过环境变量和配置文件自定义部署参数，适应不同基础设施环境
• 部署验证机制：集成服务健康检查功能，自动验证ZDM Proxy部署状态与运行可用性
• 轻量级设计：基于精简基础镜像构建，最小化资源占用，加速部署流程

使用场景

• 数据库跨版本迁移：如MySQL、PostgreSQL等数据库从旧版本升级至新版本时保持服务可用
• 跨平台数据迁移：在不同云服务商、物理机与云环境之间迁移数据时避免业务中断
• 关键业务系统升级：对停机时间敏感的***、电商等核心系统进行架构调整或版本升级
• 灾备环境构建：部署ZDM Proxy实现生产环境与灾备环境的实时数据同步

详细使用方法

前提条件

• 已安装Docker Engine（20.10+版本）
• 源系统与目标系统网络互通，且已开放必要端口（默认ZDM Proxy通信端口为8080）
• 具备源/目标系统的访问凭证（如数据库用户名、密码）

镜像获取

bash
# 从官方仓库拉取最新版本
docker pull [镜像仓库地址]/zdm-proxy-deployer:latest

# 如需指定版本，替换latest为具体版本号
docker pull [镜像仓库地址]/zdm-proxy-deployer:v1.0.0

注：请将[镜像仓库地址]替换为实际的镜像仓库路径（如企业私有仓库或公共镜像服务地址）

基本部署命令

bash
docker run -d \
  --name zdm-proxy-deployer \
  --network host \
  -e SOURCE_ENDPOINT="source-system:3306" \
  -e TARGET_ENDPOINT="target-system:3306" \
  -e AUTH_USER="admin" \
  -e AUTH_PASSWORD="secure-password" \
  -v /host/config:/app/config \
  [镜像仓库地址]/zdm-proxy-deployer:latest

配置参数说明

环境变量配置

配置文件说明

当需要高级配置时，可通过挂载本地配置文件实现。配置文件采用YAML格式，示例如下：

yaml
# custom.yaml示例
source:
  endpoint: "source-db:3306"  # 源系统地址（与SOURCE_ENDPOINT二选一，环境变量优先级更高）
  timeout: 30s                # 连接超时时间
  tls_enabled: false          # 是否启用TLS加密
target:
  endpoint: "target-db:3306"  # 目标系统地址（与TARGET_ENDPOINT二选一）
  retry_count: 3              # 连接失败重试次数
proxy:
  port: 8080                  # 服务端口（与ZDM_PROXY_PORT二选一）
  buffer_size: 1024MB         # 数据缓存区大小
  health_check_interval: 10s  # 健康检查间隔
auth:
  username: "zdm-admin"       # 认证用户名（与AUTH_USER二选一）
  password: "secure-password" # 认证密码（与AUTH_PASSWORD二选一）

部署验证与管理

bash
# 查看部署进度日志
docker logs -f zdm-proxy-deployer

# 验证ZDM Proxy服务状态（假设映射到主机8080端口）
curl http://localhost:8080/health
# 健康状态返回示例：{"status":"healthy","proxy_version":"1.5.0","sync_state":"active"}

# 停止部署器容器
docker stop zdm-proxy-deployer

# 移除部署器容器
docker rm zdm-proxy-deployer

注意事项

• 生产环境建议通过-v参数挂载持久化目录存储ZDM Proxy配置文件与日志
• 网络模式根据实际环境选择：--network host适用于单机部署，桥接模式需配置端口映射（如-p 8080:8080）
• 敏感信息（如认证密码）建议通过Docker Secrets或环境变量加密传递，避免明文暴露
• 部署前需确保源/目标系统已配置正确的防火墙规则，允许ZDM Proxy的IP与端口访问