关于

这些微软构建的OpenJDK容器镜像及相应的Dockerfile设计用于任何Java应用程序或Java应用组件。

目前我们提供基于Linux的容器镜像，支持Ubuntu和微软Azure Linux。镜像发布于微软容器注册表mcr.microsoft.com/openjdk/jdk。你也可以访问mcr.microsoft.com/en-us/product/openjdk/jdk/tags获取最新可用标签列表。

要拉取特定标签的最新镜像，请使用以下命令：

bash
docker pull mcr.microsoft.com/openjdk/jdk:<tag>

推荐标签

下表显示了适用于不同Linux发行版和JDK版本的标签。

• 注意（1）：OpenJDK 8镜像包含来自Eclipse Adoptium项目的Eclipse Temurin二进制文件。
• 注意（2）：以前使用Mariner 2.0构建的旧版容器镜像标签（如25-mariner、21-mariner、17-mariner、11-mariner和8-mariner），在该Linux发行版重命名和升级后，现在镜像-azurelinux标签。如有需要，用户可通过-mariner-cm2标签降级到CBL Mariner 2.0。

旧版终止支持（EOL）镜像

基于CBL Mariner 2.0和CBL Mariner 1.0的旧版镜像已终止支持，不应再使用。

• 注意（1）：OpenJDK 8镜像包含来自Eclipse Adoptium项目的Eclipse Temurin二进制文件。

架构

上述镜像支持amd64和arm64架构。容器运行时会根据环境拉取相应架构的镜像。要强制拉取特定架构的镜像，请使用以下命令：

bash
$ docker pull --platform=linux/arm64 mcr.microsoft.com/openjdk/jdk:17-azurelinux

要在Dockerfile中强制指定架构，可使用以下方式：

Dockerfile
FROM --platform=linux/arm64 mcr.microsoft.com/openjdk/jdk:17-azurelinux AS build
# ...

有关构建多平台容器镜像的更多信息，请查看容器运行时文档，例如Docker和Podman。

如何使用这些镜像

dockerfile
# 直接使用微软构建的OpenJDK镜像示例
FROM mcr.microsoft.com/openjdk/jdk:17-ubuntu

# 继续部署应用
RUN mkdir /opt/app
COPY japp.jar /opt/app
CMD ["java", "-jar", "/opt/app/japp.jar"]

无发行版镜像

无发行版镜像基于微软的Azure Linux 3.0发行版。它们需要不同的应用部署方式。由于无发行版镜像不包含完整的Linux发行版，因此没有shell等组件。

这些镜像的ENTRYPOINT已配置为指向java命令。使用时，Dockerfile必须通过CMD指令提供JVM启动进程的命令行参数。

创建包含以下内容的Dockerfile：

dockerfile
FROM mcr.microsoft.com/openjdk/jdk:17-distroless

COPY app.jar /app.jar

CMD ["-Xmx256m", "-jar", "/app.jar"]

使用不同的基础OS镜像

如果需要我们未提供的OS基础镜像，可通过Dockerfile中的COPY --from指令复制JDK，示例如下：

dockerfile
# 使用微软构建的OpenJDK镜像与其他基础镜像的示例
FROM debian:buster-slim
ENV JAVA_HOME /usr/lib/jvm/msopenjdk-17-amd64
ENV PATH "${JAVA_HOME}/bin:${PATH}"
COPY --from=mcr.microsoft.com/openjdk/jdk:17-ubuntu $JAVA_HOME $JAVA_HOME

# 继续部署应用
RUN mkdir /opt/app
COPY japp.jar /opt/app
CMD ["java", "-jar", "/opt/app/japp.jar"]

你也可以通过yum或apt-get安装JDK，或直接解压tar.gz文件并配置JAVA_HOME。了解更多。

创建自定义Java运行时

要创建自定义Java运行时镜像，可使用类似以下示例的Dockerfile：

dockerfile
# 多阶段构建中使用jlink创建自定义Java运行时示例
FROM mcr.microsoft.com/openjdk/jdk:17-ubuntu as runtime-build

# 创建自定义Java运行时
RUN $JAVA_HOME/bin/jlink \
         --add-modules java.base \
         --strip-debug \
         --no-man-pages \
         --no-header-files \
         --compress=2 \
         --output /javaruntime

# 定义基础镜像，可选择任何所需的OS及版本
FROM debian:buster-slim
ENV JAVA_HOME /usr/lib/jvm/msopenjdk-17-amd64
ENV PATH "${JAVA_HOME}/bin:${PATH}"
COPY --from=runtime-build /javaruntime $JAVA_HOME

# 继续部署应用
RUN mkdir /opt/app
COPY japp.jar /opt/app
CMD ["java", "-jar", "/opt/app/japp.jar"]

有关创建自定义Java运行时的更多信息，请参见使用jlink的Java运行时

保持使用旧的次要版本

微软构建的OpenJDK容器镜像仅提供前述列出的标签。我们不发布次要版本标签，主版本标签始终包含最新的次要版本，以确保开发人员始终获得特定主版本的最新更新。

这些基础镜像使用Linux发行版的底层包管理器机制安装JDK包。因此，要保持特定版本，需使用apt-get或yum等工具安装特定的JDK次要版本。

可在Dockerfile中按以下示例配置：

Ubuntu示例：

Dockerfile
FROM mcr.microsoft.com/openjdk/jdk:11-ubuntu
...
RUN apt-get update && \
    apt-get install -y --allow-downgrades msopenjdk-11=11.0.26-1
...

Azure Linux示例：

Dockerfile
FROM mcr.microsoft.com/openjdk/jdk:11-azurelinux
...
RUN tdnf update -y && \
    tdnf install -y --nogpgcheck msopenjdk-11-11.0.26-1
...

有关此主题的更多信息和详细说明，请访问微软构建的OpenJDK文档。

推荐仓库

• microsoft/openjdk-docker

完整标签列表

访问MCR获取最新标签列表。

配置

无。

支持

微软构建的OpenJDK支持

反馈

请将关于Docker镜像的反馈发送至microsoft/openjdk-docker

许可

• ***声明：容器许可信息
• 微软构建的OpenJDK基于GPL2 with Classpath Exception许可。

延伸阅读

• 微软构建的OpenJDK
• 关于微软构建的OpenJDK
• 微软构建的OpenJDK容器镜像
• 常见问题