O Eclipse Temurin está disponível como imagem Docker oficial no Docker Hub, tornando fácil o uso em ambientes containerizados. As imagens são publicadas para uma variedade de sistemas operacionais base e arquiteturas.
Imagem Recomendada
Para a maioria dos usuários, recomendamos a imagem padrão baseada em Ubuntu.
docker pull eclipse-temurin:25-jdk
Para usar em um Dockerfile para sua aplicação:
FROM eclipse-temurin:25-jdk
COPY target/my-app.jar /app/my-app.jar
WORKDIR /app
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "my-app.jar"]
Esquema de Tags
As tags de imagem seguem este padrão:
eclipse-temurin:<java-version>-<image-type>-<os-version>
Onde:
-
<java-version>— A versão principal do Java (por exemplo,8,11,17,21,25) -
<image-type>— Sejajdk(kit de desenvolvimento completo) oujre(somente runtime) -
<os-version>— A variante do SO base (opcional — padrão é o Ubuntu mais recente)
Por exemplo:
eclipse-temurin:21-jdk # Ubuntu (default) eclipse-temurin:21-jre # Ubuntu JRE (default) eclipse-temurin:21-jdk-noble # Ubuntu 24.04 (Noble) eclipse-temurin:21-jdk-jammy # Ubuntu 22.04 (Jammy) eclipse-temurin:21-jdk-alpine # Alpine Linux eclipse-temurin:21-jdk-ubi9-minimal # Red Hat UBI 9 eclipse-temurin:21-jdk-windowsservercore # Windows Server Core eclipse-temurin:21-jdk-nanoserver # Windows Nano Server
Sistemas Operacionais Base Disponíveis
Além da imagem Ubuntu padrão, as imagens Temurin estão disponíveis em vários outros sistemas operacionais base para atender a diferentes necessidades de implantação.
| SO Base | Exemplo de Tag | Caso de Uso |
|---|---|---|
Ubuntu (padrão) |
| Uso geral — recomendado para a maioria dos usuários. |
Alpine |
| Tamanho mínimo de imagem para implantações leves. Usa |
UBI (Red Hat) |
| Ambientes corporativos que requerem compatibilidade com Red Hat Universal Base Image. |
Windows Server Core |
| Cargas de trabalho de contêiner Windows no Windows Server. |
Windows Nano Server |
| Imagem Windows mínima para implantações de contêiner Windows leves. |
Criando um JRE Personalizado com jlink
No OpenJDK 21+, você pode usar jlink para criar um runtime Java mínimo personalizado
contendo apenas os módulos necessários para sua aplicação. Isso produz uma imagem muito
menor do que usar o JDK completo.
# Example of custom Java runtime using jlink in a multi-stage container build
FROM eclipse-temurin:25 as jre-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
FROM debian:buster-slim
ENV JAVA_HOME=/opt/java/openjdk
ENV PATH "${JAVA_HOME}/bin:${PATH}"
COPY --from=jre-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"]
Tip
--add-modules para incluir todos os módulos necessários para
sua aplicação. Use jdeps para determinar de quais módulos sua aplicação depende.
Documentação Completa
Para a lista completa de tags suportadas e seus Dockerfiles correspondentes, consulte os Tags Suportadas e Links de Dockerfile Correspondentes.
Para instruções detalhadas de uso e opções adicionais de configuração, consulte a página oficial Eclipse Temurin no Docker Hub.
