fluxcd/gitsrv

Alpine Git Server (Flux E2E测试专用)

镜像概述

本镜像是基于Alpine Linux的轻量级Git服务器，专为Flux的端到端（E2E）测试场景设计。Alpine Linux的底层确保了镜像体积小（通常<50MB）、启动速度快且资源占用低，适合作为测试环境中的Git服务组件，为Flux控制器提供稳定的Git仓库访问端点。

核心功能和特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小，内存占用低，适合测试环境快速部署
• 完整Git服务：内置Git和OpenSSH服务，支持标准Git操作（clone、push、pull、branch等）
• Flux测试优化：默认配置适配Flux E2E测试需求，可直接作为Flux的Git数据源
• 灵活认证：支持SSH密钥认证，通过环境变量或数据卷配置授权密钥
• 持久化支持：支持数据卷挂载，确保测试过程中Git仓库数据可持久化
• 快速部署：单容器部署，无需复杂依赖，一键启动测试环境

使用场景和适用范围

主要应用场景

• Flux控制器测试：作为测试环境中的Git仓库，验证Flux同步Git配置到Kubernetes集群的能力
• Flux功能验证：测试分支策略、提交触发、配置更新等Flux核心功能的正确性
• GitOps流程测试：模拟完整GitOps工作流，验证从Git仓库变更到集群状态同步的全流程
• 自动化测试集成：可集成到CI/CD管道，作为Flux相关自动化测试的基础设施

适用人群

• Flux开发团队：用于开发阶段的功能测试和回归测试
• 测试工程师：构建Flux自动化测试环境的基础设施组件
• GitOps实践者：在本地或测试环境验证Flux配置的有效性

使用方法

Docker Run示例

基本启动（默认配置）

bash
docker run -d --name flux-test-git-server -p 2222:22 -v ./git-repos:/git ghcr.io/fluxcd/alpine-git-server:latest

• -p 2222:22：将容器内SSH端口（22）映射到主机2222端口
• -v ./git-repos:/git：挂载本地目录./git-repos到容器内/git目录，持久化Git仓库数据

自定义配置启动

bash
docker run -d --name flux-test-git-server \
  -p 2233:2222 \
  -v /host/path/to/git-data:/git \
  -e SSH_PORT=2222 \
  -e AUTHORIZED_KEYS="ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQ..." \
  ghcr.io/fluxcd/alpine-git-server:latest

• SSH_PORT=2222：修改容器内SSH服务监听端口为2222
• AUTHORIZED_KEYS：预配置授权SSH公钥（多个公钥用换行符分隔）
• 端口映射调整为2233:2222以匹配自定义SSH端口

配置说明

核心配置参数

仓库管理操作

1. 创建测试仓库
   通过容器命令行创建 bare 仓库（Git服务器标准配置）：

   bash
   # 进入容器
   docker exec -it flux-test-git-server sh
   # 创建测试仓库
   cd /git && git init --bare flux-test-repo.git
   

2. 访问Git仓库
   通过SSH协议克隆仓库（默认用户为git）：

   bash
   git clone ssh://git@localhost:2222/git/flux-test-repo.git
   

   注意：需确保本地SSH密钥已添加到容器的授权列表（通过AUTHORIZED_KEYS环境变量或/git/.ssh/authorized_keys文件）

持久化配置

为避免容器重启导致测试数据丢失，必须通过数据卷挂载持久化/git目录：

bash
# 本地目录持久化（推荐）
docker run -v /host/mount/path:/git ...

# 命名卷持久化（适合Docker Compose场景）
docker volume create flux-git-data
docker run -v flux-git-data:/git ...

注意事项

• 本镜像仅用于测试环境，不建议用于生产环境
• 默认SSH用户为git，不支持密码认证，仅通过SSH密钥授权
• 如需多密钥管理，可通过挂载/git/.ssh/authorized_keys文件（权限需设为600）
• 容器启动时会自动创建git用户（UID 1000），挂载目录需确保该用户有读写权限