backend-tests-git-server

镜像概述

backend-tests-git-server是一个基于Alpine Linux的轻量级Git服务器Docker镜像，衍生自git-server-docker项目。该镜像专为测试和调试场景设计，内置预配置的密钥对和Git仓库，可快速集成到后端开发环境中，提供本地Git服务模拟能力。

!git server docker

核心功能与特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低
• 内置密钥对：keys目录包含用于服务器认证的密钥对（私钥仅用于测试调试）
• 预配置仓库：repos目录提供即用型Git仓库，容器启动时自动部署到服务目录
• 测试优化：采用tmpfs存储密钥和仓库，确保数据非持久化，适合测试场景
• 开发集成：支持与后端开发环境的Docker网络集成，通过容器名或IP直接访问

安全警告：内置密钥对仅用于测试和调试，严禁在生产环境或其他场景使用。

使用场景

• 本地Git服务器功能测试
• 后端开发环境中Git服务依赖模拟
• 集成测试中的代码仓库访问流程验证
• 开发环境下Git操作的快速调试

使用方法

基本使用

本镜像的基础用法与原镜像（git-server-docker）一致，详细文档可参考其GitHub仓库。

镜像扩展功能主要体现在以下两个目录：

• keys：存储用于服务器认证的密钥对，容器启动时自动部署到认证目录
• repos：包含预配置的Git仓库，容器启动时自动复制到服务目录

密钥和仓库的具体部署逻辑可参考镜像内的Dockerfile和start.sh脚本。

本地测试与调试配置

若后端开发环境已启动，且容器在yd-subnet网络中以git-server名称运行（IP：172.42.0.14），可通过以下步骤本地访问仓库：

1. 编辑~/.ssh/config文件，添加如下配置：

   Host git-server
       Hostname 172.42.0.14
       IdentityFile <PATH_TO_KEY>/backend-tests-git-server/keys/id_ed25519
       IdentitiesOnly yes
   

2. 配置说明：

   • Host git-server：与容器及服务名称保持一致（在后端docker-compose.yml中定义）
   • Hostname：容器在yd-subnet网络中的固定IP
   • IdentityFile：本地密钥文件路径，需替换为实际路径
   • IdentitiesOnly yes：确保仅使用指定密钥进行认证

配置完成后，可通过git clone git@git-server:/git-server/repos/<REPO_NAME>.git访问仓库。

密钥管理

添加密钥对

在keys目录中添加新的密钥对文件，容器启动时会自动将其复制到容器内的SSH认证目录，无需额外配置即可生效。

仓库管理

方法1：通过Dockerfile集成公开仓库

若需添加公开可访问的仓库，可在Dockerfile中添加以下命令，将公开仓库克隆为bare仓库并存储到/repos目录：

RUN git clone --bare [***] /repos/new_repo.git

方法2：手动创建bare仓库

对于无法公开访问的仓库，可按以下步骤手动创建bare仓库：

1. 创建临时Git仓库并初始化：

   cd repos
   mkdir tmp && cd tmp
   git init
   git branch -M master
   touch README.md
   git add README.md
   git commit -m"initial commit"
   

2. 克隆为bare仓库并清理临时文件：

   cd ..
   git clone --bare tmp <REPO_NAME>.git
   rm -rf tmp/
   

3. 为空白目录添加.gitkeep文件（确保Git能跟踪）：

   touch repos/<REPO_NAME>.git/refs/heads/.gitkeep
   touch repos/<REPO_NAME>.git/refs/tags/.gitkeep
   touch repos/<REPO_NAME>.git/branches/.gitkeep
   

新仓库将通过git@git-server:/git-server/repos/<REPO_NAME>.git地址对后端服务及本地环境（已配置.ssh/config）可见。

镜像更新与部署

镜像构建与推送

修改Dockerfile或相关文件后，需执行以下步骤更新镜像：

1. 为提交打标签（格式如1.2.3）
2. 推送标签至代码仓库，触发DockerHub自动构建
3. 构建完成的镜像名称为cycloid/backend-tests-git-server:v<VERSION>（如v1.2.3）

集成至youdeploy环境

1. 更新youdeploy-http-api项目的docker-compose.yml，指定新镜像标签
2. 更新cycloid-stacks以缓存新镜像，确保部署环境可拉取最新版本

Cycloid使用说明

在Cycloid环境中，该Git服务器用于集成测试，仓库内容应保持稳定，所有修改均为临时且非持久化。docker-compose.yml已配置使用tmpfs存储密钥和仓库，避免数据持久化。