Git-Sync

镜像概述与主要用途

Git-Sync 是一款用于将 Git 仓库同步至指定目录的 Docker 镜像，核心功能为拉取远程 Git 仓库内容并同步到本地目标路径，支持通过环境变量和命令参数配置同步行为。

核心功能与特性

• Git 仓库同步：拉取指定远程 Git 仓库内容至本地目录。
• 灵活配置：通过环境变量指定目标目录和仓库地址。
• 日志可控：支持配置日志输出方式（如输出到标准错误）及日志详细级别。

使用场景与适用范围

• 静态网站部署：同步 Git 仓库中的静态资源（如 HTML、CSS、JS）至 Web 服务器目录。
• 配置文件同步：将版本控制的配置文件（如应用配置、服务配置）同步到目标服务的配置目录。
• 依赖仓库更新：定期同步第三方依赖或工具仓库至本地开发/生产环境。

使用方法与配置说明

环境变量

命令参数

使用示例

基本同步命令

以下命令创建本地目录并将指定 Git 仓库同步至该目录：

bash
# 创建本地目标目录
mkdir -p /tmp/git-sync

# 运行 Git-Sync 容器
docker run \
  -v /tmp/git-sync:/git \  # 挂载本地目录至容器内目标路径
  -e GIT_SYNC_DEST=/git \   # 容器内目标目录（需与挂载路径一致）
  -e GIT_SYNC_REPO=[***] \  # 远程 Git 仓库 URL
  bborbe/git-sync:1.0.1 \   # 镜像名称及版本
  -logtostderr \            # 日志输出到标准错误
  -v=2                      # 日志级别设为 2（详细日志）

说明：

• -v /tmp/git-sync:/git：将本地 /tmp/git-sync 目录挂载至容器内 /git 目录，作为同步目标。
• 环境变量 GIT_SYNC_DEST 需与挂载的容器内路径一致，确保同步内容写入挂载卷。
• 命令参数 -v=2 控制日志详细程度，可根据需求调整（如 -v=1 为普通日志，-v=0 为精简日志）。

版权与许可

Copyright (c) 2016, Benjamin Borbe <***>
All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
   * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
   * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.