binfalse/git-pull

Docker:Git-Pull 镜像文档

镜像概述和主要用途

Docker:Git-Pull是一个用于保持Git项目自动更新的Docker镜像。基于Debian测试版的精简镜像构建，内置Git工具，通过将Git项目目录挂载到容器的/git-project卷，实现自动拉取远程仓库的最新更改。同时支持挂载前置和后置脚本，在拉取操作前后执行自定义逻辑。

核心功能和特性

• 自动拉取更新：容器运行时自动检测并拉取挂载项目的最新远程更改
• 脚本扩展：支持挂载/pre-pull和/post-pull脚本，分别在拉取前（检测到新提交时）和拉取后执行
• SSH仓库支持：通过挂载配置好的SSH目录，支持从SSH协议的Git仓库拉取代码
• 轻量级基础：基于Debian测试版的精简镜像，体积小且资源占用低

使用场景和适用范围

• 定期更新Git项目的自动化任务
• 持续集成/持续部署(CI/CD)流程中拉取最新代码
• 需要在代码拉取前后执行特定操作（如备份、依赖安装、构建等）的场景
• 从SSH协议的私有Git仓库拉取代码的场景

使用方法和配置说明

基本使用

将本地Git项目目录挂载到容器的/git-project卷，容器会自动拉取最新更改：

bash
docker run --rm -v /path/to/local/project:/git-project binfalse/git-pull

执行后，容器运行内置的git-pull脚本，更新/git-project目录中的项目。

使用前置/后置脚本

通过挂载脚本文件到容器的特定路径，实现拉取前后的自定义操作：

• /pre-pull：当git fetch检测到远程有新提交时，在git pull执行前运行
• /post-pull：在git pull执行完成后运行

示例（同时挂载前置和后置脚本）：

bash
docker run --rm \
  -v /path/to/local/project:/git-project \
  -v /path/to/pre-script.sh:/pre-pull \
  -v /path/to/post-script.sh:/post-pull \
  binfalse/git-pull

注意：挂载的脚本文件需具有可执行权限（通过chmod +x script.sh设置）

从SSH仓库拉取

从SSH协议的Git仓库拉取代码需要配置SSH密钥和已知主机信息，步骤如下：

1. 创建SSH目录

bash
mkdir /PATH/TO/SSHDIR

2. 生成无密码SSH密钥

在容器中生成SSH密钥（挂载SSH目录到容器的/root/.ssh）：

bash
docker run --rm -it \
  -v /path/to/local/project:/git-project \
  -v /PATH/TO/SSHDIR:/root/.ssh \
  --entrypoint /bin/bash \
  binfalse/git-pull

进入容器后执行：

bash
ssh-keygen -b 4096

所有提示直接回车（不设置密码短语）

3. 配置仓库访问权限

将生成的公钥（/PATH/TO/SSHDIR/id_rsa.pub）添加到Git仓库的部署密钥中（授予读权限）

4. 确认远程主机指纹

在容器中执行git pull，首次连接时接受远程主机指纹（自动保存到known_hosts）

5. 运行拉取命令

配置完成后，使用以下命令拉取SSH仓库更新：

bash
docker run --rm \
  -v /path/to/local/project:/git-project \
  -v /PATH/TO/SSHDIR:/root/.ssh \
  binfalse/git-pull

许可证

Docker Image for a Docker:Git-Pull.
Copyright (C) 2009-2017 Martin Scharm <[***]>

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <[***]>.