arm64v8/sapmachine Docker 镜像 - 轩辕镜像

arm64v8/sapmachine Docker 镜像文档

镜像概述和主要用途

arm64v8/sapmachine 是官方 SapMachine Docker 镜像的 arm64v8 架构版本。SapMachine 是 OpenJDK 的二进制发行版，由 SAP 构建、质量测试并提供长期支持。该镜像专为 ARM64 架构设计，提供了在 64 位 ARM 平台上运行 Java 应用程序的可靠环境。

SapMachine 是 SAP 业务技术平台的默认 Java 运行时，同时也被支持作为 Cloud Foundry Java Build Pack 中的标准 JRE。

!logo

核心功能和特性

• 基于 Ubuntu 操作系统构建，提供稳定可靠的运行环境
• 包含 OpenJDK 的二进制发行版，经过 SAP 的严格测试
• 支持多种 Java 版本（JDK 25、21、17 等）
• 提供多种发行版变体：
  • 完整 JDK（包含开发工具）
  • Headless JDK（无 GUI 组件的 JDK）
  • JRE（Java 运行时环境）
  • Headless JRE（无 GUI 组件的 JRE）
• 长期支持 (LTS) 版本可用，适合生产环境
• 针对 ARM64 架构优化，提供最佳性能

使用场景和适用范围

• ARM64 架构服务器上的 Java 应用部署
• 开发和测试 Java 应用程序
• 构建基于 Java 的微服务
• 容器化 Java 应用以实现一致的部署环境
• SAP 业务技术平台相关应用的开发和运行
• 需要长期支持 Java 环境的企业级应用

支持的标签和版本

JDK 25 系列

• latest, ubuntu, jdk, jdk-ubuntu, lts, lts-ubuntu, 25, 25-ubuntu, 25-jdk, 25-jdk-ubuntu, lts-jdk-ubuntu, ubuntu-noble, ubuntu-24.04, jdk-ubuntu-noble, jdk-ubuntu-24.04, lts-ubuntu-noble, lts-ubuntu-24.04, lts-jdk-ubuntu-noble, lts-jdk-ubuntu-24.04, 25-ubuntu-noble, 25-ubuntu-24.04, 25-jdk-ubuntu-noble, 25-jdk-ubuntu-24.04
• jdk-headless, jdk-headless-ubuntu, 25-jdk-headless, 25-jdk-headless-ubuntu, lts-jdk-headless-ubuntu, jdk-headless-ubuntu-noble, jdk-headless-ubuntu-24.04, lts-jdk-headless-ubuntu-noble, lts-jdk-headless-ubuntu-24.04, 25-jdk-headless-ubuntu-noble, 25-jdk-headless-ubuntu-24.04
• jre, jre-ubuntu, 25-jre, 25-jre-ubuntu, lts-jre-ubuntu, jre-ubuntu-noble, jre-ubuntu-24.04, lts-jre-ubuntu-noble, lts-jre-ubuntu-24.04, 25-jre-ubuntu-noble, 25-jre-ubuntu-24.04
• jre-headless, jre-headless-ubuntu, 25-jre-headless, 25-jre-headless-ubuntu, lts-jre-headless-ubuntu, jre-headless-ubuntu-noble, jre-headless-ubuntu-24.04, lts-jre-headless-ubuntu-noble, lts-jre-headless-ubuntu-24.04, 25-jre-headless-ubuntu-noble, 25-jre-headless-ubuntu-24.04

JDK 21 系列

• 21, 21-ubuntu, 21.0.8, 21.0.8-ubuntu, 21-jdk, 21-jdk-ubuntu, 21.0.8-jdk, 21.0.8-jdk-ubuntu, 21-ubuntu-noble, 21-ubuntu-24.04, 21-jdk-ubuntu-noble, 21-jdk-ubuntu-24.04, 21.0.8-ubuntu-noble, 21.0.8-ubuntu-24.04, 21.0.8-jdk-ubuntu-noble, 21.0.8-jdk-ubuntu-24.04
• 21-jdk-headless, 21-jdk-headless-ubuntu, 21.0.8-jdk-headless, 21.0.8-jdk-headless-ubuntu, 21-jdk-headless-ubuntu-noble, 21-jdk-headless-ubuntu-24.04, 21.0.8-jdk-headless-ubuntu-noble, 21.0.8-jdk-headless-ubuntu-24.04
• 21-jre, 21-jre-ubuntu, 21.0.8-jre, 21.0.8-jre-ubuntu, 21-jre-ubuntu-noble, 21-jre-ubuntu-24.04, 21.0.8-jre-ubuntu-noble, 21.0.8-jre-ubuntu-24.04
• 21-jre-headless, 21-jre-headless-ubuntu, 21.0.8-jre-headless, 21.0.8-jre-headless-ubuntu, 21-jre-headless-ubuntu-noble, 21-jre-headless-ubuntu-24.04, 21.0.8-jre-headless-ubuntu-noble, 21.0.8-jre-headless-ubuntu-24.04

