clefos/java

OpenJDK 镜像文档

已弃用 - 请参阅 https://hub.docker.com/r/clefos/openjdk

什么是 OpenJDK？

OpenJDK（Open Java Development Kit）是Java平台标准版（Java SE）的免费开源实现。自版本7起，OpenJDK成为Java SE的官方参考实现。

***.org/wiki/OpenJDK

Java是Oracle及其关联公司的注册商标。

!https://raw.githubusercontent.com/docker-library/docs/a3439b66b7980d1811f6b3835a3c541747172970/openjdk/logo.png

如何使用此镜像

在应用中启动Java实例

使用此镜像最直接的方式是将Java容器同时用作构建和运行时环境。在Dockerfile中，可按以下方式编写以编译和运行项目：

dockerfile
FROM openjdk:7
COPY . /usr/src/myapp
WORKDIR /usr/src/myapp
RUN javac Main.java
CMD ["java", "Main"]

然后可以构建并运行Docker镜像：

console
$ docker build -t my-java-app .
$ docker run -it --rm --name my-running-app my-java-app

在Docker容器内编译应用

有时可能不适合在容器内运行应用。要在Docker实例内编译而非运行应用，可使用以下命令：

console
$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp openjdk:7 javac Main.java

此命令会将当前目录作为卷挂载到容器，将工作目录设置为该卷，并运行javac Main.java命令，该命令会让Java编译Main.java中的代码，并将Java类文件输出到Main.class。

使JVM尊重CPU和RAM限制

JVM启动时会尝试检测可用CPU核心数和RAM量，以相应调整其内部参数（如生成的垃圾回收线程数）。当容器以有限的CPU/RAM运行时，JVM用于探测的标准系统API会返回主机范围的值。这可能导致旧版本JVM出现过高CPU使用率和内存分配错误。

在Linux容器中，OpenJDK 8的最新版本默认可正确检测容器限制的CPU核心数。要启用对容器限制RAM量的检测，可使用以下选项：

console
$ java -XX:+UnlockExperimentalVMOptions -XX:+UseCGroupMemoryLimitForHeap ...

在Windows Server（非Hyper-V）容器中，可用CPU核心数限制不生效（被主机计算服务忽略）。要手动设置此限制，可按以下方式启动JVM：

console
$ start /b /wait /affinity 0x3 path/to/java.exe ...

在此示例中，CPU亲和性十六进制掩码0x3会将JVM限制为2个CPU核心。

Windows Server容器支持RAM限制，但当前JVM无法检测。为防止过度内存分配，必须指定-XX:MaxRAM=...选项，其值不得大于容器的RAM限制。

镜像变体

openjdk镜像有多种版本，每种版本针对特定用例设计。

openjdk:<version>

这是默认镜像。如果不确定需求，可能需要使用此版本。它设计为既可作为临时容器（挂载源代码并启动容器以运行应用），也可作为构建其他镜像的基础。

许可证

查看此镜像中包含的软件的许可证信息。