Microsoft Build of OpenJDK용 컨테이너 이미지
- 아티클
- 2023. 03. 29.
이 문서의 내용
이 문서에서는 Microsoft Build of OpenJDK에 사용할 수 있는 컨테이너 이미지에 대한 정보를 제공합니다.
Linux 기반 이미지
현재 Ubuntu 20.04 및 Microsoft CBL-Mariner에 대한 Linux 기반 컨테이너 이미지를 제공합니다. 이미지는 에 있는 Microsoft Container Registry 에 mcr.microsoft.com/openjdk/jdk게시됩니다.
특정 태그에 대한 최신 이미지를 끌어오려면 다음 명령을 사용합니다.
docker pull mcr.microsoft.com/openjdk/jdk:<tag>
다음 표에서는 Linux 배포 및 JDK 버전에 사용할 태그를 보여줍니다.
| Ubuntu 22.04 | 21-ubuntu | 17-ubuntu | 11-ubuntu | 해당 사항 없음 |
| CBL 마리너 2.0 | 21-mariner | 17-mariner | 11-mariner | 8-mariner |
| CBL 마리너 1.0 | 해당 사항 없음 | 17-mariner-cm1 | 11-mariner-cm1 | 해당 사항 없음 |
| CBL-Mariner 2.0 배포판 | 21-distroless | 17-distroless | 11-distroless | 8-distroless |
참고:Eclipse Adoptium 프로젝트의 Eclipse Temurin 이진 파일과 함께 OpenJDK 8용 이미지가 제공됩니다.
아키텍처
위의 이미지는 및 arm64 아키텍처 모두 amd64 에 대해 제공됩니다. 컨테이너 런타임은 환경에 따라 올바른 이미지를 끌어와야 합니다. 특정 아키텍처에 대해 이미지를 강제로 끌어오려면 다음을 사용합니다.
$ docker pull --platform=linux/arm64 mcr.microsoft.com/openjdk/jdk:17-mariner
내에서 아키텍처를 Dockerfile강제로 적용하려면 다음을 사용할 수 있습니다.
FROM --platform=linux/arm64 mcr.microsoft.com/openjdk/jdk:17-mariner AS build
# ...
다중 플랫폼 컨테이너 이미지를 빌드하는 방법에 대한 자세한 내용은 컨테이너 런타임 설명서를 검사. 예를 들어 Docker 및 Podman입니다.
이러한 이미지를 사용하는 방법
다음 내용으로 Dockerfile을 만듭니다.
# Example using MS Build of OpenJDK image directly
FROM mcr.microsoft.com/openjdk/jdk:17-ubuntu
# Continue with your application deployment
RUN mkdir /opt/app
COPY japp.jar /opt/app
CMD ["java", "-jar", "/opt/app/japp.jar"]
배포판 없는
배포판 없는 이미지는 Microsoft의 CBL-Mariner 2.0 배포를 기반으로 합니다. 애플리케이션을 배포하려면 다른 접근 방식이 필요합니다. 배포판이 없는 이미지에는 전체 Linux 배포판이 포함되어 있지 않으므로 셸이 없습니다. 예를 들면 다음과 같습니다.
ENTRYPOINT 이러한 이미지의 는 이미 명령을 가리키도록 구성되어 있습니다java. Dockerfiles를 사용하는 경우 명령을 사용하여 CMD JVM 시작 관리자 프로세스의 명령줄 인수를 완료해야 합니다.
다음 내용으로 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를 복사할 수 있습니다.
# 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-17-amd64
ENV PATH "${JAVA_HOME}/bin:${PATH}"
COPY --from=mcr.microsoft.com/openjdk/jdk:17-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"]
또는 를 apt-get사용 yum 하거나 파일을 추출하고 그에 따라 구성 JAVA_HOME 하기만 하면 JDK를 tar.gz 설치할 수도 있습니다. 자세히 알아봅니다.
알파인 이미지
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:17-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-17-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:17-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 패키지를 설치합니다. 따라서 특정 버전을 유지하려면 또는 yum 와 같은 apt-get 도구를 사용하여 특정 부 버전의 JDK를 설치해야 합니다.
다른 기본 OS 이미지(예 debian:buster-slim: )에 특정 버전을 설치하려면 뮬리 스테이지 컨테이너 이미지 빌드의 첫 번째 단계에서 또는 기존 Linux 패키지 설치 흐름의 일부로 동일한 접근 방식을 사용할 수 있습니다. 자세한 내용은 Microsoft Build of OpenJDK설치의 Ubuntu 18.04 이상에 설치 섹션을 참조하세요.
CBL-Mariner RPM/yum을 기반으로 하는 및 기타 OS 이미지는 이 문서의 뒷부분에 제공된 세부 정보를 참조하세요.
및 기타 Debian 기반 이미지의 경우 Ubuntu명령 및 출력을 보여 주는 다음 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.15+10-LTS-1 | https://packages.microsoft.com/ubuntu/20.04/prod focal/main amd64 Packages
msopenjdk-11 | 11.0.14.1+1-LTS-31205 | https://packages.microsoft.com/ubuntu/20.04/prod focal/main amd64 Packages
msopenjdk-11 | 11.0.14+9-LTS-1 | https://packages.microsoft.com/ubuntu/20.04/prod focal/main amd64 Packages
msopenjdk-11 | 11.0.13+8-LTS-1 | https://packages.microsoft.com/ubuntu/20.04/prod focal/main amd64 Packages
msopenjdk-11 | 11.0.12+7-1 | https://packages.microsoft.com/ubuntu/20.04/prod focal/main amd64 Packages
msopenjdk-11 | 11.0.11+9-1 | https://packages.microsoft.com/ubuntu/20.04/prod focal/main amd64 Packages
msopenjdk-11 | 11.0.10+9-1 | https://packages.microsoft.com/ubuntu/20.04/prod focal/main amd64 Packages
이 Bash 예제에서는 이미지를 이전 버전으로 되돌리기 msopenjdk-11 방법을 보여 있습니다. 예를 들면 다음과 같습니다11.0.11+9-1.
root@dd24eca5bdb3:/# 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@dd24eca5bdb3:/# apt-cache madison msopenjdk-11
msopenjdk-11 | 11.0.15+10-LTS-1 | https://packages.microsoft.com/ubuntu/20.04/prod focal/main amd64 Packages
msopenjdk-11 | 11.0.14.1+1-LTS-31205 | https://packages.microsoft.com/ubuntu/20.04/prod focal/main amd64 Packages
msopenjdk-11 | 11.0.14+9-LTS-1 | https://packages.microsoft.com/ubuntu/20.04/prod focal/main amd64 Packages
msopenjdk-11 | 11.0.13+8-LTS-1 | https://packages.microsoft.com/ubuntu/20.04/prod focal/main amd64 Packages
msopenjdk-11 | 11.0.12+7-1 | https://packages.microsoft.com/ubuntu/20.04/prod focal/main amd64 Packages
msopenjdk-11 | 11.0.11+9-1 | https://packages.microsoft.com/ubuntu/20.04/prod focal/main amd64 Packages
msopenjdk-11 | 11.0.10+9-1 | https://packages.microsoft.com/ubuntu/20.04/prod focal/main amd64 Packages
root@dd24eca5bdb3:/# apt-get -y install -y --allow-downgrades msopenjdk-11=11.0.11+9-1
Reading package lists... Done
Building dependency tree
Reading state information... Done
The following packages will be DOWNGRADED:
msopenjdk-11
0 upgraded, 0 newly installed, 1 downgraded, 0 to remove and 17 not upgraded.
Need to get 193 MB of archives.
After this operation, 353 kB disk space will be freed.
Get:1 https://packages.microsoft.com/ubuntu/20.04/prod focal/main amd64 msopenjdk-11 amd64 11.0.11+9-1 [193 MB]
Fetched 193 MB in 6s (30.9 MB/s)
debconf: delaying package configuration, since apt-utils is not installed
dpkg: warning: downgrading msopenjdk-11 from 11.0.14+9-LTS-1 to 11.0.11+9-1
(Reading database ... 5936 files and directories currently installed.)
Preparing to unpack .../msopenjdk-11_11.0.11+9-1_amd64.deb ...
Unpacking msopenjdk-11 (11.0.11+9-1) over (11.0.14+9-LTS-1) ...
Setting up msopenjdk-11 (11.0.11+9-1) ...
Dockerfile에서 동일한 작업을 수행하려면 다음 명령을 사용합니다.
FROM mcr.microsoft.com/openjdk/jdk:11-ubuntu
...
RUN apt-get update && \
apt-get install -y --allow-downgrades msopenjdk-11=11.0.11+9-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.10+9-1
Loaded plugin: tdnfrepogpgcheck
Downgrading:
msopenjdk-11 x86_64 11.0.10+9-1 packages-microsoft-com-prod 308.38M 323358496
Total installed size: 308.38M 323358496
Downloading:
Testing transaction
Running transaction
Installing/Updating: msopenjdk-11-11.0.10+9-1.x86_64
Removing: msopenjdk-11-11.0.12+7-1.x86_64
Complete!
Dockerfile에서 동일한 작업을 수행하려면 다음 명령을 사용합니다.
FROM mcr.microsoft.com/openjdk/jdk:11-mariner
...
RUN yum update && \
yum install -y --nogpgcheck msopenjdk-11-11.0.10+9-1
...
Windows 기반 이미지
현재 Windows 기반 컨테이너 이미지는 제공하지 않습니다.
Microsoft Build of OpenJDK에 대한 피드백 제공
Microsoft Build of OpenJDK를 개선하는 데 도움이 되는 의견, 생각 및 아이디어를 보내주세요. GitHub의 OpenJDK 토론 페이지를 방문하여 피드백을 보내주세요.
Java 및 OpenJDK는 Oracle 및/또는 해당 계열사의 상표 또는 등록 상표입니다.
'[Microsoft]' 카테고리의 다른 글
| Java 11 이상으로 이동하는 이유 (2) | 2023.12.07 |
|---|---|
| OpenJDK LTS 빌드의 최신 업데이트에 대한 URL (1) | 2023.12.07 |
| OpenJDK의 Microsoft 빌드 정보 (1) | 2023.12.07 |
| Microsoft Build of OpenJDK 다운로드 (1) | 2023.12.07 |
| 오류 검사 코드 참조(Bug Check Code Reference) (2) | 2023.12.06 |
