Git交互服务镜像文档

概述

本Docker镜像提供轻量级Git交互服务，封装核心Git操作能力，可无缝集成至自动化流程、CI/CD管道或应用系统，简化Git仓库的管理与操作流程。

核心功能与特性

• 全面Git操作支持：涵盖克隆（clone）、拉取（pull）、推送（push）、分支管理、提交（commit）等基础操作
• 多认证机制：支持HTTPS基本认证、SSH密钥认证及令牌认证（适用于GitHub/GitLab等平台）
• 轻量化设计：基于Alpine Linux构建，镜像体积小，资源占用低，启动速度快
• 灵活集成：可通过命令行或API触发操作，支持与脚本、应用程序联动
• 跨平台兼容：支持Linux/Windows/macOS等主流Docker运行环境

使用场景

• CI/CD流程集成：在持续集成流程中自动拉取最新代码进行构建测试
• 自动化部署：部署系统触发时从Git仓库获取指定版本代码
• 本地开发环境：为多项目提供统一的Git操作服务端点
• 数据同步：定期同步分布式系统中的配置文件或代码仓库

使用方法

基础启动命令

docker run -d \
  --name git-service \
  -v /local/repo/path:/app/repo \  # 挂载本地目录存储仓库数据
  -e GIT_REPO_URL="[***]" \  # 目标仓库URL
  -e AUTH_METHOD="https" \  # 认证方式
  -e HTTPS_USER="your-username" \  # HTTPS用户名
  -e HTTPS_PASSWORD="your-password" \  # HTTPS密码
  git-interaction-service:latest

关键配置参数

典型操作示例

1. 使用SSH密钥认证拉取代码

docker run -d \
  --name git-ssh-service \
  -v /local/repo:/app/repo \
  -v /local/ssh/key:/root/.ssh/id_rsa:ro \  # 挂载只读SSH密钥
  -e GIT_REPO_URL="***:example/repo.git" \
  -e AUTH_METHOD="ssh" \
  -e SSH_KEY_PATH="/root/.ssh/id_rsa" \
  -e BRANCH="dev" \
  git-interaction-service:latest

2. 执行特定Git命令

# 拉取最新代码
docker exec git-service git pull origin main

# 提交并推送修改
docker exec git-service sh -c "cd /app/repo && git add . && git commit -m 'Auto-commit from service' && git push origin main"

注意事项

• SSH密钥文件权限需设置为600（容器内），可通过chmod 600 /local/ssh/key预处理
• 敏感认证信息建议使用Docker Secrets或环境变量文件（--env-file）传递
• 大规模仓库操作建议配置Git缓存（git config --global http.postBuffer 524288000）提升性能
• 容器默认工作目录为/app，仓库存储于/app/repo