JDK 17 系列

• 17, 17-ubuntu, 17.0.16, 17.0.16-ubuntu, 17-jdk, 17-jdk-ubuntu, 17.0.16-jdk, 17.0.16-jdk-ubuntu, 17-ubuntu-noble, 17-ubuntu-24.04, 17-jdk-ubuntu-noble, 17-jdk-ubuntu-24.04, 17.0.16-ubuntu-noble, 17.0.16-ubuntu-24.04, 17.0.16-jdk-ubuntu-noble, 17.0.16-jdk-ubuntu-24.04
• 17-jdk-headless, 17-jdk-headless-ubuntu, 17.0.16-jdk-headless, 17.0.16-jdk-headless-ubuntu, 17-jdk-headless-ubuntu-noble, 17-jdk-headless-ubuntu-24.04, 17.0.16-jdk-headless-ubuntu-noble, 17.0.16-jdk-headless-ubuntu-24.04
• 17-jre, 17-jre-ubuntu, 17.0.16-jre, 17.0.16-jre-ubuntu, 17-jre-ubuntu-noble, 17-jre-ubuntu-24.04, 17.0.16-jre-ubuntu-noble, 17.0.16-jre-ubuntu-24.04
• 17-jre-headless, 17-jre-headless-ubuntu, 17.0.16-jre-headless, 17.0.16-jre-headless-ubuntu, 17-jre-headless-ubuntu-noble, 17-jre-headless-ubuntu-24.04, 17.0.16-jre-headless-ubuntu-noble, 17.0.16-jre-headless-ubuntu-24.04

Ubuntu 22.04 (Jammy) 变体

所有上述标签都有对应的 Ubuntu 22.04 版本，标签中包含 -ubuntu-jammy 或 -ubuntu-22.04 后缀。

使用方法和配置说明

基本使用

拉取并测试镜像:

console
docker pull arm64v8/sapmachine:latest
docker run -it arm64v8/sapmachine:latest java -version

作为基础镜像构建应用

创建 Dockerfile:

dockerfile
FROM arm64v8/sapmachine:latest
RUN mkdir /opt/myapp
COPY myapp.jar /opt/myapp
CMD ["java", "-jar", "/opt/myapp/myapp.jar"]

构建并运行:

console
docker build -t myapp .
docker run -it --rm myapp

指定 Java 版本

console
# 使用 JDK 21
docker run -it arm64v8/sapmachine:21 java -version

# 使用特定版本的 JDK 21
docker run -it arm64v8/sapmachine:21.0.8 java -version

# 使用 JRE 而非 JDK
docker run -it arm64v8/sapmachine:21-jre java -version

Docker Compose 示例

创建 docker-compose.yml:

yaml
version: '3'
services:
  app:
    image: arm64v8/sapmachine:21-jdk
    volumes:
      - ./app:/app
    working_dir: /app
    command: java -jar myapplication.jar
    environment:
      - JAVA_OPTS=-Xmx512m -Xms256m

启动服务:

console
docker-compose up

配置 Java 运行参数

可以通过环境变量或命令行参数配置 Java 运行时:

console
# 通过命令行参数
docker run -it arm64v8/sapmachine:latest java -Xmx512m -jar myapp.jar

# 通过环境变量
docker run -it -e JAVA_OPTS="-Xmx512m -Xms256m" arm64v8/sapmachine:latest java $JAVA_OPTS -jar myapp.jar

环境变量配置

虽然镜像本身不定义特定的环境变量，但可以设置标准的 Java 环境变量来配置运行时:

• JAVA_HOME: Java 安装目录 (镜像中已设置为 /opt/java/openjdk)
• JAVA_OPTS: 常用的 Java 运行参数集合
• CLASSPATH: Java 类路径
• JAVA_TOOL_OPTIONS: 用于指定 JVM 工具的选项

维护和支持

• 维护者: SapMachine 团队
• 获取帮助: 发送邮件至 ***
• 提交问题: GitHub Issues
• 更多信息: SapMachine Wiki

许可证信息

Dockerfile 和相关脚本采用 Apache License 2.0 许可。

镜像中安装的 SapMachine 产品许可证: SapMachine 采用 GNU General Public License (GPL) 版本及 "CLASSPATH" 例外 许可。

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

一些能够自动检测到的附加许可信息可以在 repo-info 仓库的 sapmachine/ 目录 中找到。

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

Java 及所有基于 Java 的商标和徽标是 Oracle 和/或其关联公司的商标或注册商标。