fabric8/java-jboss-openjdk8-jdk

Fabric8 Java 基础镜像 OpenJDK 8 (JDK)

此镜像已弃用且不再维护。请选择其他版本（alpine、centos）。

该镜像基于JBoss，提供OpenJDK 8 (JDK)环境。包含以下组件：

• https://github.com/fabric8io/agent-bond%E4%BB%A3%E7%90%86%EF%BC%8C%E9%9B%86%E6%88%90Jolokia%E5%92%8CPrometheus%E7%9A%84https://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%E3%80%82%E9%85%8D%E7%BD%AE%E9%80%89%E9%A1%B9%E8%AF%A6%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（输出空值）。默认启用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%81fat-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%E5%9F%BA%E4%BA%8E%E4%B8%BB%E7%B1%BB%E7%9A%84%E4%BC%A0%E7%BB%9F%E5%BA%94%E7%94%A8%EF%BC%88%E7%B1%BB%E8%B7%AF%E5%BE%84%E7%94%B1%E7%9B%AE%E5%BD%95%E4%B8%AD%E7%9A%84%E6%89%80%E6%9C%89jar%E6%9E%84%E5%BB%BA%EF%BC%89%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文件（包含类路径，可为单行冒号分隔或每行一个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：手动限制可用核心数，用于计算垃圾收集线程数等默认值。设为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）。

这些变量也可在shell配置文件run-env.sh中设置，启动脚本会加载该文件。该文件可位于启动脚本目录或${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

版本信息

• 基础镜像：JBoss with OpenJDK undefined
• Java：OpenJDK 8 1.8.0（Java Development Kit (JDK)）
• Agent-Bond：1.2.0（Jolokia 1.6.2，jmx_exporter 0.3.1）