choerodon/javabase

Choerodon Java基础Docker镜像

1. 镜像概述

Choerodon Java基础Docker镜像是Choerodon数字化协同平台的官方基础镜像，专为Choerodon平台微服务应用提供标准化的Java运行环境。该镜像基于稳定版JDK构建，集成了优化的JVM默认配置及基础系统依赖，旨在减少微服务部署过程中的环境配置差异，提升服务部署效率和一致性。

2. 核心功能与特性

2.1 标准化Java运行环境

• 基于指定版本OpenJDK构建（具体版本可通过镜像标签获取，如choerodon/java-base:11对应JDK 11），确保跨环境Java版本一致性
• 预装基础系统依赖（如字体支持、时区配置等），满足常规Java应用运行需求

2.2 优化的JVM配置

• 内置默认JVM参数优化，针对微服务场景调整内存分配、垃圾回收策略
• 支持通过环境变量自定义JVM参数，灵活适配不同应用资源需求

2.3 轻量级与可扩展性

• 基于Alpine或Debian Slim基础镜像构建，减小镜像体积
• 预留扩展接口，支持集成应用监控、日志收集等平台组件

2.4 多环境支持

• 支持通过环境变量配置应用运行参数，适配开发、测试、生产等多环境
• 兼容Choerodon平台配置中心，便于集中管理应用配置

3. 使用场景

• Choerodon微服务开发与部署：作为基础镜像构建Choerodon平台各微服务（如API网关、用户服务、项目管理服务等）
• 企业级Java应用容器化：为企业内部Java应用提供标准化运行环境，减少环境配置差异
• 持续集成/持续部署（CI/CD）：集成到CI/CD流程中，实现微服务自动化构建、测试和部署
• 微服务集群部署：在Kubernetes等容器编排平台中，作为微服务集群的基础运行环境

4. 使用方法与配置说明

4.1 基础使用（docker run）

bash
docker run -d \
  --name choerodon-java-app \
  -p 8080:8080 \
  -e JAVA_OPTS="-Xms512m -Xmx1024m" \
  -e SPRING_PROFILES_ACTIVE="prod" \
  choerodon/java-base:latest \
  java -jar /app/app.jar

4.2 关键环境变量配置

4.3 Docker Compose示例

yaml
version: '3.8'
services:
  choerodon-service:
    image: choerodon/java-base:latest
    container_name: choerodon-service
    ports:
      - "8080:8080"
    environment:
      - JAVA_OPTS="-Xms512m -Xmx1024m -XX:+HeapDumpOnOutOfMemoryError"
      - SPRING_PROFILES_ACTIVE="prod"
      - TIME_ZONE="Asia/Shanghai"
    volumes:
      - ./app.jar:/app/app.jar
      - ./logs:/app/logs
    restart: always

4.4 构建自定义镜像

基于该基础镜像构建微服务镜像的Dockerfile示例：

dockerfile
FROM choerodon/java-base:latest

# 复制应用JAR包
COPY target/app.jar /app/app.jar

# 暴露应用端口
EXPOSE 8080

# 启动命令
CMD ["java", "-jar", "/app/app.jar"]

5. 注意事项

• 请根据应用实际资源需求调整JAVA_OPTS参数，避免容器资源分配不足或浪费
• 生产环境建议使用具体版本标签（如choerodon/java-base:11.0.15）而非latest，确保环境一致性
• 如需集成日志收集（如ELK），可通过挂载日志目录或配置日志驱动实现

6. 版本信息

• 基础JDK版本：支持JDK 8、11、17等LTS版本，具体版本通过镜像标签区分（如choerodon/java-base:8、choerodon/java-base:11）
• 镜像更新策略：随JDK安全更新及Choerodon平台版本迭代同步更新