自动构建
这是一个运行于Alpine Linux系统中的简易Git容器,Alpine Linux以其极致精简的特性为基础,使得该容器在保持Git核心功能的同时,具备轻量高效的运行表现,尤其适用于各类小型Linux发行版环境,能够满足资源受限场景下的版本控制需求,为嵌入式系统、边缘设备或轻量级开发环境提供便捷的Git服务支持。
docker-git-alpine:基于Alpine Linux的轻量Git容器
简介
这是一个运行在Alpine Linux上的轻量Git容器,尤其适合RancherOS等没有包管理器的小型Linux发行版。
[ ]
重要更新说明
- GitHub Action流水线切换:自2024年10月3日起,自动化构建和部署流水线已从Circle CI迁移至GitHub Action(相关PR:#68、#70)。
- 多架构镜像支持:2021年5月23日新增此功能,具体说明:
- v2.30.2和1.0.30版本已手动推送多架构镜像;
- 旧版本不再更新为多架构镜像;
- 此后新版本均支持多架构(
--platform linux/amd64,linux/arm/v7,linux/arm64/v8,linux/arm/v6,linux/ppc64le,linux/s390x,linux/386); - 仅保证
amd64架构可用(其他架构无测试环境,如有问题需提交PR修复); - 拉取/运行命令与其他架构无差异,例如在ARM设备(如Mac M1芯片)上直接执行
docker pull docker.xuanyuan.run/alpine/git:v2.30.2即可获取对应镜像。
相关链接
- GitHub仓库:[]
- CI构建日志:[]
- Docker镜像标签:[]
使用方法
基础用法
bashdocker run -ti --rm -v ${HOME}:/root -v $(pwd):/git docker.xuanyuan.run/alpine/git <git_command>
例如,克隆本仓库:
bashdocker run -ti --rm -v ${HOME}:/root -v $(pwd):/git docker.xuanyuan.run/alpine/git clone [] #### 可选用法1:简化命令(推荐) 为减少重复输入,可将以下函数添加到`~/.bashrc`或`~/.profile`中: ```bash # 编辑~/.profile,添加以下内容 function git () { (docker run -ti --rm -v ${HOME}:/root -v $(pwd):/git alpine/git "$@") }
保存后执行source ~/.profile生效。之后即可像使用本地Git一样直接运行命令,例如:
bashgit clone [] #### 可选用法2:通过别名快速调用 ```bash alias git="docker run -ti --rm -v $(pwd):/git -v $HOME/.ssh:/root/.ssh alpine/git"
注意:
- 切换仓库时需重新定义别名;
- 仅在Git仓库根目录下使用。
可选用法3:以当前用户身份运行(避免权限问题)
bashalias git='docker run -ti --rm -u$(id -u):$(id -g) -e HOME=${HOME} -v /etc/passwd:/etc/passwd -v /etc/group:/etc/group -v ${HOME}:${HOME} -v $(pwd):/git alpine/git'
优势:
- 通过映射
/etc/passwd和/etc/group文件,以当前用户(非root)身份运行,确保文件权限正确; - 可在任意目录使用(
$(pwd)会在执行时动态获取当前路径)。
操作演示
bash# 进入目标目录 cd application # 设置别名(可选用法2示例) alias git="docker run -ti --rm -v $(pwd):/git -v $HOME/.ssh:/root/.ssh alpine/git" # 克隆私有仓库(需本地SSH密钥) git clone [邮箱已删除]:YOUR_ACCOUNT/YOUR_REPO.git # 进入仓库目录,重新定义别名(切换仓库时需执行) cd YOUR_REPO alias git="docker run -ti --rm -v $(pwd):/git -v $HOME/.ssh:/root/.ssh alpine/git" # 编辑文件后提交 git add . git status git commit -m "test" git push -u origin master
支持的协议
支持git、http/https、ssh协议,详情可参考Git官方文档:[Git on the Server - The Protocols]
自动化构建说明
- 每周自动构建,生成支持多架构的最新Alpine镜像;
- 从镜像中提取Git版本号,以
v${GIT_VERSION}格式打标签; - 同步更新
latest标签。
更多相关 Docker 镜像与资源
以下是 alpine/git 相关的常用 Docker 镜像,适用于 不同场景 等不同场景:
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull alpine/git:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务