Progressoft ASV Core Docker 镜像文档

镜像概述和主要用途

Progressoft ASV Core 是一个为Apollo平台设计的核心组件镜像，提供应用服务验证(ASV)相关的基础功能。该镜像旨在为微服务架构提供可靠的服务验证、集成测试和性能评估能力，帮助开发团队确保服务质量和兼容性。

核心功能和特性

• 提供标准化的服务验证框架和接口
• 支持多协议服务测试(HTTP, gRPC, REST等)
• 内置性能基准测试和负载测试工具
• 提供详细的测试报告生成和分析功能
• 支持自定义测试用例和验证规则
• 集成监控和指标收集功能
• 兼容主流CI/CD管道和自动化测试流程
• 轻量级设计，资源占用低，启动速度快

使用场景和适用范围

• 微服务架构下的服务集成测试
• API兼容性验证和版本控制
• 持续集成流程中的自动化测试环节
• 服务性能评估和基准测试
• 开发环境中的服务功能验证
• 生产环境前的预验证流程
• 需要标准化测试框架的团队和项目

详细的使用方法和配置说明

基本使用方法

Docker Run 命令示例

bash
docker run -d \
  --name asv-core \
  -p 8080:8080 \
  -e SPRING_PROFILES_ACTIVE=prod \
  -e ASV_SERVER_PORT=8080 \
  -e ASV_LOG_LEVEL=INFO \
  -v ./config:/app/config \
  -v ./reports:/app/reports \
  gitlab.com/progressoft/apollo/asv-core/progressoft-asv-core:latest

Docker Compose 配置示例

yaml
version: '3.8'
services:
  asv-core:
    image: gitlab.com/progressoft/apollo/asv-core/progressoft-asv-core:latest
    container_name: asv-core-service
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=prod
      - ASV_SERVER_PORT=8080
      - ASV_LOG_LEVEL=INFO
      - ASV_DB_HOST=postgres
      - ASV_DB_PORT=5432
      - ASV_DB_NAME=asv_core
      - ASV_DB_USER=asv_user
      - ASV_DB_PASSWORD=secure_password
    volumes:
      - ./config:/app/config
      - asv-reports:/app/reports
      - asv-cache:/app/cache
    depends_on:
      - postgres

  postgres:
    image: postgres:13
    container_name: asv-postgres
    environment:
      - POSTGRES_DB=asv_core
      - POSTGRES_USER=asv_user
      - POSTGRES_PASSWORD=secure_password
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  asv-reports:
  asv-cache:
  postgres-data:

环境变量说明

配置参数说明

配置文件可通过挂载/app/config目录提供，支持.properties和.yml格式。主要配置参数包括：

yaml
# application.yml 示例
asv:
  validation:
    strict-mode: false
    fail-on-warning: false
    retry-count: 3
  reporting:
    enabled: true
    path: /app/reports
    retention-days: 30
  services:
    discovery:
      enabled: true
      timeout-ms: 5000
  security:
    enabled: false
    api-key: ""

数据持久化

为确保测试报告和配置数据不丢失，建议挂载以下目录：

• /app/config: 配置文件目录
• /app/reports: 测试报告存储目录
• /app/cache: 缓存数据目录

使用方法详解

基本工作流程

1. 启动ASV Core容器并配置必要参数
2. 通过API或配置文件定义测试用例
3. 执行服务验证测试
4. 从报告目录获取测试结果
5. 根据测试结果进行服务调整和优化

API 使用示例

服务启动后，可以通过REST API与其交互：

bash
# 提交测试任务
curl -X POST http://localhost:8080/api/v1/tests \
  -H "Content-Type: application/json" \
  -d '{"serviceName":"payment-service","version":"1.0.0","testSuite":"integration"}'

# 获取测试结果
curl http://localhost:8080/api/v1/tests/{testId}/result

注意事项

• 生产环境中应启用安全认证功能
• 高并发测试场景下建议适当调整资源限制
• 定期清理报告目录以避免磁盘空间耗尽
• 不同版本间可能存在配置兼容性变化，请查阅版本变更日志
• 数据库连接信息应使用安全方式管理，避免明文环境变量

版本信息

镜像版本与Progressoft ASV Core版本保持一致，可通过标签指定具体版本：

bash
gitlab.com/progressoft/apollo/asv-core/progressoft-asv-core:1.0.0

建议在生产环境中使用固定版本而非latest标签，以确保环境一致性。