git-docker 镜像文档

镜像概述

git-docker是一个轻量级Docker镜像，包含完整的git工具，采用单层结构设计，同时支持amd64（x86_64）和arm64（AArch64）两种主流架构。该镜像旨在提供简洁、高效的git运行环境，适用于需要快速访问git功能的各类场景。

核心功能与特性

1. 单层镜像结构

• 采用单层文件系统设计，减少镜像层数
• 优化镜像体积，提升启动速度和部署效率
• 简化镜像维护，降低依赖冲突风险

2. 多架构支持

• 原生支持amd64架构，适配主流x86_64服务器和工作站
• 支持arm64架构，适用于ARM-based设备（如树莓派、AWS Graviton等）
• Docker会自动根据宿主机架构拉取对应版本

3. 完整git工具集

• 包含完整的git命令行工具
• 支持git的所有核心功能（clone、commit、push、pull、branch等）
• 保持与官方git版本同步更新

使用场景与适用范围

开发与运维场景

• 临时代码拉取与版本控制操作
• 轻量级开发环境搭建
• 嵌入式设备或边缘计算环境中的git操作

CI/CD 流程集成

• 持续集成管道中的代码获取步骤
• 自动化部署流程中的版本检查与控制
• 临时构建环境中的代码同步

自动化脚本执行

• 包含git依赖的自动化脚本运行环境
• 跨平台脚本测试（amd64/arm64环境一致性验证）

使用方法与配置说明

基本使用（docker run）

查看git版本

docker run --rm truemark/git-docker git --version

克隆远程仓库

# 将当前目录挂载到容器内的/workspace目录
docker run --rm -v $(pwd):/workspace truemark/git-docker git clone [***] /workspace/repository

执行git命令序列

docker run --rm -v $(pwd):/workspace truemark/git-docker sh -c "cd /workspace && git init && git add . && git commit -m 'Initial commit'"

Docker Compose 配置示例

创建docker-compose.yml文件：

version: '3.8'
services:
  git-operation:
    image: truemark/git-docker
    volumes:
      - ./project:/app  # 挂载本地项目目录到容器内/app
    working_dir: /app
    command: git pull origin main  # 执行git拉取操作

启动服务：

docker-compose up

高级配置

持久化git配置

如需保存git配置（如用户信息），可挂载git配置目录：

docker run --rm -v $(pwd):/workspace -v ~/.gitconfig:/root/.gitconfig truemark/git-docker git commit -m "Commit with user info"

指定架构运行

# 强制使用amd64架构（需Docker支持多架构）
docker run --rm --platform linux/amd64 truemark/git-docker git --version

# 强制使用arm64架构
docker run --rm --platform linux/arm64 truemark/git-docker git --version

注意事项

• 镜像仅包含git工具，无其他系统工具或依赖库
• 所有数据操作需通过挂载卷实现持久化，容器退出后内部数据将丢失
• 在ARM设备上使用时，确保Docker已启用arm64架构支持
• 如需使用SSH协议访问私有仓库，需挂载SSH密钥文件：-v ~/.ssh:/root/.ssh