OpenJDK'nin Microsoft Derlemesi için kapsayıcı görüntüleri

  • Makale

Bu makale, OpenJDK'nin Microsoft Derlemesi için kullanılabilir kapsayıcı görüntüleri hakkında bilgi sağlar.

Linux tabanlı görüntüler

Şu anda Ubuntu ve Artık Azure Linux olarak bilinen Microsoft CBL-Mariner için Linux tabanlı kapsayıcı görüntüleri suluyoruz. Görüntüler konumundaki Microsoft Yapıt Kayıt Defteri mcr.microsoft.com/openjdk/jdkyayımlanır.

Belirli bir etiket için en son görüntüyü çekmek için aşağıdaki komutu kullanın:

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

Aşağıdaki tabloda Linux dağıtımınız ve JDK sürümünüz için kullanılacak etiket gösterilmektedir.

Base OS OpenJDK 21 OpenJDK 17 OpenJDK 11 OpenJDK 8
Ubuntu 22.04 21-ubuntu 17-ubuntu 11-ubuntu Yok
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

Not: Eclipse Adoptium projesinden Eclipse Temurin ikili dosyalarıyla birlikte OpenJDK 8 için görüntüler.

Mimariler

Yukarıdaki görüntüler hem hem de amd64 arm64 mimariler için sunulur. Kapsayıcı çalışma zamanınız ortamınıza göre doğru görüntüyü çekecektir. Belirli bir mimari için görüntünün çekilmesini zorlamak için aşağıdakileri kullanın:

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

içinde Dockerfilebir mimariyi zorlamak için aşağıdakileri kullanabilirsiniz:

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

Çok platformlu kapsayıcı görüntüleri oluşturma hakkında daha fazla bilgi için kapsayıcı çalışma zamanınızın belgelerine bakın. Örneğin, Docker ve Podman.

Bu görüntüleri kullanma

Aşağıdaki içeriklere sahip bir Dockerfile oluşturun:

# 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 görüntüleri, Microsoft'un CBL-Mariner 2.0 dağıtımını temel alır. Bir uygulamayı dağıtmak için farklı bir yaklaşıma ihtiyaç duyarlar. Distroless görüntüleri tam bir Linux dağıtımı içermediğinden, örneğin kabuk yoktur.

ENTRYPOINT Bu görüntülerin komutuna java işaret eden şekilde zaten yapılandırılmıştır. Dockerfiles kullanmak, JVM başlatıcı işleminin komut satırı bağımsız değişkenlerini tamamlamak için yönergeyi kullanmalıdırCMD.

Aşağıdaki içeriklere sahip bir Dockerfile oluşturun:

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

COPY app.jar /app.jar

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

Farklı bir Temel İşletim Sistemi görüntüsü veya sürümü kullanma

Farklı bir işletim sistemi temel görüntü dağıtımı kullanmayı tercih ediyorsanız, aşağıdaki örneğe benzer şekilde dockerfile içindeki yönergeyi COPY --from kullanarak mevcut önceden oluşturulmuş görüntüden JDK'yi kopyalayabilirsiniz:

# 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"]

JDK'yi veya kullanarak yum da yükleyebilir ya da yalnızca bir tar.gz dosya ayıklayabilir ve uygun şekilde yapılandırabilirsinizJAVA_HOME.apt-get Daha fazla bilgi edinin.

Ubuntu'nun farklı bir sürümünü kullanma

Microsoft Build of OpenJDK'yi Ubuntu temel görüntülerinin farklı sürümlerine dağıtmak için Microsoft, kullanıcıların kendi Dockerfilesyazmalarını önerir. Başvuru için, aşağıdaki Dockerfile Ubuntu 24.04 ile bir görüntü oluşturur.

# 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"]

Alp resimleri

Microsoft Alp tabanlı görüntüler sağlamasa da, Alpine Linux için musl ile derlenmiş JDK ikili dosyalarının sınırlı bir kümesini sağlarız.

Kullanıcılar kullanılabilir ikili dosyaları kullanarak Alpine Linux için kapsayıcı görüntüleri oluşturabilir.

Aşağıdaki içeriklere sahip bir Dockerfile oluşturun:

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" ]

Özel Java çalışma zamanı oluşturma

Özel java çalışma zamanı görüntüsü oluşturmak için aşağıdaki örneğe benzer çok aşamalı bir Dockerfile kullanın:

# 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"]

Özel Java çalışma zamanları oluşturma hakkında daha fazla bilgi için bkz. jlink ile Java Çalışma Zamanları

Kök olmayan kullanıcı

Görüntüler, isteğe bağlı olarak etkinleştirilebilen ve katmanlar kullanılarak kullanılabilen bir app kullanıcıyla birlikte gelir:

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"]

Yukarıdaki örnekte, görüntüler varsayılan olarak ile root kaldığından, uygulama ikili dosyası olarak rootkopyalanır. Ardından uygulama olarak appyürütülür. Klasör /home/app ayrıca kullanıcıya appaittir ve uygulamaya yazılabilir bir dosya sistemi verir.

Varsayılan yerel ayar

