AdoptOpenJDK OpenJ9 Docker 镜像文档

1. 镜像概述和主要用途

AdoptOpenJDK OpenJ9 Docker 镜像包含基于 Eclipse OpenJ9 JVM 的 OpenJDK 8 二进制文件，由 AdoptOpenJDK 维护。该镜像旨在为 Java 应用提供高性能、低内存占用的运行环境，支持多种操作系统和硬件架构。

与非镜像区别

AdoptOpenJDK 提供两类 Docker 镜像：

• **Docker Hub *镜像：维护于 Docker Hub，基于 Ubuntu 和 Windows 系统，随操作系统更新同步升级。
• AdoptOpenJDK 维护镜像（本仓库）：每日重建，支持更多操作系统（Alpine、CentOS、ClefOS、Debian、Debian-Slim、UBI、UBI-Minimal 等）及各系统的精简版（Slim）镜像。

2. 核心功能和特性

核心优势

• 基于 Eclipse OpenJ9 JVM：高性能、可扩展，具备低内存占用和快速启动特性，适合生产环境。
• 多架构支持：兼容 amd64、ppc64le、s390x 架构，同一命令可在不同架构下运行。
• 丰富的操作系统支持：覆盖 Alpine、CentOS、Debian、UBI 等主流 Linux 发行版，满足多样化部署需求。
• 灵活的镜像类型：提供 JDK（完整开发工具）、JRE（运行时环境）及精简版（Slim）镜像，平衡功能与体积。
• 持续更新：每日重建确保底层操作系统和依赖组件的安全性与最新性。

3. 使用场景和适用范围

适用场景

• 开发环境：快速搭建标准化 Java 8 开发/测试环境，支持多架构和操作系统验证。
• 生产环境：运行对性能、内存占用敏感的 Java 应用（如微服务、企业级应用）。
• 跨平台部署：需在 amd64、ppc64le、s390x 等架构下统一部署的场景。
• 资源受限环境：通过 Slim 版或 JRE 镜像减少容器体积和资源消耗。

4. 支持的标签

4.1 发布版本（Release Builds）

按操作系统分组，包含 JDK 完整版、JDK 精简版（Slim）、JRE 完整版，以下为典型标签示例（完整标签及 Dockerfile 可参考 GitHub 仓库）：

Alpine

• JDK 完整版：alpine、jdk8u292-b10_openj9-0.26.0-alpine（Dockerfile）
• JDK 精简版：alpine-slim、jdk8u292-b10_openj9-0.26.0-alpine-slim（Dockerfile）
• JRE 完整版：alpine-jre、jre8u292-b10_openj9-0.26.0-alpine（Dockerfile）

CentOS

• JDK 完整版：centos、jdk8u292-b10_openj9-0.26.0-centos（Dockerfile）
• JDK 精简版：centos-slim、jdk8u292-b10_openj9-0.26.0-centos-slim（Dockerfile）
• JRE 完整版：centos-jre、jre8u292-b10_openj9-0.26.0-centos（Dockerfile）

Debian/Debian-Slim

• JDK 完整版：debian、jdk8u292-b10_openj9-0.26.0-debian（Dockerfile）
• JDK 精简版：debian-slim、jdk8u292-b10_openj9-0.26.0-debian-slim（Dockerfile）
• JRE 完整版：debian-jre、jre8u292-b10_openj9-0.26.0-debian（Dockerfile）

UBI/UBI-Minimal

• JDK 完整版：ubi、jdk8u292-b10_openj9-0.26.0-ubi（Dockerfile）
• JDK 精简版：ubi-slim、jdk8u292-b10_openj9-0.26.0-ubi-slim（Dockerfile）
• JRE 完整版：ubi-jre、jre8u292-b10_openj9-0.26.0-ubi（Dockerfile）

其他系统

支持 ClefOS、Leap、Tumbleweed 等，标签格式类似（如 clefos、leap-jre、tumbleweed-nightly），详细可参考 GitHub 仓库。

4.2 Nightly 版本

每日构建的开发版镜像，标签格式为 <os>-nightly（如 alpine-nightly、debian-jre-nightly），适合测试最新功能，生产环境慎用。

5. 使用方法和配置说明

5.1 基本使用

验证 Java 版本

bash
docker run --rm adoptopenjdk/openjdk8-openj9:latest java -version

运行 JAR 应用

bash
# 挂载本地 JAR 文件并运行
docker run --rm -v /path/to/local/app:/opt/app adoptopenjdk/openjdk8-openj9:jre java -jar /opt/app/japp.jar

构建自定义镜像

创建 Dockerfile：

dockerfile
FROM adoptopenjdk/openjdk8-openj9:ubi  # 使用 UBI 基础镜像
RUN mkdir /opt/app
COPY japp.jar /opt/app
CMD ["java", "-jar", "/opt/app/japp.jar"]

构建并运行：

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

5.2 类数据共享（Class Data Sharing）配置

OpenJ9 的类数据共享功能可减少多 JVM 实例的内存占用并加速启动，需通过共享目录实现容器间缓存共享。

通过主机目录共享缓存

1. 创建 Dockerfile：

dockerfile
FROM adoptopenjdk/openjdk8-openj9:latest
RUN mkdir /opt/shareclasses /opt/app
COPY japp.jar /opt/app
# 启用类共享，指定缓存目录
CMD ["java", "-Xshareclasses:cacheDir=/opt/shareclasses", "-jar", "/opt/app/japp.jar"]

2. 构建并运行（挂载主机目录到容器缓存路径）：

bash
docker build -t japp .
docker run -it -v /host/path/to/shareclasses:/opt/shareclasses japp

通过数据卷容器共享缓存

1. 创建数据卷容器：

bash
docker create -v /opt/shareclasses --name classcache japp /bin/true

2. 从数据卷容器挂载缓存目录运行应用：

bash
docker run -it --volumes-from classcache japp

6. 部署示例

6.1 Docker Compose 配置（多容器共享类缓存）

yaml
version: '3'
services:
  app1:
    build: .
    volumes_from:
      - classcache
  app2:
    build: .
    volumes_from:
      - classcache
  classcache:
    image: japp
    volumes:
      - /opt/shareclasses
    command: /bin/true

7. 快速参考

支持渠道

• 帮助：Eclipse OpenJ9 Slack、Eclipse 邮件列表
• 问题反馈：GitHub Issues

支持架构

amd64、ppc64le、s390x

8. 许可证

• Dockerfiles 及脚本：Apache License 2.0
• OpenJDK + Eclipse OpenJ9：GNU GPL v2 with Classpath Exception

镜像中包含的其他软件（如基础系统组件、Bash 等）可能受其他许可证约束，用户需自行确保合规使用。