fabric8/java-alpine-openjdk8-jre

Fabric8 Java基础镜像 OpenJDK 8 (JRE)

该镜像基于Alpine构建，提供OpenJDK 8 (JRE)运行环境。主要包含以下组件：

• https://github.com/fabric8io/agent-bond%E4%BB%A3%E7%90%86%EF%BC%8C%E9%9B%86%E6%88%90Jolokia%E5%92%8CPrometheus https://github.com/prometheus/jmx_exporter%E3%80%82%E4%BB%A3%E7%90%86%E5%AE%89%E8%A3%85%E8%B7%AF%E5%BE%84%E4%B8%BA%60/opt/agent-bond/agent-bond.jar%60%EF%BC%8C%E9%85%8D%E7%BD%AE%E9%80%89%E9%A1%B9%E8%A7%81%E4%B8%8B%E6%96%87%E3%80%82
• 用于启动Java应用的启动脚本/deployments/run-java.sh。

Agent Bond

若需为应用启用Jolokia，应将此镜像作为基础镜像（通过FROM指令），并在启动脚本中使用agent-bond-opts的输出结果，将其包含到Java启动选项中。

例如，可在启动Java应用的脚本中添加以下片段：

bash
# ...
export JAVA_OPTIONS="$JAVA_OPTIONS $(agent-bond-opts)"
# .... 启动应用时使用JAVA_OPTIONS，如Tomcat的启动方式

默认使用以下版本及配置：

• Jolokia：版本1.6.2，端口8778
• https://github.com/prometheus/jmx_exporter%EF%BC%9A%E7%89%88%E6%9C%AC**0.3.1**%EF%BC%8C%E7%AB%AF%E5%8F%A3**9779**

可通过设置环境变量调整agent-bond-opts的行为：

Agent-Bond选项

可通过以下环境变量配置Agent Bond：

• AB_OFF：若设置，禁用Agent Bond（输出空值）。默认启用。
• AB_ENABLED：启用的子代理列表，以逗号分隔。允许值为jolokia和jmx_exporter。默认两者均启用。

Jolokia配置

• AB_JOLOKIA_CONFIG：若设置，使用指定文件（含路径）作为Jolokia JVM代理属性（详见Jolokia 参考手册）。默认值为/opt/jolokia/jolokia.properties。
• AB_JOLOKIA_HOST：绑定的主机地址（默认：0.0.0.0）
• AB_JOLOKIA_PORT：使用的端口（默认：8778）
• AB_JOLOKIA_USER：认证用户名。默认关闭认证。
• AB_JOLOKIA_HTTPS：启用HTTPS安全通信。若AB_JOLOKIA_OPTS中未配置serverCert，默认生成自签名服务器证书。
• AB_JOLOKIA_PASSWORD：认证密码。默认关闭认证。
• AB_JOLOKIA_ID：使用的代理ID（默认：$HOSTNAME，即容器ID）
• AB_JOLOKIA_OPTS：附加选项，格式为"key=value,key=value,..."

特定环境集成选项：

• AB_JOLOKIA_AUTH_OPENSHIFT：启用OpenShift TLS通信的客户端认证。值可为客户端证书中必须包含的相对可分辨名称。启用此参数会自动将Jolokia切换到HTTPS模式，默认CA证书路径为/var/run/secrets/kubernetes.io/serviceaccount/ca.crt。

jmx_exporter配置

• AB_JMX_EXPORTER_OPTS：jmx_exporter的配置，格式为<port>:<配置文件路径>
• AB_JMX_EXPORTER_PORT：JMX Exporter使用的端口。默认：9779
• AB_JMX_EXPORTER_CONFIG：jmx_exporter的配置文件路径。默认：/opt/agent-bond/jmx_exporter_config.json

启动脚本 run-java.sh

该镜像的默认命令为https://github.com/fabric8io/run-java-sh%E3%80%82%E5%85%B6%E7%94%A8%E9%80%94%E6%98%AF%E5%90%AF%E5%8A%A8Java%E5%BA%94%E7%94%A8%EF%BC%8C%E6%94%AF%E6%8C%81%E4%BB%A5fat-jars%EF%BC%88%E5%8C%85%E5%90%AB%E6%89%80%E6%9C%89%E4%BE%9D%E8%B5%96%EF%BC%89%E6%88%96%E4%B8%BB%E7%B1%BB%EF%BC%88%E4%BB%8E%E7%9B%AE%E5%BD%95%E4%B8%AD%E7%9A%84%E6%89%80%E6%9C%89jar%E6%9E%84%E5%BB%BA%E7%B1%BB%E8%B7%AF%E5%BE%84%EF%BC%89%E6%96%B9%E5%BC%8F%E8%BF%90%E8%A1%8C%E3%80%82

对于这些镜像，变量JAVA_APP_DIR的默认值为/deployments。

run-java.sh

此通用启动脚本针对容器内运行Java应用优化，调用方式如下：

bash
./run-java.sh <子命令> <选项>

run-java.sh支持两个子命令：

• options：输出JVM选项，可用于自定义Java应用启动（如Maven或Tomcat）。会考虑容器约束并包含脚本使用的所有配置逻辑。
• run：启动Java应用（如下所述）。这也是默认命令，可省略。

运行Java应用

当未指定子命令（或使用默认子命令run）时，脚本默认启动Java应用。

启动过程主要通过环境变量配置：

