OpenZipkin Java Docker镜像文档

镜像概述和主要用途

ghcr.io/openzipkin/java是基于azul/zulu-openjdk-alpine的最小化Docker镜像。该镜像由OpenZipkin项目维护，托管于GitHub Container Registry。每个版本提供两种标签：以-jre结尾的标签为最小化构建，仅包含Zipkin相关镜像所需的核心Java模块；未限定的标签则是完整JDK环境，额外包含Maven构建工具。

核心功能和特性

• 轻量级基础：基于Alpine Linux构建，确保镜像体积小巧，资源占用低
• 双版本标签：
  • -jre：最小化JRE环境，仅包含Zipkin相关应用运行所需的必要Java模块
  • 无后缀标签：完整JDK环境，包含Maven工具，支持代码编译构建
• 版本精确匹配：严格对应上游Zulu OpenJDK的特定版本，确保运行环境一致性

使用场景和适用范围

• 适用于需要轻量级Java运行环境的容器化部署场景
• -jre标签适合Zipkin相关微服务的生产环境部署
• 无后缀标签适合包含编译构建步骤的开发环境或CI/CD流水线

使用方法和配置说明

构建参数说明

构建步骤

1. 获取Zulu OpenJDK版本标签：访问Zulu OpenJDK Alpine标签页查找Java 15的最新特定版本标签
2. 构建镜像：

   bash
   docker build -t openzipkin/java:自定义标签 --build-arg zulu_tag=获取的版本标签 .
   

   示例：

   bash
   docker build -t openzipkin/java:test-jre --build-arg zulu_tag=15.0.0-15.27.17 .
   

镜像验证

构建完成后，需验证镜像版本与指定的zulu_tag是否匹配：

bash
docker run --rm openzipkin/java:test-jre -version

预期输出示例：

openjdk version "15" 2020-09-15
OpenJDK Runtime Environment Zulu15.27+17-CA (build 15+36)
OpenJDK 64-Bit Server VM Zulu15.27+17-CA (build 15+36, mixed mode)

输出中的Zulu15.27+17-CA应与构建时使用的zulu_tag=15.0.0-15.27.17对应。

发布流程

1. 确认本地构建的镜像版本验证通过
2. 推送与zulu_tag同名的标签到项目仓库（例如15.0.0-15.27.17）
3. 该标签会触发Travis CI自动构建任务，完成后将镜像推送至GitHub Container Registry

维护建议

上游Zulu OpenJDK仓库每月发布一次更新。维护者可通过以下方式跟踪更新：

• 关注Zulu OpenJDK仓库（[] Request
• 每月底手动检查Zulu OpenJDK Alpine标签页确认最新版本