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端口

配置说明

核心配置参数

参数类型	参数名	默认值	说明
环境变量	`SSH_PORT`	22	SSH服务监听端口
环境变量	`GIT_REPO_PATH`	/git	Git仓库存储根目录
环境变量	`AUTHORIZED_KEYS`	空	授权SSH公钥，用于Git访问认证
数据卷	`/git`	容器内临时存储	Git仓库数据持久化目录

仓库管理操作

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

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

访问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 ...