• JAVA_APP_DIR：应用所在目录。应用中的所有路径均相对于此目录。默认与启动脚本所在目录相同。
• JAVA_LIB_DIR：存放Java jar文件及可选classpath文件的目录。classpath文件可为单行冒号分隔的类路径，或每行列出一个jar文件。若未设置，JAVA_LIB_DIR与JAVA_APP_DIR相同。
• JAVA_OPTIONS：调用java时添加的选项。
• JAVA_MAJOR_VERSION：版本号≥7。若设置，仅使用适合该版本的选项。设为7时会移除Java 8以上特有的选项；≥10时不计算显式内存限制（Java 10+支持容器限制）。若省略，通过JAVA_VERSION变量、release文件或解析java -version输出猜测。
• JAVA_MAX_MEM_RATIO：当JAVA_OPTIONS中未指定-Xmx时使用。基于容器内存限制计算默认最大堆内存。若容器无内存限制则无效；若有内存限制，-Xmx设为容器可用内存的指定比例。默认值：容器可用内存<300M时为25，否则为50（即使用50%可用内存）。设为0可禁用此机制。
• JAVA_INIT_MEM_RATIO：当JAVA_OPTIONS中未指定-Xms时使用。基于容器内存限制计算默认初始堆内存。若容器无内存限制则无效。默认未设置。
• JAVA_MAX_CORE：手动限制可用核心数，用于计算GC线程数等默认值。设为0时不基于核心数进行JVM调优。
• JAVA_DIAGNOSTICS：设置后输出诊断信息到标准输出。
• JAVA_MAIN_CLASS：作为java参数的主类。设置此变量时，$JAVA_APP_DIR中的所有jar及$JAVA_LIB_DIR均添加到类路径。
• JAVA_APP_JAR：带合适清单的jar文件，可通过java -jar启动（若未设置$JAVA_MAIN_CLASS）。无论如何，此jar均添加到类路径。
• JAVA_APP_NAME：进程名称。
• JAVA_CLASSPATH：使用的类路径。若未设置，脚本检查${JAVA_APP_DIR}/classpath文件，其内容直接作为类路径；若文件不存在，添加classes:${JAVA_APP_DIR}/*（即目录中所有jar）。
• JAVA_DEBUG：设置后启用远程调试。
• JAVA_DEBUG_SUSPEND：设置后启用远程调试的挂起模式。
• JAVA_DEBUG_PORT：远程调试端口。默认：5005。
• HTTP_PROXY：代理服务器URL，转换为http.proxyHost和http.proxyPort系统属性。
• HTTPS_PROXY：代理服务器URL，转换为https.proxyHost和https.proxyPort系统属性。
• no_proxy/NO_PROXY：直接访问的主机列表，转换为http.nonProxyHosts系统属性。

若未设置$JAVA_APP_JAR和$JAVA_MAIN_CLASS，脚本检查$JAVA_APP_DIR中的单个JAR文件作为$JAVA_APP_JAR；若未找到或找到多个，抛出错误。

类路径构建规则：

• 若设置$JAVA_CLASSPATH，直接使用。
• 首先添加当前目录（"."）。
• 若当前目录与$JAVA_APP_DIR不同，添加$JAVA_APP_DIR。
• 若设置$JAVA_MAIN_CLASS：
  • 若设置$JAVA_APP_JAR，添加该jar。
  • 若$JAVA_APP_DIR/classpath文件存在，其内容追加到类路径（可为单行冒号分隔或多行，每行是相对于$JAVA_LIB_DIR的jar路径）。
  • 若文件不存在，添加${JAVA_APP_DIR}/*（按字母顺序添加目录中所有jar）。

这些变量也可在run-env.sh shell配置文件中设置，启动脚本会加载该文件。该文件可位于启动脚本目录或${JAVA_APP_DIR}，后者中的环境变量覆盖前者。

脚本还会检查run-java-options命令，若存在，其输出添加到$JAVA_OPTIONS。

脚本暴露描述容器限制的环境变量，供应用使用：

• CONTAINER_CORE_LIMIT：计算的核心限制，详见[***]
• CONTAINER_MAX_MEMORY：容器的内存限制

脚本的所有参数直接传递给Java应用。

示例：

bash
# 直接设置应用目录
export JAVA_APP_DIR=/deployments
# 基于容器约束设置-Xmx
export JAVA_MAX_MEM_RATIO=40
# 启动JAVA_APP_DIR中的jar并传递参数
./run-java.sh --user maxmorlock --password secret

选项

该脚本还可用于计算通用的Java应用启动最佳实践选项。例如，在容器中运行Maven时，应考虑容器内存约束。

子命令options可输出选项到标准输出，便于供其他Java应用使用。

未指定额外参数时，使用默认值（可通过上述环境变量调整）。

可通过额外参数选择特定选项集：

• --debug：若JAVA_DEBUG设置，输出Java调试选项
• --memory：基于环境变量的内存设置
• --proxy：解析代理环境变量
• --cpu：核心数受限时的调优
• --gc：GC调优参数
• --jit：JIT选项
• --diagnostics：若JAVA_DIAGNOSTICS设置，输出诊断选项
• --java-default：等同于--memory --jit --diagnostic --cpu --gc

示例：

bash
# 在容器中运行Maven时使用适当的内存设置
export MAVEN_OPTS="$(run-java.sh options --memory)"
mvn clean install

版本信息

• 基础镜像：Alpine 3.11
• Java：OpenJDK 8 1.8.0（Java Runtime Environment (JRE)）
• Agent-Bond：1.2.0（Jolokia 1.6.2，jmx_exporter 0.3.1）