datadog/dd-trace-java-docker-build

dd-trace-java-docker-build 镜像文档

1. 镜像概述和主要用途

dd-trace-java-docker-build 是用于构建 Java APM 追踪器（Tracer）的 Docker 镜像，主要为 https://github.com/datadog/dd-trace-java 项目的持续集成（CI）作业提供环境支持，确保在统一、标准化的容器环境中完成 Java APM 追踪器的构建流程。

2. 核心功能和特性

2.1 多 JDK 版本支持

提供多种镜像变体，包含不同版本及类型的 JDK，满足多样化构建需求：

• 基础变体（base）：包含 Eclipse Temurin JDK，提供 8、11、17、21 四个子变体（分别对应 JDK 8、11、17、21 版本），base 为基础标识，其子变体可通过别名直接引用（如 base:8 等同于 8）。
• 特定 JDK 变体：在基础 JDK 之上，额外包含特定类型 JDK，包括 zulu8、zulu11、oracle8、ibm8、semeru8、semeru11、semeru17、graalvm17、graalvm21（名称中的数字表示 JDK 版本）。
• 全量变体（latest）：集成基础变体及所有特定 JDK 变体，包含上述所有 JDK 版本及类型。

3. 使用场景和适用范围

• 核心场景：dd-trace-java 项目的持续集成作业，用于自动化构建 Java APM 追踪器。
• 扩展场景：需构建 Java APM 追踪器且依赖多版本/多类型 JDK 的开发或 CI 环境，可通过该镜像统一构建环境，避免环境差异导致的构建问题。

4. 使用方法和配置说明

4.1 获取预构建镜像

预构建镜像托管于 https://github.com/DataDog/dd-trace-java-docker-build/pkgs/container/dd-trace-java-docker-build%EF%BC%8C%E5%8F%AF%E7%9B%B4%E6%8E%A5%E6%8B%89%E5%8F%96%E4%BD%BF%E7%94%A8%E3%80%82

拉取命令示例

• 拉取基础变体（以 JDK 11 为例）：

  bash
  docker pull ghcr.io/datadog/dd-trace-java-docker-build:base:11
  # 或通过别名简化
  docker pull ghcr.io/datadog/dd-trace-java-docker-build:11
  

• 拉取特定 JDK 变体（以 GraalVM 17 为例）：

  bash
  docker pull ghcr.io/datadog/dd-trace-java-docker-build:graalvm17
  

• 拉取全量变体（包含所有 JDK）：

  bash
  docker pull ghcr.io/datadog/dd-trace-java-docker-build:latest
  

4.2 开发环境构建与测试

若需本地开发或自定义构建镜像，可通过项目脚本完成。

构建所有镜像

bash
./build

验证构建结果

构建完成后，可通过测试命令检查镜像是否构建成功：

bash
./build --test