ianayoung/rsync

rsync-docker 镜像文档

镜像概述

基于Alpine Linux构建的轻量级Docker镜像，专注于提供rsync及相关工具集。该镜像在Alpine基础上扩展了必要工具，并将默认shell从原生的sh替换为bash，以兼容依赖bash语法的环境配置（如GitLab CI中的密钥注入流程）。

核心功能与特性

• 基础工具集成：包含rsync（核心同步工具）、git（版本控制）、ssh客户端（仅客户端，不含ssh服务器）及ssh-agent（密钥管理工具），满足文件同步、远程连接等基础需求。
• shell环境优化：默认使用bash作为登录shell，替代Alpine标准的sh，支持bash特定语法（如数组、进程替换等），适配依赖bash的复杂脚本场景。
• 轻量级基础：基于Alpine Linux构建，保持较小镜像体积和低资源占用，适合CI/CD等需要快速启动的环境。

使用场景与适用范围

• GitLab CI/CD流程：特别适用于需要rsync进行文件同步或依赖bash语法注入ssh密钥的CI配置（参考GitLab示例）。
• 文件同步任务：用于本地或跨服务器的文件同步（如备份、部署文件推送等）。
• 轻量级工具环境：临时需要rsync、git或ssh客户端的场景（如开发调试、临时运维操作）。

使用方法与配置说明

基本交互使用

启动容器并进入bash交互环境，可直接执行工具命令：

bash
docker run --rm -it rsync-docker

--rm：容器退出后自动清理；-it：启用交互终端

执行rsync同步操作

挂载本地目录到容器，通过rsync同步文件（示例：同步本地/data/source到/data/dest）：

bash
docker run --rm -v /local/data:/data rsync-docker rsync -av /data/source/ /data/dest/

-v /local/data:/data：将本地/local/data目录挂载到容器/data目录，实现数据共享

GitLab CI配置示例

在.gitlab-ci.yml中使用该镜像，通过bash环境注入ssh密钥并执行rsync部署：

yaml
deploy:
  image: rsync-docker
  script:
    # 启动ssh-agent并注入私钥
    - eval $(ssh-agent -s)
    - echo "$SSH_PRIVATE_KEY" | tr -d '\r' | ssh-add -
    # 配置ssh已知主机（避免首次连接确认）
    - mkdir -p ~/.ssh && chmod 700 ~/.ssh
    - ssh-keyscan example.com >> ~/.ssh/known_hosts && chmod 644 ~/.ssh/known_hosts
    # 同步文件到目标服务器
    - rsync -av --delete ./build/ user@example.com:/var/www/app/

自定义配置

• 环境变量：可通过-e参数注入环境变量（如SSH_PRIVATE_KEY、REMOTE_HOST等），供脚本使用。
• 配置文件挂载：如需自定义ssh配置（如~/.ssh/config），可通过-v /local/ssh/config:/root/.ssh/config挂载本地配置文件。