OpenJDK'nin Microsoft Build görüntüleri varsayılan olarak yerel ayar ile en_US.UTF-8 yapılandırılır. Daha önce açıklandığı gibi farklı bir yerel ayar veya farklı bir temel görüntü kullanmak istiyorsanız, ortam değişkenlerini kendi Dockerfile dosyanızda el ile yapılandırmanız ve istediğiniz yerel ayarın yüklendiğinden emin olmanız gerekir.

Örneğin, Ubuntu tabanlı bir görüntüde yerel ayarı kullanmak pt_BR.UTF-8 için Dockerfile'ınıza aşağıdaki satırları ekleyebilirsiniz:

...
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
...

Bu Dockerfile örneği verilmiştir. En uygun yapılandırmaları önermek için tasarlanmamıştır.

Eski ikincil sürümlerde kalın

OpenJDK kapsayıcı görüntülerinin Microsoft Derlemesi yalnızca daha önce listelenen etiketler altında kullanılabilir. İkincil sürümler için etiketler sağlamayız ve geliştiricilerin belirli bir ana sürüm için en son güncelleştirmeye sahip olmasını sağlamak için ana sürüm etiketleri her zaman en son ikincil sürüme sahiptir.

Bu temel görüntüler, JDK paketini yüklemek için Linux dağıtımlarının temel paket yöneticisi mekanizmasını kullanır. Bu nedenle, belirli bir eski sürümde kalmak için veya gibi apt-get yum araçları kullanarak JDK'nin belirli bir ikincil sürümünü yüklemeniz gerekir.

Sağlanan görüntüler listesinin dışındaki farklı temel işletim sistemi görüntülerinde belirli sürümlere geri dönmek için debian:buster-slim, muli aşamalı kapsayıcı görüntüsü derlemesinin ilk aşamasında veya geleneksel linux paketi yükleme akışının bir parçası olarak aşağıdaki yaklaşımı kullanabilirsiniz. Daha fazla bilgi için OpenJDK'nin Microsoft Derlemesini Yükleme'nin Ubuntu 18.04+ üzerine yükleme bölümüne bakın.

RPM/yum tabanlı diğer işletim sistemi görüntüleri için CBL-Mariner bu makalenin devamında sağlanan ayrıntılara bakın.

ve Ubuntudiğer Debian tabanlı görüntüler için, komutları ve çıkışı gösteren aşağıdaki Bash örneğinde gösterildiği gibi, Microsoft Linux depolarında yayımlanan tüm kullanılabilir ikincil sürümleri görüntüleyebilirsiniz. Burada gösterilen komutlar, Microsoft Linux deposunun Ubuntu 18.04+ üzerine yükleme bölümünde açıklandığı gibi yapılandırıldığını varsayar.

$ 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
...

Bu Bash örneğinde görüntünüzün daha eski bir sürüme nasıl döndürülür msopenjdk-11 , örneğin 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 dosyanızda da aynı şeyi yapmak için aşağıdaki komutları kullanın:

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

Bu Bash örneği, temel görüntüleri kullanır 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 dosyanızda da aynı şeyi yapmak için aşağıdaki komutları kullanın:

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

Kapsayıcı görüntüsü yeniden oluşturma zamanlaması

En yüksek güvenlik ve kararlılık düzeyini sağlamak için kapsayıcı görüntülerimiz her Pazartesi, Çarşamba ve Cuma günü yeniden oluşturulur. Bu düzenli yeniden derleme zamanlaması, en son güvenlik düzeltme eklerini ve güncelleştirmeleri hemen eklememizi sağlar.

Bu yeniden derleme zamanlamasından aşağıdaki avantajları bekleyebilirsiniz:

  • Zamanında güvenlik güncelleştirmeleri: Görüntüleri haftada üç kez yeniden oluşturarak yeni güvenlik açıklarının hızla giderilmesini sağlarız.
  • Geliştirilmiş kararlılık: Düzenli güncelleştirmeler, en son hata düzeltmelerini ve iyileştirmeleri ekleyerek uygulamalarınızın kararlılığını ve performansını korumaya yardımcı olur.

Bu güncelleştirmelerle ilgili sorularınız varsa veya sorunlarla karşılaşırsanız destek bileti açmadan önce bu zamanlamaya bakın.

Destek ilkelerimiz hakkında daha fazla bilgi için bkz . OpenJDK'nin Microsoft Derlemesi için destek yol haritası.

Windows tabanlı görüntüler

Şu anda Windows tabanlı kapsayıcı görüntüleri sağlanmıyor.

OpenJDK'nin Microsoft Derlemesi hakkında geri bildirim sağlayın

OpenJDK'nin Microsoft Derlemesi'ni geliştirmemize yardımcı olmak için yorumlarınızı, düşüncelerinizi ve fikirlerinizi bize gönderin. Bize geri bildirim göndermek için GitHub'da OpenJDK tartışmaları sayfamızı ziyaret edin.

Java ve OpenJDK, Oracle’ın ve/veya bağlı kuruluşlarının ticari markaları ya da tescilli ticari markalarıdır.