clefos/openjdk

OpenJDK 镜像文档

镜像概述和主要用途

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

***：OpenJDK

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

核心功能和特性

• 免费开源：基于GPLv2+CE许可证，可自由使用和分发
• 官方标准：Java SE官方参考实现，确保与Java标准兼容
• 跨平台支持：可在多种操作系统环境中运行
• 灵活部署：支持作为构建环境和运行时环境使用

使用场景和适用范围

• Java应用开发：作为开发环境编译和测试Java程序
• 应用部署：作为生产环境运行Java应用
• 资源受限环境：通过slim变体在资源有限的场景中使用
• 容器化部署：适合Docker容器化环境，支持CPU和内存资源限制

详细使用方法和配置说明

在应用中启动Java实例

最直接的使用方式是将Java容器同时作为构建和运行环境。在Dockerfile中编写如下内容可编译并运行项目：

dockerfile
FROM docker.xuanyuan.run/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容器内编译应用

有时可能不需要在容器内运行应用，仅需编译。可使用以下命令：

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

该命令将当前目录挂载为容器卷，设置工作目录为该卷，并执行javac Main.java命令，编译Main.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限制：Windows Host Compute Service会忽略CPU核心数限制，需手动设置CPU亲和性：

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

  示例中十六进制掩码0x3限制JVM使用2个CPU核心。

• RAM限制：Windows Server容器支持RAM限制，但JVM无法自动检测。需使用-XX:MaxRAM=...参数，其值不应超过容器RAM限制。

镜像变体

openjdk镜像提供多种变体，适用于不同场景：

openjdk:<version>

默认镜像。如不确定需求，建议使用此版本。设计用于临时容器（挂载源代码启动应用）及作为构建其他镜像的基础。

openjdk:slim

安装OpenJDK的-headless包，缺少默认版本中的许多UI相关Java库和常见包，仅包含运行Java所需的最小依赖。除非在仅部署openjdk镜像且有空间限制的环境中，否则建议使用默认镜像。

许可证

查看镜像中包含软件的http://openjdk.java.net/legal/gplv2+ce.html。