Eclipse Temurin está disponible como imagen Docker oficial en Docker Hub, lo que facilita su uso en entornos contenedorizados. Las imágenes se publican para una variedad de sistemas operativos base y arquitecturas.
Imagen recomendada
Para la mayoría de los usuarios, recomendamos la imagen basada en Ubuntu por defecto.
docker pull eclipse-temurin:25-jdk
Para usarla en un Dockerfile para su aplicación:
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 etiquetas
Las etiquetas de imagen siguen este patrón:
eclipse-temurin:<java-version>-<image-type>-<os-version>
Donde:
-
<java-version>— La versión de función de Java (por ejemplo,8,11,17,21,25) -
<image-type>— Ya seajdk(kit de desarrollo completo) ojre(solo entorno de ejecución) -
<os-version>— La variante del SO base (opcional — por defecto la última versión de Ubuntu)
Por ejemplo:
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 operativos base disponibles
Además de la imagen Ubuntu por defecto, las imágenes de Temurin están disponibles en varios otros sistemas operativos base para adaptarse a diferentes necesidades de despliegue.
| SO base | Ejemplo de etiqueta | Caso de uso |
|---|---|---|
Ubuntu (por defecto) |
| Uso general — recomendado para la mayoría de los usuarios. |
Alpine |
| Tamaño de imagen mínimo para despliegues ligeros. Usa |
UBI (Red Hat) |
| Entornos empresariales que requieren compatibilidad con Red Hat Universal Base Image. |
Windows Server Core |
| Cargas de trabajo en contenedores Windows sobre Windows Server. |
Windows Nano Server |
| Imagen mínima de Windows para despliegues ligeros en contenedores Windows. |
Creación de un JRE personalizado con jlink
En OpenJDK 21+, puede usar jlink para crear un entorno de ejecución Java mínimo y personalizado que contenga solo los módulos que necesita su aplicación. Esto produce una imagen mucho más pequeña que usar el 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 los módulos requeridos por su aplicación. Use jdeps para determinar de qué módulos depende su aplicación.
Documentación completa
Para la lista completa de etiquetas soportadas y sus correspondientes Dockerfiles, consulte los enlaces de Etiquetas Soportadas y Dockerfiles Correspondientes.
Para instrucciones de uso detalladas y opciones de configuración adicionales, consulte la página oficial de Eclipse Temurin en Docker Hub.
