Delvin测试仓库镜像文档

1. 镜像概述

Delvin测试仓库镜像是一个轻量级的测试资源管理工具，专为测试环境设计，用于集中存储、版本控制和分发测试相关资源（如测试数据、配置文件、测试脚本等）。该镜像旨在简化测试流程，提高测试资源的复用性和管理效率，支持跨环境快速部署测试组件。

2. 核心功能与特性

2.1 核心功能

• 资源集中存储：支持多种类型测试资源的统一管理，包括文本文件、二进制文件及结构化数据
• 版本控制：内置基础版本控制机制，记录资源修改历史，支持版本回溯
• 跨环境共享：通过网络接口提供资源访问能力，支持多测试节点/环境共享资源
• 轻量级部署：基于Alpine Linux构建，镜像体积小，启动速度快，资源占用低

2.2 特性

• 支持RESTful API接口，便于集成到CI/CD流程
• 提供基础的访问控制机制，可配置资源读写权限
• 支持资源自动备份与恢复，保障测试数据安全性
• 兼容主流容器编排工具（如Docker Compose、Kubernetes）

3. 使用场景

3.1 适用场景

• 开发团队内部的测试资源共享与协作
• CI/CD流水线中的测试资源动态加载
• 多环境（开发、测试、预发布）测试资源同步
• 自动化测试框架的资源依赖管理

3.2 典型应用

• 存储接口自动化测试的测试用例与配置文件
• 管理性能测试的测试数据集与脚本
• 作为测试环境的配置中心，动态下发测试环境配置

4. 使用方法

4.1 快速启动（Docker Run）

bash
docker run -d \
  --name delvin-test-repo \
  -p 8080:8080 \
  -v /host/test-resources:/app/repo \
  -e REPO_NAME="MyTestRepo" \
  -e AUTH_ENABLED=false \
  delvin/test-repo:latest

参数说明：

• -p 8080:8080：映射容器8080端口到主机，用于API访问
• -v /host/test-resources:/app/repo：挂载主机目录作为仓库存储路径（持久化资源）
• -e REPO_NAME：仓库名称（默认："DelvinTestRepo"）
• -e AUTH_ENABLED：是否启用访问控制（默认：false，可选：true）

4.2 Docker Compose配置

yaml
version: '3'
services:
  test-repo:
    image: delvin/test-repo:latest
    container_name: delvin-test-repo
    ports:
      - "8080:8080"
    volumes:
      - ./test-resources:/app/repo
    environment:
      - REPO_NAME="ProjectAlphaTestRepo"
      - AUTH_ENABLED=true
      - ADMIN_USER="testadmin"
      - ADMIN_PASS="securepassword"  # 仅当AUTH_ENABLED=true时生效
    restart: unless-stopped

4.3 环境变量配置

5. 资源访问接口

启动容器后，可通过以下API接口访问仓库资源（以默认端口8080为例）：

• 列出所有资源：GET http://localhost:8080/api/resources
• 获取资源详情：GET http://localhost:8080/api/resources/{resourceId}
• 上传资源：POST http://localhost:8080/api/resources（需带资源文件表单）
• 删除资源：DELETE http://localhost:8080/api/resources/{resourceId}

注：启用认证时，所有API请求需在Header中携带Authorization: Basic {base64(用户名:密码)}

6. 数据持久化

为避免容器重启导致资源丢失，建议通过-v参数挂载主机目录到容器内/app/repo路径，所有测试资源将存储在该目录下。如需迁移仓库数据，直接复制挂载目录即可。

7. 版本更新

如需更新镜像，可执行以下命令：

bash
docker pull delvin/test-repo:latest
docker stop delvin-test-repo
docker rm delvin-test-repo
# 重新执行docker run命令启动新版本容器（保持原挂载目录）