Microsoft Build of OpenJDK のコンテナーイメージ

[アーティクル]
07/15/2024

この記事では、Microsoft Build of OpenJDK の使用可能なコンテナーイメージについて説明します。

Linux ベースのイメージ

現在、Ubuntu および Microsoft CBL-Mariner (現在は Azure Linux と呼ばれています) 用の Linux ベースのコンテナーイメージを提供しています。このイメージは、mcr.microsoft.com/openjdk/jdk にある Microsoft アーティファクトレジストリに公開されています。

特定のタグの最新のイメージをプルするには、次のコマンドを使用します。

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

次の表は、Linux ディストリビューションに使用するタグと JDK のバージョンを示しています。

基本 OS	OpenJDK 21	OpenJDK 17	OpenJDK 11	OpenJDK 8
Ubuntu 22.04	`21-ubuntu`	`17-ubuntu`	`11-ubuntu`	N/A
CBL Mariner 2.0	`21-mariner`	`17-mariner`	`11-mariner`	`8-mariner`
CBL-Mariner 2.0 Distroless	`21-distroless`	`17-distroless`	`11-distroless`	`8-distroless`

注: "OpenJDK 8 のイメージには、Eclipse Adoptium プロジェクトの Eclipse Temurin のバイナリが付属しています。"

アーキテクチャ

上記のイメージは、amd64 と arm64 の両方のアーキテクチャで提供されています。コンテナーランタイムは、環境に基づいて適切なイメージをプルします。特定のアーキテクチャのイメージを強制的にプルするには、次のコマンドを使用します。

$ docker pull --platform=linux/arm64 mcr.microsoft.com/openjdk/jdk:21-mariner

Dockerfile 内でアーキテクチャを強制するには、次のコマンドを使用できます。

FROM --platform=linux/arm64 mcr.microsoft.com/openjdk/jdk:21-mariner AS build
# ...

マルチプラットフォームコンテナーイメージの構築の詳細については、コンテナーランタイムのドキュメントを参照してください。例としては、Docker、Podman などがあります。

コンテナーイメージの使用方法

次の内容を含む Dockerfile を作成します。

# Example using MS Build of OpenJDK image directly
FROM mcr.microsoft.com/openjdk/jdk:21-ubuntu

# Continue with your application deployment
RUN mkdir /opt/app
COPY japp.jar /opt/app
CMD ["java", "-jar", "/opt/app/japp.jar"]

distroless

distroless イメージは、Microsoft による CBL-Mariner 2.0 ディストリビューションに基づいています。これらのイメージには、アプリケーションをデプロイするための別のアプローチが必要です。 distroless イメージには完全な Linux ディストリビューションが含まれていないため、たとえばシェルはありません。

これらのイメージの ENTRYPOINT は、java コマンドを指すように既に構成されています。 Dockerfile を使用するには、CMD 命令を使用して、JVM ランチャープロセスのコマンドライン引数を完了する必要があります。

次の内容を含む Dockerfile を作成します。

FROM mcr.microsoft.com/openjdk/jdk:21-distroless

COPY app.jar /app.jar

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

別の OS 基本イメージまたはバージョンを使用する

別の OS 基本イメージディストリビューションを使用する場合は、次の例のように、Dockerfile で COPY --from 命令を使用して、既存の事前構築済みイメージから JDK をコピーできます。

# Example using MS Build of OpenJDK image with a different base image
FROM debian:buster-slim
ENV LANG en_US.UTF-8
ENV JAVA_HOME /usr/lib/jvm/msopenjdk-21-amd64
ENV PATH "${JAVA_HOME}/bin:${PATH}"
COPY --from=mcr.microsoft.com/openjdk/jdk:21-ubuntu $JAVA_HOME $JAVA_HOME

# Continue with your application deployment
RUN mkdir /opt/app
COPY japp.jar /opt/app
CMD ["java", "-jar", "/opt/app/japp.jar"]

また、yum または apt-get を使用して JDK をインストールすることも、単に tar.gz ファイルを抽出し、JAVA_HOME を適切に構成することもできます。詳細については、こちらを参照してください。

別のバージョンの Ubuntu を使用する

別のバージョンの Ubuntu 基本イメージに Microsoft Build of OpenJDK をデプロイするには、Microsoft では、ユーザーが独自の Dockerfiles を作成することをお勧めしています。参考までに、次の Dockerfile は Ubuntu 24.04 を使用してイメージをビルドします。

