WhisperClaims Docker镜像文档

镜像概述

WhisperClaims Docker镜像是专为部署企业级索赔管理应用WhisperClaims设计的容器化解决方案。该镜像封装了应用运行所需的全部依赖组件（包括运行时环境、依赖库及配置模板），旨在简化部署流程，确保应用在开发、测试和生产环境中保持一致的运行状态，适用于各类需要高效管理索赔流程的企业场景。

核心功能和特性

• 预配置运行环境：集成应用所需的所有依赖组件，无需手动安装配置，开箱即可运行
• 环境一致性保障：通过容器化技术消除"环境差异"问题，确保应用在不同环境中行为一致
• 快速部署能力：单条Docker命令即可完成部署，相比传统部署方式节省80%以上时间
• 版本化管理：支持通过镜像标签控制应用版本，便于版本回滚和升级管理
• 资源优化：基于Alpine Linux构建，镜像体积小，资源占用低，运行效率高

使用场景和适用范围

• 企业索赔管理系统部署：适用于保险公司、***机构等需要搭建索赔处理系统的企业
• 开发测试环境：为开发团队提供快速搭建的一致测试环境，加速功能开发与测试验证
• 生产环境部署：支持在生产环境中稳定运行，满足业务连续性和高可用性要求
• 多环境并行部署：可同时部署多个独立实例，满足开发、测试、UAT及生产环境并行需求

使用方法和配置说明

基本部署（docker run）

通过以下命令快速启动应用：

bash
docker run -d \
  --name whisperclaims \
  -p 8080:8080 \
  -e DB_HOST=your-postgres-host \
  -e DB_PORT=5432 \
  -e DB_NAME=whisperclaims_db \
  -e DB_USER=dbadmin \
  -e DB_PASSWORD=your-secure-password \
  -v whisperclaims_data:/app/data \
  whisperclaims:latest

Docker Compose部署

创建docker-compose.yml文件实现应用与数据库联动部署：

yaml
version: '3.8'

services:
  whisperclaims:
    image: whisperclaims:latest
    container_name: whisperclaims-app
    restart: always
    ports:
      - "8080:8080"
    environment:
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_NAME=whisperclaims
      - DB_USER=whisper_user
      - DB_PASSWORD=secure_password
      - LOG_LEVEL=INFO
      - TZ=Asia/Shanghai
    volumes:
      - whisperclaims_data:/app/data
    depends_on:
      - postgres
    networks:
      - claims-network

  postgres:
    image: postgres:14-alpine
    container_name: whisperclaims-db
    restart: always
    environment:
      - POSTGRES_DB=whisperclaims
      - POSTGRES_USER=whisper_user
      - POSTGRES_PASSWORD=secure_password
    volumes:
      - postgres_data:/var/lib/postgresql/data
    networks:
      - claims-network

volumes:
  whisperclaims_data:
  postgres_data:

networks:
  claims-network:
    driver: bridge

启动服务：

bash
docker-compose up -d

核心配置参数（环境变量）

数据持久化配置

应用数据（包括上传文件、日志等）通过挂载卷实现持久化：

bash
# 创建专用数据卷（推荐）
docker volume create whisperclaims_data

# 使用数据卷启动容器
docker run -d \
  --name whisperclaims \
  -v whisperclaims_data:/app/data \  # 挂载应用数据卷
  -v /var/log/whisperclaims:/app/logs \  # 可选：挂载日志到主机
  whisperclaims:latest

版本管理与更新

查看可用版本：

bash
docker search whisperclaims --filter=stars=3

指定版本部署：

bash
docker run -d whisperclaims:1.2.0  # 部署1.2.0版本

升级应用：

bash
# 停止旧版本容器
docker stop whisperclaims && docker rm whisperclaims

# 拉取新版本镜像并启动
docker pull whisperclaims:latest
docker run -d --name whisperclaims [配置参数] whisperclaims:latest

注意事项

• 数据库准备：首次启动前需确保数据库服务已运行，且配置的数据库用户具有创建表和插入数据的权限
• 安全建议：生产环境中应通过Docker Secrets或环境变量文件传递敏感信息，避免命令行明文暴露密码
• 性能调优：根据实际负载调整容器资源限制（--memory、--cpus参数）
• 备份策略：定期备份数据库数据和挂载的应用数据卷，防止数据丢失
• 更新周期：建议每季度更新一次镜像以获取最新安全补丁和功能优化