Huny's Dev Blog
huny.dev

Docker에서 Eclipse Temurin 선택하기: JDK·JRE와 ARM64 이미지 확인

Temurin의 JDK와 JRE를 구분하고 멀티스테이지 빌드, ARM64 지원 및 이미지 digest 관리 방법을 정리한다.

Hun Jang
Hun Jang Nov 22, 2026

Java 애플리케이션을 Docker에 담을 때 eclipse-temurin은 OpenJDK 빌드를 제공하는 공식 이미지다. 빌드에는 JDK가 필요하지만 이미 만들어진 JAR을 실행할 때는 JRE 이미지가 선택지가 된다. 버전 숫자만 고르지 말고 기반 OS, CPU 아키텍처와 태그가 바뀌는 범위까지 확인해야 한다.

개발 도구가 포함된 환경과 실행 환경을 컨테이너로 표현한 AI 생성 개념 이미지다.

이 글은 2026년 11월 22일 Adoptium 컨테이너 안내와 Docker 공식 이미지 설명을 확인해 작성했다. 아래 Docker 명령과 Dockerfile은 문서 기반 예시이며 이 실행에서 컨테이너 빌드나 실행을 검증하지 않았다.

Temurin과 OpenJDK는 어떤 관계인가

OpenJDK는 Java 플랫폼의 오픈소스 구현 프로젝트이고, Eclipse Temurin은 Adoptium이 빌드·배포하는 OpenJDK 바이너리다. eclipse-temurin은 이 바이너리를 포함하는 Docker 공식 이미지다. Java 버전이 같다는 이유만으로 서로 다른 배포판과 기반 OS의 패키지, 업데이트 시점, 지원 정책까지 같다고 가정하지 않는다. Adoptium 이미지 설명

태그는 대체로 eclipse-temurin:<Java 버전>-<jdk 또는 jre>-<OS 변형> 형태다. 예를 들어 21-jdk는 Java 21 개발 도구가 포함된 이미지이고, 21-jre는 실행 환경이다. 사용 가능한 태그와 플랫폼은 조합마다 다르므로 Docker Hub 태그 목록을 확인한다.

선택
적합한 단계
확인할 점
JDK
컴파일, 테스트, jlink 등 개발 도구 사용
최종 이미지에 컴파일러가 꼭 필요한가
JRE
이미 빌드된 애플리케이션 실행
진단 도구와 네이티브 의존성이 충분한가
Alpine 변형
해당 환경을 검증한 경우
musl 기반이므로 JNI·네이티브 라이브러리 호환성 확인
기본 Ubuntu 기반
일반적인 시작점
기반 OS 변경 및 보안 업데이트 확인

Adoptium은 대부분의 사용자에게 기본 Ubuntu 기반 이미지를 권장한다. Alpine이 항상 더 작거나 더 안전하다고 단정하지 말고 실제 태그의 크기와 애플리케이션 호환성을 확인한다. Adoptium 안내

빌드 단계와 실행 단계를 분리한다

다음은 Gradle Wrapper와 bootJar 작업을 사용하는 Spring Boot 프로젝트용 설명 예시다. 먼저 실행 가능한 JAR이 build/libs/app.jar라는 이름으로 생성되도록 프로젝트를 설정해야 한다. 해당 이름이 다르면 COPY 경로를 바꾼다.

첫 단계에서 JDK로 빌드하고 두 번째 단계에는 JAR만 복사한다. 프로젝트의 Gradle 버전이 Java 21과 호환되는지, 사설 저장소 인증이나 네이티브 라이브러리가 필요한지 따로 확인한다. 빌드 컨텍스트에 비밀이나 불필요한 파일을 넣지 않도록 .dockerignore도 준비한다. Docker 멀티스테이지 빌드

JRE로 바꾸면 javac 같은 개발 도구가 없을 수 있다. 운영 환경이 JDK 진단 도구에 의존하거나 애플리케이션이 런타임에 컴파일한다면 JDK가 필요할 수 있다. Docker Hub는 jlink로 필요한 모듈을 고른 사용자 정의 런타임도 안내하지만, 누락된 모듈이 런타임 오류로 이어질 수 있으므로 실제 기능과 진단 경로를 테스트해야 한다. 공식 이미지 안내

ARM64와 이미지 변경을 확인한다

ARM 노트북에서 만든 이미지가 x86 서버에서도 실행되어야 한다면 태그 이름만 보고 판단하지 않는다. 아래 명령은 레지스트리의 이미지 인덱스에서 제공 플랫폼을 확인하는 예다. Docker Buildx와 레지스트리 접근이 필요하다.

출력의 linux/amd64와 linux/arm64 항목을 확인한다. 기본 이미지가 두 플랫폼을 지원해도 애플리케이션의 JNI 라이브러리와 빌드 결과물이 모두 호환된다는 뜻은 아니다. 실제 배포할 각 플랫폼에서 기동과 주요 기능을 시험한다. Docker 멀티플랫폼 문서

21-jre 같은 태그는 보안 업데이트나 기반 이미지 변경으로 다른 이미지에 연결될 수 있다. 재현성이 필요하면 확인한 멀티플랫폼 인덱스의 digest를 고정하고, 업데이트를 정기적으로 검토해 새 digest로 교체한다. 고정만 하고 방치하면 보안 수정도 자동 반영되지 않는다. Docker 이미지 고정 지침

배포 전에는 최종 이미지의 java -version, 대상 아키텍처, 인증서·시간대·네이티브 의존성, 정상 종료와 보안 업데이트 절차를 확인한다. 시작 스크립트를 추가할 때 신호 전달이 걱정된다면 Docker 종료 신호가 서버에 닿지 않을 때: ENTRYPOINT와 exec로 SIGTERM 전달하기Docker 종료 신호가 서버에 닿지 않을 때: ENTRYPOINT와 exec로 SIGTERM 전달하기도 참고할 수 있다.

English version: Choosing Eclipse Temurin Docker Images: JDK vs JRE and ARM64 SupportChoosing Eclipse Temurin Docker Images: JDK vs JRE and ARM64 Support

추천 글