# Example using MS Build of OpenJDK image with a different version of Ubuntu
FROM ubuntu:24.04
ENV LANG en_US.UTF-8
ENV JAVA_HOME /usr/lib/jvm/msopenjdk-21-amd64
ENV PATH "${JAVA_HOME}/bin:${PATH}"
COPY --from=mcr.microsoft.com/openjdk/jdk:21-ubuntu $JAVA_HOME $JAVA_HOME

# Continue with your application deployment
RUN mkdir /opt/app
COPY japp.jar /opt/app
CMD ["java", "-jar", "/opt/app/japp.jar"]

Alpine イメージ

Microsoft は Alpine ベースのイメージを提供していませんが、Alpine Linux 用の限定された musl コンパイル JDK バイナリセットを提供しています。

ユーザーは、使用可能なバイナリを使用して、Alpine Linux 用のコンテナーイメージを作成できます。

次の内容を含む Dockerfile を作成します。

FROM alpine:latest

ENV JAVA_HOME=/usr/lib/jdk
ENV PATH=${PATH}:${JAVA_HOME}/bin

# Default to UTF-8 file.encoding
ENV LANG='en_US.UTF-8' LANGUAGE='en_US:en' LC_ALL='en_US.UTF-8'

# (Optional) Add extra packages for fontconfig and ttf-dejavu to support server-side image generation
RUN apk add --no-cache fontconfig libretls musl-locales musl-locales-lang ttf-dejavu tzdata zlib \
    && rm -rf /var/cache/apk/*

# Download and extract JDK 17
RUN wget -nv -O jdk.tar.gz https://aka.ms/download-jdk/microsoft-jdk-17-alpine-x64.tar.gz && \
    mkdir $JAVA_HOME && \
    tar xf jdk.tar.gz -C $JAVA_HOME --strip-components 1 --no-same-owner

# Copy the application
COPY app.jar /app.jar

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

カスタム Java ランタイムを作成する

カスタム Java ランタイムイメージを作成するには、次の例のようなマルチステージ Dockerfile を使用します。

# Example of custom Java runtime using jlink in a multi-stage container build
FROM mcr.microsoft.com/openjdk/jdk:21-ubuntu as runtime-build

# Create a custom Java runtime
RUN $JAVA_HOME/bin/jlink \
         --add-modules java.base \
         --strip-debug \
         --no-man-pages \
         --no-header-files \
         --compress=2 \
         --output /javaruntime

# Define your base image. You may use any base OS and version of your choice.
FROM debian:buster-slim
ENV LANG en_US.UTF-8
ENV JAVA_HOME /usr/lib/jvm/msopenjdk-21-amd64
ENV PATH "${JAVA_HOME}/bin:${PATH}"
COPY --from=runtime-build /javaruntime $JAVA_HOME

# Continue with your application deployment
RUN mkdir /opt/app
COPY japp.jar /opt/app
CMD ["java", "-jar", "/opt/app/japp.jar"]

カスタム Java ランタイムの作成の詳細については、「jlink を使用した Java ランタイム」を参照してください

非ルートユーザー

イメージには app ユーザーが付属しており、必要に応じて有効にし、レイヤーを使用して使用することができます。

FROM mcr.microsoft.com/openjdk/jdk:21-mariner

WORKDIR /home/app
COPY japp.jar japp.jar
USER app

CMD ["java", "-jar", "/opt/app/japp.jar"]

上記の例では、イメージは既定の root のままであるため、アプリケーションバイナリは root としてコピーされます。その後、アプリケーションは app として実行されます。さらに、フォルダー /home/app はユーザー app によって所有され、アプリケーションに書き込み可能なファイルシステムが提供されます。

既定のロケール

既定では、Microsoft Build of OpenJDK のイメージは en_US.UTF-8 ロケールで構成されます。別のロケールを使用する場合、または前述のように別の基本イメージを使用する場合は、独自の Dockerfile で環境変数を手動で構成し、必要なロケールがインストールされていることを確認する必要があります。

たとえば、Ubuntu ベースのイメージで pt_BR.UTF-8 ロケールを使用するには、Dockerfile に次の行を追加できます。

...
USER root
RUN apt-get update
RUN apt-get install -y locales

RUN sed -i '/pt_BR.UTF-8/s/^# //g' /etc/locale.gen
RUN locale-gen

ENV LANG pt_BR.UTF-8
ENV LANGUAGE pt_BR:pt
ENV LC_ALL pt_BR.UTF-8
...

この Dockerfile は、例として提供されており、最適な構成を示すためのものではありません。

以前のマイナーバージョンのまま使用する

Microsoft Build of OpenJDK のコンテナーイメージは、前述のタグでのみ使用できます。マイナーバージョンのタグは提供されておらず、開発者が特定のメジャーバージョンの最新のアップデートを確実に入手できるように、メジャーバージョンのタグには常に最新のマイナーバージョンが含まれています。

これらの基本イメージでは、Linux ディストリビューションの基になるパッケージマネージャーを使用して JDK パッケージをインストールします。そのため、以前の特定のバージョンのまま使用するには、apt-get や yum などのツールを使用して、JDK の特定のマイナーバージョンをインストールする必要があります。

提供されているイメージの一覧にない異なる OS 基本イメージ (例: debian:buster-slim) の特定のバージョンにロールバックするには、マルチステージコンテナーイメージビルドの最初のステージで、または従来の Linux パッケージインストールフローの一部として、以下と同じアプローチを使用できます。詳細については、「OpenJDK の Microsoft Build をインストールする」の Ubuntu 18.04 以降へのインストールに関するセクションを参照してください。

RPM/yum ベースの CBL-Mariner およびその他の OS イメージについては、この記事で後ほど説明する詳細を参照してください。

Ubuntu、およびその他の Debian ベースのイメージの場合は、コマンドと出力を示す次の Bash の例に示すように、Microsoft Linux リポジトリで公開されている利用可能なすべてのマイナーバージョンを表示できます。ここで示すコマンドは、Ubuntu 18.04 以降へのインストールに関するセクションで説明されているように、Microsoft Linux リポジトリが構成されていることを前提としています。

$ docker run --pull=always -ti --rm mcr.microsoft.com/openjdk/jdk:11-ubuntu
root@c60eacd7dd7d:/# apt-get update
...

root@c60eacd7dd7d:/# apt-cache madison msopenjdk-11
msopenjdk-11 |  11.0.23-1 | https://packages.microsoft.com/ubuntu/22.04/prod jammy/main amd64 Packages
msopenjdk-11 |  11.0.22-1 | https://packages.microsoft.com/ubuntu/22.04/prod jammy/main amd64 Packages
msopenjdk-11 |  11.0.21-1 | https://packages.microsoft.com/ubuntu/22.04/prod jammy/main amd64 Packages
msopenjdk-11 | 11.0.20.1-1 | https://packages.microsoft.com/ubuntu/22.04/prod jammy/main amd64 Packages
msopenjdk-11 |  11.0.20-3 | https://packages.microsoft.com/ubuntu/22.04/prod jammy/main amd64 Packages
msopenjdk-11 |  11.0.20-2 | https://packages.microsoft.com/ubuntu/22.04/prod jammy/main amd64 Packages
msopenjdk-11 |  11.0.20-1 | https://packages.microsoft.com/ubuntu/22.04/prod jammy/main amd64 Packages
msopenjdk-11 |  11.0.19-1 | https://packages.microsoft.com/ubuntu/22.04/prod jammy/main amd64 Packages
msopenjdk-11 |  11.0.18-1 | https://packages.microsoft.com/ubuntu/22.04/prod jammy/main amd64 Packages
...

次の Bash の例は、イメージ msopenjdk-11 を以前のバージョン (たとえば 11.0.16-1) に戻す方法を示しています。

root@dd24eca5bdb3:/# java -version
openjdk version "11.0.23" 2024-04-16 LTS
OpenJDK Runtime Environment Microsoft-9394293 (build 11.0.23+9-LTS)
OpenJDK 64-Bit Server VM Microsoft-9394293 (build 11.0.23+9-LTS, mixed mode, sharing)

root@a93cd1ed8783:/# apt-get -y install -y --allow-downgrades msopenjdk-11=11.0.16-1
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
The following additional packages will be installed:
  fonts-dejavu
The following NEW packages will be installed:
  fonts-dejavu
The following packages will be DOWNGRADED:
  msopenjdk-11
0 upgraded, 1 newly installed, 1 downgraded, 0 to remove and 0 not upgraded.
Need to get 194 MB of archives.
After this operation, 13.0 MB disk space will be freed.
Get:1 http://archive.ubuntu.com/ubuntu jammy/universe amd64 fonts-dejavu all 2.37-2build1 [3,192 B]
Get:2 https://packages.microsoft.com/ubuntu/22.04/prod jammy/main amd64 msopenjdk-11 amd64 11.0.16-1 [194 MB]
Fetched 194 MB in 18s (10.7 MB/s)
debconf: delaying package configuration, since apt-utils is not installed
Selecting previously unselected package fonts-dejavu.
(Reading database ... 9151 files and directories currently installed.)
Preparing to unpack .../fonts-dejavu_2.37-2build1_all.deb ...
Unpacking fonts-dejavu (2.37-2build1) ...
dpkg: warning: downgrading msopenjdk-11 from 11.0.23-1 to 11.0.16-1
Preparing to unpack .../msopenjdk-11_11.0.16-1_amd64.deb ...
update-alternatives: using /usr/lib/jvm/msopenjdk-11-amd64/lib/jfr to provide /usr/bin/jfr (jfr) in auto mode
Unpacking msopenjdk-11 (11.0.16-1) over (11.0.23-1) ...
Setting up fonts-dejavu (2.37-2build1) ...
Setting up msopenjdk-11 (11.0.16-1) ...

Dockerfile で同じ操作を行うには、次のコマンドを使用します。

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

次の Bash の例では、CBL-Mariner ベースのイメージを使用しています。

root [ / ]# java -version
openjdk version "11.0.15" 2022-04-19 LTS
OpenJDK Runtime Environment Microsoft-32930 (build 11.0.15+10-LTS)
OpenJDK 64-Bit Server VM Microsoft-32930 (build 11.0.15+10-LTS, mixed mode)

root [ / ]# yum update
...

root [ / ]# yum list msopenjdk-11
Loaded plugin: tdnfrepogpgcheck
msopenjdk-11.x86_64   11.0.14+9_LTS-1    @System
msopenjdk-11.x86_64   11.0.10+9-1        packages-microsoft-com-prod
msopenjdk-11.x86_64   11.0.11+9-1        packages-microsoft-com-prod
msopenjdk-11.x86_64   11.0.12+7-1        packages-microsoft-com-prod
msopenjdk-11.x86_64   11.0.13+8_LTS-1    packages-microsoft-com-prod
msopenjdk-11.x86_64   11.0.14+9_LTS-1    packages-microsoft-com-prod

root [ / ]# yum install -y --nogpgcheck msopenjdk-11-11.0.15-1
Loaded plugin: tdnfrepogpgcheck

Downgrading:
msopenjdk-11  x86_64  11.0.15-1  mariner-official-microsoft  308.10M  183.75M

Total installed size: 308.10M
Total download size: 183.75M
msopenjdk-11                         192678446 100%
Testing transaction
Running transaction
Installing/Updating: msopenjdk-11-11.0.15-1.x86_64
Removing: msopenjdk-11-11.0.23-1.x86_64

Dockerfile で同じ操作を行うには、次のコマンドを使用します。

FROM mcr.microsoft.com/openjdk/jdk:11-mariner
...
RUN yum update && \
    yum install -y --nogpgcheck msopenjdk-11-11.0.15-1
...

Windows ベースのイメージ

現在、Windows ベースのコンテナーイメージは提供されていません。

OpenJDK の Microsoft Build に関するフィードバックの提供

OpenJDK の Microsoft Build の改善に役立てるために、ご意見、ご感想、アイデアをお寄せください。 GitHub の OpenJDK ディスカッションページにアクセスして、フィードバックを送信してください。

Java と OpenJDK は、Oracle やその関連会社の商標または登録商標です。

次の方法で共有

Microsoft Build of OpenJDK のコンテナーイメージ

Linux ベースのイメージ

アーキテクチャ

コンテナーイメージの使用方法

distroless

別の OS 基本イメージまたはバージョンを使用する

別のバージョンの Ubuntu を使用する

Alpine イメージ

カスタム Java ランタイムを作成する

非ルートユーザー

既定のロケール

以前のマイナーバージョンのまま使用する

Windows ベースのイメージ

OpenJDK の Microsoft Build に関するフィードバックの提供

その他のリソース

次の方法で共有

Microsoft Build of OpenJDK のコンテナー イメージ

Linux ベースのイメージ

アーキテクチャ

コンテナー イメージの使用方法

distroless

別の OS 基本イメージまたはバージョンを使用する

別のバージョンの Ubuntu を使用する

Alpine イメージ

カスタム Java ランタイムを作成する

非ルート ユーザー

既定のロケール

以前のマイナー バージョンのまま使用する

Windows ベースのイメージ

OpenJDK の Microsoft Build に関するフィードバックの提供

その他のリソース

Microsoft Build of OpenJDK のコンテナーイメージ

コンテナーイメージの使用方法

非ルートユーザー

以前のマイナーバージョンのまま使用する