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. 支持的标签

由于镜像描述长度限制，完整的标签列表请参见：
Eclipse Temurin官方文档 - 支持的标签

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

5.1 基本使用

5.1.1 通过Dockerfile构建应用镜像

创建包含Java应用的Dockerfile：

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

构建并运行：

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

5.1.2 从基础镜像复制JDK

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

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）：

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（多阶段构建）：

# 阶段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：

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

运行时挂载主机目录：

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

基于Windows Server Core的镜像，仅适用于支持Windows Server Core的环境（如Windows 10专业版/企业版、Windows Server 2016+）。

7. 许可证信息

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

镜像可能包含其他软件（如基础镜像中的Bash等），其许可证需用户自行确认合规性。更多信息可参考repo-info仓库的eclipse-temurin目录。

8. 获取支持和提交Issues

• 支持渠道：Adoptium Slack、Adoptium Support。
• 提交Issues：通过GitHub Issues反馈。安全漏洞需提交至对应项目（如Ubuntu漏洞提交至Ubuntu官方）。

9. 镜像元数据与更新

• 元数据详情：repo-info仓库（包含镜像大小、传输尺寸等）。
• 更新跟踪：official-images仓库标签、更新历史。