shorck/openjre

shorck/openjre:17 镜像文档

镜像概述

shorck/openjre:17 是一个基于OpenJRE 17的Java应用运行基础镜像，旨在简化Java应用的部署流程。该镜像通过环境变量提供灵活的配置能力，支持自定义JVM代理、JVM参数及应用命令参数，适用于各类Java应用的容器化部署。

核心功能与特性

• 基于OpenJRE 17：提供稳定的Java 17运行环境，满足现代Java应用的运行需求
• 环境变量配置：支持通过环境变量灵活配置：
  • JVM_AGENT：指定JVM代理（如监控、调试工具）
  • JVM_ARGS：自定义JVM参数（如内存配置、GC策略等）
  • COMMAND_ARGS：传递给Java应用的命令行参数
• 标准化部署路径：应用jar包统一放置于/deployment/app.jar，简化部署配置

使用场景

• 快速部署独立Java应用（如Spring Boot应用）
• 需要自定义JVM参数的Java服务部署
• 集成JVM代理工具（如APM监控、性能分析工具）的场景
• 微服务架构中的Java服务容器化部署

使用方法

构建应用镜像

创建Dockerfile，基于shorck/openjre:17构建应用镜像：

dockerfile
FROM shorck/openjre:17

# 将本地应用jar包复制到镜像的标准部署路径
COPY ./app.jar /deployment/app.jar

构建镜像命令

在Dockerfile所在目录执行：

bash
docker build -t my-java-app .

运行容器

基础运行

bash
docker run -d --name my-app my-java-app

自定义JVM参数

bash
docker run -d \
  -e JVM_ARGS="-Xmx512m -Xms256m -XX:+UseG1GC" \
  --name my-app \
  my-java-app

添加JVM代理

bash
docker run -d \
  -e JVM_AGENT="-javaagent:/path/to/agent.jar" \
  -v /local/agent.jar:/path/to/agent.jar \
  --name my-app \
  my-java-app

传递应用命令参数

bash
docker run -d \
  -e COMMAND_ARGS="--spring.profiles.active=prod --server.port=8080" \
  --name my-app \
  my-java-app

环境变量说明

完整启动命令解析

容器启动时执行的核心命令为：

bash
java -jar ${JVM_AGENT} ${JVM_ARGS} /deployment/app.jar ${COMMAND_ARGS}

各参数按以下顺序组合执行：

1. JVM_AGENT（若配置）
2. JVM_ARGS（若配置）
3. 固定路径的应用jar包 /deployment/app.jar
4. COMMAND_ARGS（若配置）