AdoptOpenJDK OpenJ9 Docker镜像文档（版本11）

1. 镜像概述与主要用途

1.1 镜像简介

本仓库镜像包含由AdoptOpenJDK构建的、集成Eclipse OpenJ9虚拟机的OpenJDK 11二进制文件。AdoptOpenJDK提供两类Docker镜像：

• DockerHub官方镜像：由DockerHub维护，基于Ubuntu和Windows，仅在OS修复可用时更新，详情见DockerHub官方仓库。
• AdoptOpenJDK维护镜像（本仓库）：每日重建，支持更多操作系统基础镜像，包含精简版（Slim）及多架构适配。

两类镜像使用相同的AdoptOpenJDK Java二进制文件，核心差异在于操作系统支持范围。

1.2 主要用途

• 为Java 11应用提供轻量级、高性能的容器化运行环境。
• 满足不同Linux发行版（如Alpine、CentOS、Debian等）的部署需求。
• 支持生产环境中对JVM性能、内存效率有要求的场景（基于OpenJ9的优化特性）。

2. 核心功能与特性

2.1 核心优势

• 高性能JVM：集成Eclipse OpenJ9虚拟机，具备低内存占用、快速启动、高扩展性等特性，适用于企业级Java应用。
• 多操作系统支持：基于Alpine、CentOS、ClefOS、Debian、Debian-Slim、UBI、UBI-Minimal等多种Linux发行版构建。
• 灵活版本选择：提供JDK（完整开发工具）和JRE（运行时环境）两种形态，同时提供精简版（Slim）镜像以减小体积。
• 多架构适配：支持amd64、ppc64le、s390x架构，同一命令可在不同架构环境中运行。
• 持续更新：每日重建（Nightly Builds）确保基础镜像和依赖组件的安全性。

3. 支持的操作系统与架构

3.1 操作系统

本仓库镜像支持以下基础操作系统（OS）：

• Alpine
• CentOS
• ClefOS
• Debian
• Debian-Slim
• openSUSE Leap
• openSUSE Tumbleweed
• Red Hat UBI（Universal Base Image）
• Red Hat UBI-Minimal

3.2 支持架构

• amd64（x86_64）
• ppc64le（PowerPC 64位小端）
• s390x（IBM System z）

4. 支持的标签与版本

4.1 Release Builds（稳定版）

按操作系统分组，主要标签格式为[OS]-[jdk|jre|slim]，示例如下（完整标签及Dockerfile见对应链接）：

Alpine

• alpine：JDK完整版，示例标签jdk-11.0.11_9_openj9-0.26.0-alpine，Dockerfile见链接。
• alpine-slim：JDK精简版，示例标签jdk-11.0.11_9_openj9-0.26.0-alpine-slim，Dockerfile见链接。
• alpine-jre：JRE完整版，示例标签jre-11.0.11_9_openj9-0.26.0-alpine，Dockerfile见链接。

CentOS

• centos：JDK完整版，示例标签jdk-11.0.11_9_openj9-0.26.0-centos，Dockerfile见链接。
• centos-slim：JDK精简版，示例标签jdk-11.0.11_9_openj9-0.26.0-centos-slim，Dockerfile见链接。
• centos-jre：JRE完整版，示例标签jre-11.0.11_9_openj9-0.26.0-centos，Dockerfile见链接。

其他操作系统

• Debian/Debian-Slim：标签格式如debian、debian-slim、debian-jre，Dockerfile见Debian JDK完整版。
• UBI/UBI-Minimal：标签格式如ubi、ubi-slim、ubi-jre、ubi-minimal-jre，Dockerfile见UBI JDK完整版。
• 默认标签：latest（基于Ubuntu的JDK完整版）、slim（基于Ubuntu的JDK精简版）、jre（基于Ubuntu的JRE完整版）。

4.2 Nightly Builds（每日构建版）

每日更新的开发版，标签格式在稳定版基础上添加-nightly后缀，例如：

• alpine-nightly（Alpine JDK每日构建版）
• centos-nightly-slim（CentOS JDK精简版每日构建版）
• nightly（默认Ubuntu JDK每日构建版）

完整标签及Dockerfile见GitHub仓库。

