csapplatform/test-app

csap-core Docker镜像

概述

csap-core是一个专为测试设计的Java应用Docker镜像，内置嵌入式JMS（Java消息服务）和数据库组件，提供配置管理与测试验证工具。该镜像旨在简化Java应用的开发测试流程，无需额外部署独立的JMS服务器和数据库，即可快速搭建功能完整的测试环境。

核心功能与特性

• 嵌入式JMS服务：集成消息队列功能，支持点对点和发布/订阅模式，无需外部JMS服务器
• 嵌入式数据库：内置轻量级数据库，支持标准SQL操作，适合测试数据存储与验证
• 配置工具集：提供环境配置、参数调整和资源管理实用工具
• 测试验证组件：包含接口测试、消息处理测试和数据操作测试工具
• 轻量级架构：优化资源占用，适合本地开发和CI/CD测试环境

使用场景

• Java应用开发阶段的本地功能测试
• JMS消息队列集成逻辑的验证测试
• 数据库操作逻辑的单元测试与集成测试
• 快速搭建临时测试环境验证应用功能
• CI/CD流水线中的自动化测试环节

使用方法

基本运行命令

bash
docker run -d -p 8080:8080 -p 61616:61616 --name csap-test-app csap-platform/csap-core

• 8080端口：应用HTTP服务端口
• 61616端口：JMS服务默认端口

环境变量配置

支持通过环境变量自定义运行参数：

• JMS_PORT: JMS服务端口，默认61616
• DB_PORT: 嵌入式数据库端口，默认5432
• LOG_LEVEL: 日志输出级别，可选值：DEBUG、INFO、WARN、ERROR，默认INFO
• APP_CONTEXT: 应用上下文路径，默认/
• MAX_HEAP_SIZE: JVM最大堆内存，默认512m

示例：自定义端口和日志级别

bash
docker run -d \
  -p 8081:8080 \
  -p 61617:61616 \
  -e JMS_PORT=61617 \
  -e LOG_LEVEL=DEBUG \
  -e MAX_HEAP_SIZE=1024m \
  --name csap-custom-app \
  csap-platform/csap-core

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  csap-test:
    image: csap-platform/csap-core
    container_name: csap-test-instance
    ports:
      - "8080:8080"
      - "61616:61616"
      - "5432:5432"
    environment:
      - JMS_PORT=61616
      - DB_PORT=5432
      - LOG_LEVEL=INFO
      - MAX_HEAP_SIZE=768m
    volumes:
      - ./test-data:/app/data  # 持久化数据库数据
      - ./config:/app/config  # 挂载外部配置文件
    restart: unless-stopped

启动命令：docker-compose up -d

数据持久化

通过挂载卷实现数据持久化：

bash
docker run -d \
  -p 8080:8080 \
  -p 61616:61616 \
  -v /local/path/to/data:/app/data \
  -v /local/path/to/config:/app/config \
  --name csap-persistent-app \
  csap-platform/csap-core

• /app/data: 数据库文件存储目录
• /app/config: 外部配置文件目录

注意事项

• 该镜像专为测试环境设计，不建议用于生产环境
• 嵌入式数据库性能有限，不适合高并发测试场景
• 默认配置仅适用于本地测试，生产环境需使用独立的JMS和数据库服务
• 如需自定义应用配置，可通过挂载/app/config目录提供外部配置文件