amd64/ibmjava

IBM Java 镜像文档

1. 镜像概述

amd64/ibmjava 镜像是官方 IBM® SDK, Java™ Technology Edition 的 Docker 镜像，专为 amd64 架构构建。该镜像提供了 IBM Java 运行时和开发工具，可作为 Java 应用程序开发、测试和生产部署的基础环境。镜像基于 Ubuntu 系统，支持多种部署场景，并提供针对资源优化的变体版本。

2. 核心功能与特性

2.1 三种镜像类型

• SDK（软件开发工具包）：包含完整的 Java 开发工具（如 javac、jdb），适用于开发和编译阶段，标签为 8-sdk、sdk。
• JRE（Java 运行时环境）：仅包含运行 Java 应用所需的核心组件，适用于生产环境，标签为 8-jre、jre、8、latest。
• SFJ（Small Footprint JRE）：精简版 JRE，移除云环境中非必要工具（如 Java 控制面板），显著减少磁盘和内存占用，适用于资源受限场景，标签为 8-sfj、sfj。

2.2 多架构支持

镜像支持跨硬件架构部署，包括：

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

多架构支持通过自动匹配底层硬件实现，无需手动指定架构前缀。

2.3 Class Data Sharing（CDS）特性

IBM SDK 提供 CDS 机制，通过在多个 JVM 间共享预加载类数据，减少内存占用并加快 JVM 启动速度。可通过 -Xshareclasses JVM 参数启用。

2.4 Alpine Linux 选项（非官方支持）

提供基于 Alpine Linux 的镜像变体（需额外安装 glibc 依赖），相比 Ubuntu 基础镜像体积更小。例如 JRE 8.0-3.10 版本中，Alpine 镜像体积约 184 MB（Ubuntu 为 305 MB），但 Alpine Linux 非 IBM Java 官方支持的操作系统。

3. 支持的标签与架构

3.1 支持的标签及 Dockerfile 链接

3.2 支持的架构

• amd64：https://hub.docker.com/r/amd64/ibmjava/
• ppc64le：https://hub.docker.com/r/ppc64le/ibmjava/
• s390x：https://hub.docker.com/r/s390x/ibmjava/

4. 使用场景

• 开发环境：通过 sdk 标签利用完整工具链进行 Java 应用开发、编译和调试。
• 生产环境：使用 jre 或 sfj 标签部署应用，减少资源占用；对内存/磁盘敏感的场景优先选择 sfj。
• 多架构部署：在 PowerPC、z/OS 等非 x86 架构服务器上部署 Java 应用，利用镜像的跨架构兼容性。

5. 使用方法与配置说明

5.1 基础使用：运行 Java 应用

5.1.1 将应用打包到镜像中

创建 Dockerfile：

dockerfile
FROM docker.xuanyuan.run/amd64/ibmjava:jre
RUN mkdir /opt/app
COPY japp.jar /opt/app
CMD ["java", "-jar", "/opt/app/japp.jar"]

构建并运行镜像：

console
docker build -t japp .
docker run -it --rm docker.xuanyuan.run/japp

5.1.2 挂载主机目录运行应用

若需将应用 jar 包存储在主机而非镜像内，通过 -v 挂载主机路径：

创建 Dockerfile：

dockerfile
FROM docker.xuanyuan.run/amd64/ibmjava:jre
CMD ["java", "-jar", "/opt/app/japp.jar"]

构建并运行（挂载主机目录到容器）：

console
docker build -t japp .
docker run -it --rm -v /path/on/host/system/jars:/opt/app docker.xuanyuan.run/japp

5.2 启用 Class Data Sharing（CDS）特性

通过 CDS 共享类数据，需指定缓存目录，支持主机目录挂载或数据卷容器两种方式。

5.2.1 主机目录挂载共享缓存

创建 Dockerfile：

dockerfile
FROM docker.xuanyuan.run/amd64/ibmjava:jre
RUN mkdir /opt/shareclasses /opt/app
COPY japp.jar /opt/app
CMD ["java", "-Xshareclasses:cacheDir=/opt/shareclasses", "-jar", "/opt/app/japp.jar"]

构建并运行（挂载主机缓存目录）：

console
docker build -t japp .
docker run -it --rm -v /path/on/host/shareclasses:/opt/shareclasses docker.xuanyuan.run/japp

5.2.2 数据卷容器共享缓存

1. 创建数据卷容器（持久化缓存目录）：

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

2. 运行应用容器并挂载共享卷：

console
docker run -it --rm --volumes-from classcache docker.xuanyuan.run/japp

6. 许可证信息

6.1 Dockerfile 及脚本许可证

Dockerfile 和关联脚本采用 http://www.apache.org/licenses/LICENSE-2.0.html 许可。

6.2 镜像中产品许可证

• IBM® SDK, Java™ Technology Edition Version 8：http://www14.software.ibm.com/cgi-***/weblap/lap.pl?la_formnum=&li_formnum=L-SMKR-AVSEUH&title=IBM%AE+SDK%2C+Java%99+Technology+Edition%2C+Version+8.0&l=en%E3%80%82
• IBM® SDK, Java™ Technology Edition Version 11：http://www14.software.ibm.com/cgi-***/weblap/lap.pl?la_formnum=&li_formnum=L-PARM-BMVULC&title=IBM%AE+SDK%2C+Java%99+Technology+Edition%2C+Version+11.0&l=en%E3%80%82

6.3 其他软件许可证

镜像可能包含基础系统（如 Ubuntu）及依赖软件（如 Bash），其许可证需参考对应软件的许可协议。更多信息可查看 https://github.com/docker-library/repo-info/tree/master/repos/ibmjava%E3%80%82

7. 相关资源

• 维护者：https://github.com/ibmruntimes/ci.docker
• 获取帮助：https://www.ibm.com/developerworks/community/forums/html/forum?id=***-0000-0000-0000-000000000367
• 提交问题：https://github.com/ibmruntimes/ci.docker/issues
• WebSphere Liberty 镜像：基于 ibmjava 构建的应用服务器镜像，参见 https://hub.docker.com/_/websphere-liberty/