Eclipse Tractus-X BPN DID解析服务 (BDRS) Docker镜像文档

镜像概述与主要用途

本镜像为Eclipse Tractus-X项目中的BPN DID解析服务（BDRS，BPN DID Resolution Service） 提供容器化部署支持。BDRS核心功能是解析与BPN（Business Partner Number，业务伙伴编号）关联的DID（Decentralized Identifier，去中心化标识符），为供应链场景下的业务伙伴身份验证、信息查询提供标准化的标识符解析能力。

核心功能与特性

• BPN-DID解析：支持对BPN关联的DID进行解析，返回关联的身份元数据。
• API访问控制：通过API密钥认证机制（EDC_API_AUTH_KEY）保障服务访问安全性。
• 轻量级运行时：基于Alpine JRE基础镜像，资源占用低，适合容器化环境部署。
• 可观测性集成：内置OpenTelemetry Agent，支持分布式追踪数据采集。

使用场景与适用范围

适用于需要解析BPN相关DID的企业级场景，包括但不限于：

• 供应链管理系统中的业务伙伴身份验证
• 跨组织数据共享中的身份标识解析
• 合规审计中的业务伙伴身份追溯
• 基于DID的分布式身份体系构建

使用方法与配置说明

基础部署命令

docker run -p 8181:8181 -p 8282:8282 -e EDC_API_AUTH_KEY="your-secure-api-key" eclipse-tractusx/bpn-did-resolution-service:latest

参数说明

端口映射

• 8181:8181：服务主API端口，用于接收DID解析请求。
• 8282:8282：管理/监控端口（具体功能取决于服务配置）。

环境变量

自定义配置（可选）

如需挂载外部配置文件（如调整日志级别、连接超时等），可通过-v参数挂载配置目录至容器内指定路径（具体路径需参考服务配置文档）：

docker run -p 8181:8181 -p 8282:8282 \
  -e EDC_API_AUTH_KEY="your-secure-api-key" \
  -v /host/path/to/config:/app/config \
  eclipse-tractusx/bpn-did-resolution-service:latest

基础镜像信息

本镜像基于以下基础镜像构建：
eclipse-temurin:24.0.1_9-jre-alpine

• DockerHub地址：[***]
• 项目主页：Eclipse Temurin Project
• 镜像详情：Docker Library Repo Info

第三方软件

镜像中包含以下第三方组件：

OpenTelemetry Agent v1.32.0

• 用途：分布式追踪数据采集，支持与Jaeger、Zipkin等可观测性平台集成。
• 官方发布页：[***]

许可证信息

主项目许可证

BDRS服务遵循 Apache License, Version 2.0。

第三方软件与基础镜像

本镜像包含基础分发版（如Bash等）及直接/间接依赖的第三方软件，可能涉及其他许可证。使用前请确保符合所有包含软件的许可证要求，用户需自行承担合规责任。