s390x/ibmjava

IBM Java Docker 镜像 (s390x 架构)

镜像概述和主要用途

该仓库中的镜像包含 IBM® SDK, Java™ Technology Edition，专为 s390x 架构构建。IBM Java SDK 提供高性能、可扩展的 Java 运行环境，适用于企业级 Java 应用程序的开发和部署。

注意: 这是 ibmjava 官方镜像针对 s390x 架构的"每架构"仓库。有关更多信息，请参阅官方镜像文档中的"除 amd64 之外的架构？"和官方镜像 FAQ 中的"Git 中的镜像源已更改，现在该怎么办？"。

核心功能和特性

• 多种镜像类型: 提供 SDK（软件开发工具包）、JRE（Java 运行时环境）和 SFJ（Small Footprint JRE，小型足迹 JRE）三种镜像类型
• 多架构支持: 支持 amd64、ppc64le 和 s390x 等多种架构
• Class Data Sharing: 提供类数据共享功能，减少内存消耗并提高 JVM 启动时间
• 企业级性能: 基于 Eclipse OpenJ9 JVM，提供企业级性能和可扩展性

支持的标签及对应 Dockerfile 链接

• https://github.com/ibmruntimes/ci.docker/blob/c02f788be741734c7c5aa45832f63a700bae3707/ibmjava/8/jre/ubuntu/Dockerfile
• https://github.com/ibmruntimes/ci.docker/blob/c02f788be741734c7c5aa45832f63a700bae3707/ibmjava/8/sfj/ubuntu/Dockerfile
• https://github.com/ibmruntimes/ci.docker/blob/c02f788be741734c7c5aa45832f63a700bae3707/ibmjava/8/sdk/ubuntu/Dockerfile

镜像详情

维护者

https://github.com/ibmruntimes/ci.docker

获取帮助

IBM Java Runtimes and SDKs 的 developerWorks 论坛

问题反馈

https://github.com/ibmruntimes/ci.docker/issues%EF%BC%9B%E6%9C%89%E5%85%B3%E6%95%85%E9%9A%9C%E6%8E%92%E9%99%A4%EF%BC%8C%E8%AF%B7%E5%8F%82%E9%98%85 How Do I ...? 页面

支持的架构

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

镜像更新信息

• https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fibmjava
• https://github.com/docker-library/official-images/blob/master/library/ibmjava (历史记录)

镜像类型说明

SDK 镜像

包含完整的 IBM Java 软件开发工具包，适用于 Java 应用程序的开发、编译和测试。标签为 8-sdk 或 sdk。

JRE 镜像

包含 Java 运行时环境，仅包含运行 Java 应用程序所需的组件，不包含开发工具。标签为 8-jre、jre、8 或 latest。

SFJ 镜像

Small Footprint JRE (SFJ) 专为云环境优化，移除了云环境中不需要的 Java 工具和功能（如 Java 控制面板），提供更小的磁盘和内存占用。标签为 8-sfj 或 sfj。

Alpine Linux 支持

如果关注整体镜像大小，可以考虑使用 Alpine Linux 版本。Alpine Linux 是一个精简版 Linux，基于 musl libc 和 Busybox，基础镜像大小约为 5 MB。由于 IBM SDK 依赖于 GNU glibc，需要额外安装该库（约增加 8 MB 镜像大小）。

不同环境下的镜像大小比较（基于 JRE 版本 8.0-3.10）：

注意: Alpine Linux 不是 IBM® SDK, Java™ Technology Edition 的官方支持操作系统。

使用场景和适用范围

• 企业级 Java 应用部署: 为企业级 Java 应用提供稳定可靠的运行环境
• 云原生应用: SFJ 镜像特别适合云环境和容器化部署，减少资源占用
• 微服务架构: 适合构建和运行微服务架构中的 Java 微服务
• 跨平台开发: SDK 镜像可用于在不同架构上进行 Java 应用开发和测试

详细使用方法和配置说明

基础用法：运行 Java 应用

方法 1：将 JAR 包内置到镜像中

创建 Dockerfile：

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

构建并运行：

bash
docker build -t japp .
docker run -it --rm japp

方法 2：通过卷挂载 JAR 包

创建 Dockerfile：

dockerfile
FROM s390x/ibmjava:jre
CMD ["java", "-jar", "/opt/app/japp.jar"]

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

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

使用类数据共享 (Class Data Sharing) 功能

IBM SDK, Java Technology Edition 提供类数据共享功能，可在同一主机上的多个 Java 虚拟机 (JVM) 之间透明动态地共享数据，从而减少每个 JVM 实例消耗的物理内存，并提高 JVM 的启动时间。

要在不同容器中的 JVM 之间启用类数据共享，需要在容器之间共享一个公共位置，可通过主机或数据卷容器实现。

使用主机目录共享

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

构建并运行，挂载主机共享目录：

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

使用数据卷容器共享

创建数据卷容器：

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

使用 --volumes-from 标志启动 JVM 容器：

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

Docker Compose 示例

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  app:
    build: .
    volumes:
      - /path/on/host/shareclasses:/opt/shareclasses
      - /path/on/host/app:/opt/app
    command: java -Xshareclasses:cacheDir=/opt/shareclasses -jar /opt/app/japp.jar

构建并启动：

bash
docker-compose up -d

另请参阅

• https://hub.docker.com/_/websphere-liberty/%EF%BC%9A%E6%9E%84%E5%BB%BA%E5%9C%A8 IBM Java 镜像之上，提供 WebSphere Liberty 应用服务器环境

许可证

Dockerfile 和相关脚本根据 Apache License 2.0 许可。

镜像中安装的产品的许可证：

• IBM® SDK, Java™ Technology Edition 版本 8: 非保证程序国际许可协议
• IBM® SDK, Java™ Technology Edition 版本 11: 非保证程序国际许可协议

与所有 Docker 镜像一样，这些镜像可能还包含其他软件，这些软件可能受其他许可证（如基础发行版中的 Bash 等，以及包含的主要软件的任何直接或间接依赖项）的约束。

一些能够自动检测到的附加许可信息可以在 https://github.com/docker-library/repo-info/tree/master/repos/ibmjava 中找到。

对于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用符合其中包含的所有软件的相关许可。