eurobankgr/openjdk

OpenJDK Java fat-jar应用基础镜像

镜像概述和主要用途

该镜像基于OpenJDK官方镜像构建，专为运行Java fat-jar应用程序设计。通过优化JVM配置、支持非root用户运行及集成必要系统工具，为Java应用提供稳定、高效的运行环境，适用于各类Java独立应用及微服务部署场景。

核心功能和特性

• 基于官方OpenJDK镜像：使用Docker官方OpenJDK镜像作为基础（详见：https://hub.docker.com/_/openjdk%EF%BC%89
• 非root运行支持：将/tmp设置为用户工作目录，支持以非root用户身份运行容器（详见：Running Docker containers as non root）
• JVM启动调试：启动时显示JVM设置，便于调试和问题排查
• OOM错误处理：设置JVM标志，确保发生OutOfMemory错误时容器自动退出
• 内存控制优化：采用Java 10内存控制选项（详见：Docker and the JVM），初始内存设为容器可用RAM的50%，最大内存设为70%
• 配置灵活性：支持通过JAVA_OPTIONS环境变量覆盖默认JVM选项
• 系统工具集成：包含lsof、net-tools、iputils-ping、telnet等常用系统工具，便于容器内问题诊断

使用场景和适用范围

• 运行Java fat-jar格式的独立应用程序
• 部署Java微服务应用
• 需要非root权限运行的安全敏感场景
• 对JVM内存使用有优化需求的容器化环境
• 开发、测试及生产环境的Java应用部署

使用方法和配置说明

基本使用

Docker Run示例

bash
docker run -d \
  --name java-app \
  -e JAVA_OPTIONS="-Xms256m -Xmx512m" \  # 可选：覆盖默认JVM选项
  -v /path/to/your/app.jar:/tmp/app.jar \  # 挂载fat-jar到容器/tmp目录
  your-image-name \
  java -jar app.jar  # 执行jar包

环境变量配置

自定义JVM选项示例

如需调整内存配置或添加其他JVM参数，可通过JAVA_OPTIONS环境变量实现：

bash
docker run -d \
  --name java-app \
  -e JAVA_OPTIONS="-Xms1g -Xmx2g -XX:+PrintGCDetails" \  # 自定义内存和GC日志
  -v /path/to/your/app.jar:/tmp/app.jar \
  your-image-name \
  java -jar app.jar

非root运行说明

镜像默认配置支持非root运行，可通过--user参数指定非root用户ID：

bash
docker run -d \
  --name java-app \
  --user 1001 \  # 指定非root用户ID
  -v /path/to/your/app.jar:/tmp/app.jar \
  your-image-name \
  java -jar app.jar