minimaglobal/minima

Minima Java应用程序镜像文档

镜像概述

本镜像为Minima项目的主要Java应用程序Docker镜像，旨在提供一个标准化、便捷的运行环境，用于部署和运行Minima的核心Java应用组件。通过容器化封装，确保应用在不同环境中具有一致的执行行为，简化部署流程并提升运维效率。

核心功能和特性

• 内置Java运行时：集成Java运行环境（JRE/JDK），无需额外配置即可直接运行Java应用
• 简化部署流程：通过Docker容器化，减少环境依赖问题，实现"一次构建，到处运行"
• 环境变量支持：提供灵活的环境变量配置，可根据不同场景（开发/测试/生产）调整应用参数
• 轻量级基础：基于精简的基础镜像（如Alpine Linux）构建，减小镜像体积，提升启动速度
• 标准化日志输出：默认配置标准输出日志，便于容器日志收集和管理

使用场景

• 开发环境测试：快速部署Minima Java应用进行功能验证和调试
• 生产环境部署：作为Minima核心Java服务的生产运行载体，确保稳定可靠
• CI/CD集成：融入持续集成/持续部署流程，实现自动化构建、测试和部署
• 微服务架构：作为Minima微服务体系中的独立服务节点，参与服务网格通信

使用方法

基本运行命令

通过以下命令启动Minima Java应用容器：

bash
docker run -d \
  --name minima-java-app \
  -p 8080:8080 \
  minima/java-app:latest

自定义配置运行

指定环境变量和挂载配置文件：

bash
docker run -d \
  --name minima-java-app \
  -p 8080:8080 \
  -e APP_PORT=8080 \
  -e LOG_LEVEL=INFO \
  -v /local/config:/app/config \
  minima/java-app:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  minima-java-app:
    image: minima/java-app:latest
    container_name: minima-java-app
    ports:
      - "8080:8080"
    environment:
      - APP_PORT=8080
      - LOG_LEVEL=INFO
      - DB_CONNECTION_STRING=jdbc:mysql://db:3306/minima
    volumes:
      - ./config:/app/config
      - ./logs:/app/logs
    restart: unless-stopped

配置参数

环境变量参数

数据卷挂载

• /app/config：外部配置文件目录，可挂载本地配置覆盖默认配置
• /app/logs：应用日志输出目录，挂载后便于日志持久化和外部收集
• /app/data：应用数据存储目录（如适用），用于持久化应用产生的数据

注意事项

• 确保宿主机端口（如示例中的8080）未被占用，或通过-p参数映射至其他可用端口
• 生产环境建议设置restart: unless-stopped确保容器异常退出后自动重启
• 敏感配置（如数据库密码）建议通过Docker Secrets或外部配置管理工具注入，避免明文环境变量
• 根据应用资源需求调整JVM参数（如HEAP_SIZE），避免资源不足或浪费