secoresearch/rsync

rsync容器镜像

镜像概述

本镜像提供rsync工具的容器化部署方案，rsync是高效的文件同步工具，支持增量传输、压缩等特性，可实现本地与本地、本地与远程（SSH）之间的文件同步，简化部署与使用流程。

核心功能

• 支持本地及远程（SSH）文件同步
• 通过环境变量灵活配置同步参数
• 提供SSH密钥认证（文件路径或直接输入密钥内容）
• 可集成到OpenShift环境，支持定时同步任务

使用场景

• 日常文件备份与跨主机同步
• 远程服务器文件定时同步
• OpenShift集群内数据迁移与同步

配置说明

以下环境变量用于配置容器：

DEBUG=
SSH_PRIVATE_KEY_FILE=/secrets/id_rsa
SSH_PRIVATE_KEY=<private key here> # 优先于SSH_PRIVATE_KEY_FILE
SSH_KNOWN_HOSTS_FILE=/config/known_hosts
SSH_KNOWN_HOSTS=<known_hosts contents here> # 优先于SSH_KNOWN_HOSTS_FILE
RSYNC_SOURCE=/m/source/
RSYNC_TARGET=/m/target/
RSYNC_OPTIONS=-avz

• SSH_PRIVATE_KEY_FILE: SSH私钥文件路径（用于远程主机访问）
• SSH_PRIVATE_KEY: 直接输入SSH私钥内容（优先级更高）
• SSH_KNOWN_HOSTS_FILE: 远程主机公钥文件路径
• SSH_KNOWN_HOSTS: 直接输入远程主机公钥内容（优先级更高）
• RSYNC_SOURCE: 同步源路径（本地或远程，如user@host:/path）
• RSYNC_TARGET: 同步目标路径（本地或远程）
• RSYNC_OPTIONS: rsync额外选项（请勿覆盖'-e'参数）

Docker部署示例

基本运行命令

bash
docker run -d \
  -e SSH_PRIVATE_KEY="$(cat ~/.ssh/id_rsa)" \
  -e SSH_KNOWN_HOSTS="$(cat ~/.ssh/known_hosts)" \
  -e RSYNC_SOURCE="/local/source" \
  -e RSYNC_TARGET="user@remotehost:/remote/target" \
  -e RSYNC_OPTIONS="-avz" \
  docker.xuanyuan.run/secoresearch/rsync

OpenShift集成

前提条件

已安装OpenShift CLI并登录：

bash
oc login

导入镜像到内部Registry

bash
oc import-image rsync:latest --from=docker.io/secoresearch/rsync:latest --confirm --scheduled true

设置镜像流查找策略

bash
oc set image-lookup rsync

创建定时同步CronJob

1. 创建SSH密钥Secret：

bash
oc create secret generic <secret-name> --from-file=ssh-privatekey=<path/to/ssh/privatekey> --type=kubernetes.io/ssh-auth

2. 使用模板创建CronJob：

bash
oc process -f 'template-rsync-cronjob.yaml' --param-file <template-parameters-file> | oc create -f -

或直接指定参数：

bash
oc process -f 'template-rsync-cronjob.yaml' -p CRONJOB_NAME=example-rsync -p ... | oc create -f -

（参考rsync-cronjob-example.params获取参数示例）