bauk/git

bauk/git Docker镜像文档

概述

bauk/git镜像用于在Docker Hub上自动构建，旨在提供一种简单的方式来试用或测试不同版本的Git，无需手动安装。通过该镜像，用户可以快速切换不同Git版本，适用于开发测试、版本兼容性验证等场景。

核心功能与特性

• 多版本支持：提供多种Git版本，满足不同场景下的版本需求
• 多操作系统支持：基于Fedora（默认）和CentOS等操作系统构建
• 灵活标签体系：通过标签区分不同操作系统、Git版本和镜像类型
• 轻量与完整版本：提供基础版（仅含Git）和完整版（包含git-filter-repo、vim、git-lfs等工具）
• 便捷配置：支持通过环境变量或外部配置文件自定义Git配置

标签说明

标签格式及示例

内部标签（请勿使用，可能变更）：{os}-base（基础镜像）、{os}-build-base（构建基础镜像）、{os}-build-{version}（编译缓存镜像）、docs（文档镜像）

支持的操作系统

镜像类型

使用方法

基本用法

传递给镜像的任何命令将直接传递给Git（例如show将执行git show）。若第一个参数是sh或bash，则直接执行该命令（适用于启动交互式会话）。

环境变量

• VERBOSE：非空时，入口脚本将输出日志到屏幕
• CFG_XXX：以CFG_开头的变量将转换为Git系统配置，例如CFG_USER_NAME="张三"将执行git config --system user.name "张三"
• EXTERNAL_CONFIG_FILE：可选配置文件路径，默认为/gitconfig

使用示例

bash
# 测试镜像：查看帮助和版本
docker run --rm bauk/git --help
docker run --rm bauk/git --version

# 启动交互式shell
docker run --rm -it bauk/git sh
docker run --rm -it bauk/git bash

# 对主机仓库执行命令
docker run --rm --user $UID -v /path/to/host/repo:/git bauk/git show
docker run --rm --user $UID -v /path/to/host/repo:/git bauk/git log -n3

# 在当前仓库启动交互式会话
docker run --rm -it --user $UID -v $PWD:/git bauk/git bash

# 加载自定义git配置文件
docker run --rm -it -v ~/.gitconfig:/gitconfig bauk/git bash

# 设置单个配置项（如user.name）
docker run --rm -it -e "CFG_USER_NAME=张三" bauk/git config --list

# 完整配置示例：当前仓库+自定义配置+交互式会话
docker run --rm -it --user $UID -v $PWD:/git -v ~/.gitconfig:/gitconfig bauk/git bash

# 指定Git版本（用于版本测试）
docker run --rm -it --user $UID -v $PWD:/git -v ~/.gitconfig:/gitconfig bauk/git:1.8.2.3 bash
docker run --rm -it --user $UID -v $PWD:/git -v ~/.gitconfig:/gitconfig bauk/git:2.24.0 bash

# 使用完整版镜像过滤仓库历史（移除a.zip）
docker run --rm -it --user $UID -v $PWD:/git -v ~/.gitconfig:/gitconfig bauk/git:full filter-repo --path a.zip --invert-paths

设置为默认Git（无本地Git时）

若本地未安装Git，可通过别名使用该镜像（执行速度比本地Git慢，但无需安装）。将以下内容添加到.bash_profile：

bash
alias dgit='docker run --rm -it --user $UID -v $PWD:/git -v ~/.gitconfig:/gitconfig bauk/git'

之后可使用dgit代替git（如dgit status）。频繁使用时，可考虑使用持久化容器以提高效率。

自定义Git配置

通过环境变量传递Git配置：

bash
docker run --rm -it -e CFG_CORE_PAGER=less -e CFG_COLOR_UI=auto bauk/git config --list

开发与构建

每个Docker构建对应一个标签，setupTags.sh脚本用于构建、测试并推送标签至Docker Hub。master分支是所有新标签的基础，更新标签需从master分支新提交重新创建。