winamd64/eclipse-temurin

Eclipse Temurin (windows-amd64) Docker镜像文档

1. 镜像概述和主要用途

本镜像为windows-amd64架构的Eclipse Temurin官方镜像，包含由Eclipse Temurin项目构建的OpenJDK二进制文件。Eclipse Temurin项目致力于提供高性能、企业级、跨平台、开源许可且通过Java SE TCK测试的运行时二进制文件及相关技术，适用于Java生态系统的通用场景。

2. 核心功能和特性

2.1 核心功能

• 官方认证的OpenJDK构建：基于Eclipse Temurin项目，提供符合Java SE标准、通过TCK测试的OpenJDK二进制文件。
• 多架构支持：项目整体支持amd64、arm32v7、arm64v8、ppc64le、riscv64、s390x及windows-amd64等架构（本镜像专注于windows-amd64）。
• 灵活的运行时选项：提供JDK（Java开发工具包）和JRE（Java运行时环境）镜像，并支持通过jlink生成自定义精简运行时。
• CA证书集成：支持添加自定义CA证书至JVM信任库及系统CA存储（非Windows镜像）。

3. 使用场景和适用范围

• Java应用开发与测试：作为本地或CI/CD环境的基础镜像，运行Java应用程序。
• 生产环境部署：部署基于Java的服务，利用官方维护的稳定镜像确保运行时可靠性。
• Windows容器环境：适用于需要windows-amd64架构的Windows容器场景（如Windows Server 2016+或Windows 10专业版/企业版）。

4. 支持的标签

由于镜像描述长度限制，完整的标签列表请参见：
https://github.com/docker-library/docs/tree/master/eclipse-temurin/README.md#supported-tags-and-respective-dockerfile-links

5. 详细使用方法和配置说明

5.1 基本使用

5.1.1 通过Dockerfile构建应用镜像

创建包含Java应用的Dockerfile：

dockerfile
FROM winamd64/eclipse-temurin:21  # 使用指定版本的JDK
RUN mkdir /opt/app
COPY japp.jar /opt/app  # 复制应用JAR包到容器内
CMD ["java", "-jar", "/opt/app/japp.jar"]  # 启动应用

构建并运行：

console
docker build -t my-java-app .
docker run -it --rm my-java-app

5.1.2 从基础镜像复制JDK

若需使用自定义基础镜像，可复制本镜像中的JDK：

dockerfile
FROM <自定义基础镜像>  # 例如基于Windows Server Core的镜像
ENV JAVA_HOME=/opt/java/openjdk
COPY --from=winamd64/eclipse-temurin:21 $JAVA_HOME $JAVA_HOME  # 复制JDK目录
ENV PATH="${JAVA_HOME}/bin:${PATH}"  # 添加Java到环境变量

5.2 添加自定义CA证书

非Windows镜像支持添加自定义CA证书至信任库，需通过以下步骤：

1. 挂载证书目录：将包含.crt格式证书的主机目录挂载至容器内/certificates。
2. 启用证书处理：设置环境变量USE_SYSTEM_CA_CERTS为任意值。

示例（Docker CLI）：

console
docker run -v $(pwd)/local-certs:/certificates/ -e USE_SYSTEM_CA_CERTS=1 winamd64/eclipse-temurin:21

注意事项：

• 非root用户运行：无法修改默认JVM信任库及系统CA存储，将自动创建独立信任库并通过JAVA_TOOL_OPTIONS指定路径（路径通过JRE_CACERTS_PATH环境变量导出）。
• 只读文件系统：需挂载可写卷至/tmp以创建新信任库。

5.3 生成自定义JRE运行时

推荐使用jlink工具生成精简的JRE运行时，减少镜像体积。示例Dockerfile（多阶段构建）：

dockerfile
# 阶段1：构建JRE
FROM winamd64/eclipse-temurin:21 as jre-build
RUN $JAVA_HOME/bin/jlink \
         --add-modules java.base \  # 仅包含必要模块（根据应用需求调整）
         --strip-debug \
         --no-man-pages \
         --no-header-files \
         --compress=2 \
         --output /javaruntime

# 阶段2：部署应用
FROM debian:buster-slim  # 或其他基础镜像
ENV JAVA_HOME=/opt/java/openjdk
ENV PATH="${JAVA_HOME}/bin:${PATH}"
COPY --from=jre-build /javaruntime $JAVA_HOME  # 复制自定义JRE

RUN mkdir /opt/app
COPY japp.jar /opt/app
CMD ["java", "-jar", "/opt/app/japp.jar"]

5.4 挂载主机目录

若需将应用JAR包放在主机而非容器内，可通过卷挂载主机目录：

Dockerfile：

dockerfile
FROM winamd64/eclipse-temurin:21.0.2_13-jdk
CMD ["java", "-jar", "/opt/app/japp.jar"]  # 容器内固定路径

运行时挂载主机目录：

console
docker build -t my-java-app .
docker run -it -v C:/path/on/host/jars:/opt/app my-java-app  # Windows主机路径示例

6. 镜像变体

winamd64/eclipse-temurin提供以下变体，适用于不同场景：

6.1 winamd64/eclipse-temurin:<version>

默认镜像，包含完整JDK，适用于开发环境及直接部署Java应用。若不确定需求，推荐使用此变体。

6.2 winamd64/eclipse-temurin:<version>-windowsservercore

基于https://hub.docker.com/r/microsoft/windows-servercore%E7%9A%84%E9%95%9C%E5%83%8F%EF%BC%8C%E4%BB%85%E9%80%82%E7%94%A8%E4%BA%8E%E6%94%AF%E6%8C%81Windows Server Core的环境（如Windows 10专业版/企业版、Windows Server 2016+）。

7. 许可证信息

• Dockerfile及相关脚本：采用Apache License, Version 2.0许可。
• OpenJDK二进制文件：采用GNU GPL v2许可证（含Classpath Exception）。

镜像可能包含其他软件（如基础镜像中的Bash等），其许可证需用户自行确认合规性。更多信息可参考https://github.com/docker-library/repo-info/tree/master/repos/eclipse-temurin%E3%80%82

8. 获取支持和提交Issues

• 支持渠道：Adoptium Slack、https://github.com/adoptium/adoptium-support/issues/new/choose%E3%80%82
• 提交Issues：通过https://github.com/adoptium/containers/issues%E5%8F%8D%E9%A6%88%E3%80%82%E5%AE%89%E5%85%A8%E6%BC%8F%E6%B4%9E%E9%9C%80%E6%8F%90%E4%BA%A4%E8%87%B3%E5%AF%B9%E5%BA%94%E9%A1%B9%E7%9B%AE%EF%BC%88%E5%A6%82Ubuntu%E6%BC%8F%E6%B4%9E%E6%8F%90%E4%BA%A4%E8%87%B3Ubuntu%E5%AE%98%E6%96%B9%EF%BC%89%E3%80%82

9. 镜像元数据与更新

• 元数据详情：https://github.com/docker-library/repo-info/blob/master/repos/eclipse-temurin%EF%BC%88%E5%8C%85%E5%90%AB%E9%95%9C%E5%83%8F%E5%A4%A7%E5%B0%8F%E3%80%81%E4%BC%A0%E8%BE%93%E5%B0%BA%E5%AF%B8%E7%AD%89%EF%BC%89%E3%80%82
• 更新跟踪：https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Feclipse-temurin%E3%80%81https://github.com/docker-library/official-images/commits/master/library/eclipse-temurin%E3%80%82