mtand/rsync

基于Alpine的简易rsync容器

镜像概述

这是一个基于Alpine Linux的轻量级rsync容器，提供rsync服务器和客户端功能，旨在简化Docker环境中的数据同步操作。该镜像可轻松实现Docker卷、数据容器之间的数据同步，支持定时任务调度和SSH密钥认证，适用于各种数据备份和迁移场景。

核心功能与特性

• 轻量级：基于Alpine Linux，镜像体积小，资源占用低
• 双模式支持：可作为rsync客户端或服务器运行
• 灵活的数据挂载：支持Docker卷和数据容器挂载
• 定时任务：通过环境变量配置定时同步任务
• 安全认证：基于SSH密钥的安全认证机制
• 多客户端支持：服务器模式可配置多个客户端SSH密钥

使用场景

• 从远程服务器同步数据到Docker卷
• 数据容器间的数据迁移
• 定时自动备份Docker卷数据
• 跨主机Docker环境的数据同步
• Rancher平台中容器间的数据迁移

详细使用方法

基础使用

从远程服务器同步到Docker卷

bash
$ docker run --rm -v blobstorage:/data/ mtand/rsync \
         rsync -avzx --numeric-ids user@remote.server.domain.or.ip:/var/local/blobs/ /data/

从远程服务器同步到数据容器

bash
$ docker run -d --name data -v /data busybox
$ docker run --rm --volumes-from=data mtand/rsync \
         rsync -avz user@remote.server.domain.or.ip:/var/local/blobs/ /data/

高级使用

客户端设置

启动客户端以实现夜间打包和同步：

bash
$ docker run --name=rsync_client -v client_vol_to_sync:/data \
             -e CRON_TASK_1="0 1 * * * /data/pack-db.sh" \
             -e CRON_TASK_2="0 3 * * * rsync -e 'ssh -p 2222' -aqx --numeric-ids root@foo.bar.com:/data/ /data/" \
         mtand/rsync client

从控制台输出中复制客户端SSH公钥，用于服务器配置。

服务器设置

在foo.bar.com上启动服务器：

bash
# docker run --name=rsync_server -d -p 2222:22 -v server_vol_to_sync:/data \
             -e SSH_AUTH_KEY_1="<来自rsync_client的SSH密钥>" \
             -e SSH_AUTH_KEY_n="<来自rsync_client_n的SSH密钥>" \
         mtand/rsync server

验证功能

在服务器上添加测试文件：

bash
$ docker exec -it rsync_server sh
  $ touch /data/test

在客户端上同步文件：

bash
$ docker exec -it rsync_client sh
  $ rsync -e 'ssh -p 2222' -avz root@foo.bar.com:/data/ /data/
  $ ls -l /data/

在Rancher中实现容器间数据同步

1. 请求从源容器主机服务器到新安装环境中可访问服务器的2222端口TCP访问权限。

2. 在要迁移数据的主机（如生产环境）上启动rsync客户端：

   基础设施 -> 主机 -> 添加容器

   • 选择镜像：mtand/rsync
   • 命令：sh
   • 卷 -> 从卷：选择源容器

3. 打开容器日志，从消息中复制SSH密钥。

4. 在目标主机（如开发环境）上启动rsync服务器。目标容器应临时移至可访问的服务器（如果尚未在其中）：

   基础设施 -> 主机 -> 添加容器

   • 选择镜像：mtand/rsync
   • 端口映射 -> +(添加)：2222:22
   • 命令：server
   • 添加环境变量：SSH_AUTH_KEY="<来自rsync客户端的SSH密钥>"
   • 卷 -> 从卷：选择目标容器

5. 在步骤1的rsync客户端容器中运行：

bash
  $ rsync -e 'ssh -p 2222' -avz <源数据位置> root@<开发环境目标主机IP>:<目标位置>

6. 同步完成后，可删除rsync服务器，并将目标容器移回原位（如需要）。

环境变量说明

客户端模式

• CRON_TASK_1 至 CRON_TASK_n: 配置定时任务，格式为"分 时 日 月 周 命令"
• 示例: CRON_TASK_1="0 1 * * * /data/pack-db.sh"

服务器模式

• SSH_AUTH_KEY_1 至 SSH_AUTH_KEY_n: 配置允许访问的客户端SSH公钥
• 示例: SSH_AUTH_KEY_1="ssh-rsa AAAAB3NzaC1yc2EAAA..."