taosnet/git

镜像概述和主要用途

这是一个用于处理基础Git任务的Docker镜像集合，基于Alpine Linux构建。包含三个标签以满足不同需求：git客户端（latest）、SSH Git服务器（ssh）和GitWeb网页服务器（web），适用于轻量级Git操作、简单Git服务部署及仓库网页浏览场景。

核心功能和特性

• git:latest：轻量级Git客户端，可直接作为Git命令使用，工作目录为/git，支持挂载数据卷持久化仓库。
• git:ssh：基于taosnet/ssh_server的SSH Git服务器，提供createRepository工具简化仓库创建，支持多用户通过SSH访问。
• git:web：简单GitWeb服务器，提供Web界面浏览Git仓库，默认仓库路径为/pub/git。

使用场景和适用范围

• 需要临时或轻量级Git客户端环境，避免在主机安装Git。
• 快速部署小型SSH Git服务器，支持多用户协作。
• 通过Web界面直观浏览和管理Git仓库。

详细使用方法和配置说明

taosnet/git:latest（Git客户端）

基本说明

容器内工作目录为/git，建议将主机目录挂载到/git以实现数据持久化。可通过设置别名将镜像作为本地Git命令使用。

使用示例

设置别名（确保使用单引号，使pwd每次执行时动态获取当前目录）：

bash
alias git='docker run --rm -ti -v `pwd`:/git:Z taosnet/git'

创建新仓库：

bash
cd /path/to/new/repository
git init
git config user.name "我的名字"
git config user.email "email@domain.com"
git add file1 file2 ...
git commit -m "初始提交"

taosnet/git:ssh（SSH Git服务器）

基本说明

基于taosnet/ssh_server镜像，支持通过SSH访问Git仓库，提供createRepository工具创建空仓库。支持环境变量和用户管理工具（继承自基础镜像）。

核心工具

• createRepository：创建新空仓库，用法：createRepository [-u 用户] [-g 组] 仓库路径。仓库路径需不存在，可选指定所有者（-u）和所属组（-g）。

使用示例

创建支持两个用户访问的仓库：

1. 启动SSH Git服务器容器：

bash
docker run --name myrepo -d -p 2222:22 -v myrepo:/repos -e SSH_USER=gitrepo taosnet/git:ssh

2. 创建用户组并添加用户（使用基础镜像的setupUser.sh工具）：

bash
docker exec myrepo addgroup repousers
docker exec myrepo setupUser.sh -g repousers -k 'user1的SSH公钥...' user1
docker exec myrepo setupUser.sh -g repousers -k 'user2的SSH公钥...' user2

3. 创建仓库并设置权限：

bash
docker exec myrepo createRepository -u gitrepo -g repousers /repos/project1

taosnet/git:web（GitWeb服务器）

基本说明

提供Web界面浏览Git仓库，默认仓库路径为/pub/git，需挂载包含Git仓库的卷。

使用示例

1. 首先启动SSH Git服务器并创建仓库：

bash
docker run --name git-server -d -p 2222:22 -v myrepo:/repos -e SSH_USER=gitrepo taosnet/git:ssh
docker exec git-server createRepository -u gitrepo /repos/myproject1

2. 启动GitWeb服务器，挂载仓库卷：

bash
docker run --name git-web -d -p 1234:80 -v myrepo:/pub/git taosnet/git:web

3. 访问Web界面：通过http://服务器IP:1234/浏览仓库。