kalbasit/git-syncer

Git Syncer镜像说明

镜像概述

Git Syncer是一个轻量级工具，用于同步多个Git仓库的内容，支持通过SSH密钥认证实现安全同步，适用于代码备份、多仓库内容一致性维护等场景。

核心功能

• 同步多个Git仓库（支持SSH协议）
• 灵活的SSH密钥配置：可通过挂载文件或环境变量注入密钥
• 数据卷存储：使用/data目录保存同步过程中的临时文件
• 提供Systemd配置示例（位于contrib目录）

使用场景

1. 代码备份：将主仓库同步到备用仓库，确保数据安全
2. 多仓库同步：保持不同平台（如GitHub、GitLab）上的仓库内容一致
3. 自动化同步任务：结合Systemd或定时任务实现定期同步

配置说明

SSH密钥配置

• 挂载文件：将SSH私钥文件挂载到容器的/root/.ssh/id_rsa路径
• 环境变量：设置SSH_KEY环境变量，值为私钥内容

数据卷配置

建议创建数据卷容器存储同步数据：

bash
docker run --name git_syncer_volumes -v /data busybox true 2>/dev/null || true

部署示例

直接同步仓库

bash
docker run --rm kalbasit/git-syncer sync git@github.com:user/repo1.git git@github.com:user/repo2.git

带SSH密钥挂载的同步

bash
docker run --rm -v /path/to/your/ssh/key:/root/.ssh/id_rsa kalbasit/git-syncer sync git@github.com:user/source.git git@github.com:user/target.git

使用环境变量注入密钥

bash
docker run --rm -e SSH_KEY="$(cat /path/to/your/ssh/key)" kalbasit/git-syncer sync ***:user/source.git ***:user/target.git