如何在 Docker 中从外部访问 JMX 接口？

---

JMX 及其在 Java 应用程序中的应用

JMX（Java 管理扩展）是一种 Java 技术，它提供了一种管理和监控 Java 应用程序的方法。它公开了一组 API 和 MBean（表示要管理的资源的 Java 对象），这些 API 和 MBean 可用于监控和控制 Java 应用程序的行为。

JMX 通常用于基于 Java 的应用程序中，以监控性能指标（如内存使用情况、CPU 利用率和线程数），以及在运行时管理和配置应用程序。

从 Docker 容器外部访问 JMX

在 Docker 容器中运行 Java 应用程序时，可能需要从主机系统访问应用程序的 JMX 接口。这对于监控应用程序的性能或在运行时配置应用程序很有用。

但是，由于容器化层提供的隔离性，从主机系统访问 Docker 容器中运行的 Java 应用程序的 JMX 接口可能具有挑战性。为了从主机系统访问 JMX 接口，需要配置应用程序和 Docker 容器以将 JMX 接口公开到主机系统。

先决条件

要从主机系统访问 Docker 容器中运行的 Java 应用程序的 JMX 接口，必须满足以下先决条件：

• 必须将 Java 应用程序配置为将其 JMX 接口公开到主机系统。

• 必须使用-p标志运行 Docker 容器，以在主机系统上公开 JMX 端口。

• 主机系统必须安装并配置了一个 JMX 客户端，以连接到 Java 应用程序的 JMX 接口。

配置 Java 应用程序以从 Docker 容器外部访问 JMX

要配置 Java 应用程序以将其 JMX 接口公开到主机系统，可以按照以下步骤操作：

• 将以下 JVM 选项添加到应用程序的启动命令中

-Dcom.sun.management.jmxremote.port=<port> \
-Dcom.sun.management.jmxremote.rmi.port=<port> \
-Dcom.sun.management.jmxremote.authenticate=false \
-Dcom.sun.management.jmxremote.ssl=false \
-Djava.rmi.server.hostname=<hostname>

将<port>替换为所需的 JMX 端口号，将<hostname>替换为 Docker 主机的主机名或 IP 地址。

• 使用修改后的启动命令运行应用程序。

示例

以下是如何在 Dockerfile 中配置 Java 应用程序以访问 JMX 的示例：

FROM openjdk:8-jdk-alpine
COPY . /app
WORKDIR /app
EXPOSE <port>
CMD ["java", "-Dcom.sun.management.jmxremote.port=<port>", "-Dcom.sun.management.jmxremote.rmi.port=<port>", "-Dcom.sun.management.jmxremote.authenticate=false", "-Dcom.sun.management.jmxremote.ssl=false", "-Djava.rmi.server.hostname=<hostname>", "-jar", "app.jar"]

将<port>和<hostname>替换为上面描述的所需值。使用以下命令构建镜像

$ docker build -t myimage .

• 使用 -p 标志运行 Docker 容器，以在主机系统上公开 JMX 端口。

示例

$ docker run -p <port>:<port> myimage 

将<port>替换为 JVM 选项中指定的端口号。

• 在主机系统上，使用 JMX 客户端连接到 Java 应用程序的 JMX 接口。

以下是如何使用jconsole实用程序（包含在 Oracle JDK 中）连接到 Docker 容器中运行的 Java 应用程序的 JMX 接口的示例

• 启动 jconsole，并在“连接”对话框中输入 Docker 主机的主机名或 IP 地址以及 JMX 端口号。

• 单击“连接”。Java 应用程序的 JMX 接口应显示在jconsole窗口中。

在 Docker 容器中使用 JMX 的提示

• 在 Dockerfile 中配置 Java 应用程序以访问 JMX 时，请确保使用 Docker 主机的正确主机名或IP地址。可以使用 HOSTNAME 或 IP 环境变量获取正确的值。

• 如果在 Docker 主机上使用防火墙，请确保打开 JMX 端口以允许来自主机系统的连接。

• 可以通过设置适当的 JVM 选项来启用身份验证和 SSL，以保护 JMX 连接。

示例

-Dcom.sun.management.jmxremote.authenticate=true \
-Dcom.sun.management.jmxremote.ssl=true

结论

在本文中，我们了解了如何从主机系统访问 Docker 容器中运行的 Java 应用程序的 JMX 接口。我们看到，有必要配置应用程序和 Docker 容器以公开 JMX 接口。必须在主机系统上安装并配置 JMX 客户端才能连接到 JMX 接口。

在 Docker 容器中使用 JMX 可用于监控和管理容器化环境中的 Java 应用程序。按照本文中概述的步骤，您可以访问在 Docker 容器中运行的 Java 应用程序的 JMX 接口，并使用它来监控性能、管理配置和解决问题。