5. 使用场景与适用范围

5.1 适用场景

• 生产环境部署：需高性能、低内存占用JVM的Java应用（如微服务、企业级后端）。
• 多架构适配：需在ppc64le/s390x等非x86架构服务器部署的场景。
• 特定OS需求：依赖Alpine（极小体积）、CentOS（企业级稳定性）、UBI（Red Hat生态）等OS的环境。
• 镜像精简需求：通过slim标签减少镜像体积，优化容器启动速度。
• 开发测试：通过nightly标签验证最新JVM特性或修复。

6. 使用方法与配置说明

6.1 基本使用

拉取镜像

# 拉取最新稳定版JDK（基于Ubuntu）
docker pull adoptopenjdk/openjdk11-openj9:latest

# 拉取Alpine JRE精简版
docker pull adoptopenjdk/openjdk11-openj9:alpine-jre

验证JVM版本

docker run --rm adoptopenjdk/openjdk11-openj9:latest java -version

输出示例：

openjdk version "11.0.11" 2021-04-20
OpenJDK Runtime Environment AdoptOpenJDK (build 11.0.11+9)
Eclipse OpenJ9 VM AdoptOpenJDK (build openj9-0.26.0, JRE 11 Linux amd64-64-Bit Compressed References 20210421_932 (JIT enabled, AOT enabled)
OpenJ9   - 0394ef754
OMR      - 582366ae5
JCL      - 3b09cfd7e9 based on jdk-11.0.11+9)

6.2 构建自定义镜像

通过Dockerfile将Java应用打包为镜像：

# 使用Alpine JRE精简版作为基础镜像
FROM adoptopenjdk/openjdk11-openj9:alpine-jre

# 创建应用目录
RUN mkdir -p /opt/app

# 复制应用JAR包
COPY your-app.jar /opt/app/

# 启动命令
CMD ["java", "-jar", "/opt/app/your-app.jar"]

构建并运行：

docker build -t your-app:v1 .
docker run -d -p 8080:8080 --name your-app-container your-app:v1

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

OpenJ9提供类数据共享（CDS）功能，可通过共享类缓存提升JVM启动速度并减少内存占用。需将缓存目录挂载到容器外部（主机目录或数据卷）。

方法1：挂载主机目录

# 构建镜像（含CDS配置）
docker build -t app-with-cds - <<EOF
FROM adoptopenjdk/openjdk11-openj9:latest
RUN mkdir /opt/shareclasses /opt/app
COPY your-app.jar /opt/app/
CMD ["java", "-Xshareclasses:cacheDir=/opt/shareclasses", "-jar", "/opt/app/your-app.jar"]
EOF

# 运行容器，挂载主机缓存目录
docker run -d -v /host/path/to/shareclasses:/opt/shareclasses --name app-cds app-with-cds

方法2：使用数据卷容器

# 创建数据卷容器（持久化缓存目录）
docker create -v /opt/shareclasses --name cds-cache adoptopenjdk/openjdk11-openj9:latest /bin/true

# 运行应用容器，共享缓存卷
docker run -d --volumes-from cds-cache --name app-cds app-with-cds

7. 部署示例

7.1 docker-compose配置示例

version: '3'
services:
  java-app:
    image: adoptopenjdk/openjdk11-openj9:alpine-jre
    container_name: java-app
    volumes:
      - ./app:/opt/app          # 挂载应用目录
      - cds-cache:/opt/shareclasses  # 共享CDS缓存
    command: ["java", "-Xshareclasses:cacheDir=/opt/shareclasses", "-jar", "/opt/app/your-app.jar"]
    ports:
      - "8080:8080"
    restart: unless-stopped

volumes:
  cds-cache:  # 定义CDS缓存数据卷

8. 许可证信息

8.1 镜像脚本许可证

Dockerfile及相关构建脚本采用Apache License 2.0授权。

8.2 软件组件许可证

• OpenJDK + Eclipse OpenJ9：采用GNU GPL v2 with Classpath Exception授权。

8.3 注意事项

镜像中可能包含基础OS及依赖组件（如Bash等），其许可证需遵循各自分发方要求。用户应确保使用本镜像符合所有组件的许可证条款。

9. 支持与反馈

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