openeulertest/bisheng-jdk

BiSheng JDK Docker镜像文档

镜像概述

BiSheng JDK Docker镜像是官方提供的基于https://repo.openeuler.org/%E6%9E%84%E5%BB%BA%E7%9A%84Java%E8%BF%90%E8%A1%8C%E7%8E%AF%E5%A2%83%E9%95%9C%E5%83%8F%EF%BC%8C%E7%94%B1https://gitee.com/openeuler/cloudnative%E7%BB%B4%E6%8A%A4%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E5%8C%85%E5%90%AB%E9%AB%98%E6%80%A7%E8%83%BD%E7%9A%84https://www.openeuler.org/en/other/projects/bishengjdk/%EF%BC%8C%E8%BF%99%E6%98%AF%E4%B8%80%E6%AC%BE%E5%9F%BA%E4%BA%8EOpenJDK%E5%BC%80%E5%8F%91%E7%9A%84%E7%94%9F%E4%BA%A7%E7%BA%A7Java%E5%8F%91%E8%A1%8C%E7%89%88%EF%BC%8C%E5%B7%B2%E5%9C%A8%E5%8D%8E%E4%B8%BA%E5%A4%9A%E6%AC%BE%E4%BA%A7%E5%93%81%E4%B8%AD%E5%BA%94%E7%94%A8%EF%BC%8C%E8%A7%A3%E5%86%B3%E4%BA%86%E6%9C%8D%E5%8A%A1%E8%BF%90%E8%A1%8C%E4%B8%AD%E7%9A%84%E8%AF%B8%E5%A4%9A%E9%97%AE%E9%A2%98%EF%BC%8C%E7%89%B9%E5%88%AB%E5%A2%9E%E5%BC%BA%E4%BA%86ARM%E6%9E%B6%E6%9E%84%E6%94%AF%E6%8C%81%EF%BC%8C%E5%9C%A8%E5%A4%A7%E6%95%B0%E6%8D%AE%E5%9C%BA%E6%99%AF%E4%B8%8B%E8%A1%A8%E7%8E%B0%E5%8D%93%E8%B6%8A%E3%80%82BiSheng JDK兼容Java SE规范，目前支持Linux/aarch64和Linux/x86_64平台。

核心功能和特性

• 架构与场景优化：针对ARM架构和大数据场景进行性能优化，提升运行效率
• 安全补丁更新：每季度更新安全补丁，保障运行环境安全性
• 稳定可靠：经过大规模测试验证，功能稳定，适合生产环境使用

支持的标签及架构

BiSheng JDK Docker镜像的标签由BiSheng JDK版本和基础镜像版本组成，具体如下：

使用方法

在应用中启动Java实例

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

dockerfile
# Dockerfile
FROM openeuler/bisheng-jdk:{Tag}

COPY . /usr/src/myapp
WORKDIR /usr/src/myapp
RUN javac Main.java
CMD ["java", "Main"]

构建并运行Docker镜像：

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

容器测试

使用以下方法验证镜像中安装的Java环境：

bash
docker run -it openeuler/bisheng-jdk:{Tag} java --version

例如，当{Tag}为17.0.10-oe2203sp3时，返回以下信息表示环境正常：

openjdk 17.0.10 2024-01-16
OpenJDK Runtime Environment BiSheng (build 17.0.10+11)
OpenJDK 64-Bit Server VM BiSheng (build 17.0.10+11, mixed mode, sharing)

在Docker容器内编译应用

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

bash
docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp openeuler/bisheng-jdk:{Tag} 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，默认启用该功能。
• Windows Server（非Hyper-V）容器：
  • CPU核心数限制无效（被Host Compute Service忽略），需手动设置CPU亲和性，例如限制为2个核心：

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

  • RAM限制受支持，但JVM无法检测，需通过-XX:MaxRAM=...参数指定不超过容器RAM限制的值。

环境变量带点的问题

部分shell（特别是Alpine Linux中包含的BusyBox /bin/sh）不支持名称带点的环境变量（技术上不符合POSIX标准），会剥离此类变量（Bash会保留）。若应用需要此类环境变量，可直接使用CMD ["java", ...]（不通过shell），或安装并显式使用Bash替代/bin/sh。

问答

如有任何问题或需使用特殊功能，请在https://gitee.com/openeuler/openeuler-docker-images%E6%8F%90%E4%BA%A4issue%E6%88%96pull request。