BPDM Pool Docker镜像文档

1. 镜像概述与主要用途

1.1 基本信息

• 镜像名称：tractusx/bpdm-pool
• DockerHub地址：[***]
• 所属项目：Eclipse Tractus-X
• 核心组件：BPDM Pool（Business Partner Data Management Pool）

1.2 主要用途

该镜像用于部署Eclipse Tractus-X生态系统中的BPDM Pool服务，作为业务伙伴数据管理（BPDM）的核心组件，提供业务伙伴数据的存储、查询与集成能力，支持供应链中的业务伙伴信息统一管理与跨系统同步。

2. 核心功能与特性

2.1 核心功能

• 业务伙伴数据管理：提供结构化数据存储与高效查询接口，支持业务伙伴基础信息（如名称、联系方式、地址等）的全生命周期管理。
• 跨组件集成：与BPDM生态其他组件（如网关、同步服务）对接，实现业务伙伴数据的流转与一致性维护。
• 合规性支持：遵循Eclipse Tractus-X项目规范，确保与 automotive 行业供应链数据标准的兼容性。

2.2 技术特性

• 轻量级基础：基于Alpine Linux构建，减小镜像体积，优化资源占用。
• 稳定运行时：采用Eclipse Temurin 17 JRE，确保Java应用的稳定运行与安全性。
• 开源透明：源代码托管于GitHub，遵循Apache License 2.0，支持审计与定制化开发。

3. 使用场景与适用范围

3.1 典型使用场景

• 企业业务伙伴数据集中管理：适用于需要统一存储、查询供应商/客户信息的组织。
• Tractus-X生态集成：作为 automotive 供应链数据平台的核心组件，支持跨组织业务伙伴数据共享。
• 微服务架构部署：可独立部署为容器化服务，与现有IT系统集成，提供标准化数据接口。

3.2 适用范围

• 行业领域：主要面向 automotive 行业，也可扩展至其他需业务伙伴数据管理的领域（如制造业、物流）。
• 用户规模：适合中大型企业或组织，需处理大量业务伙伴数据及多系统集成需求。
• 部署环境：支持Docker容器化部署的云环境、本地数据中心或混合架构。

4. 使用方法与配置说明

4.1 镜像获取

从DockerHub拉取最新镜像：

docker pull tractusx/bpdm-pool:latest

4.2 基本运行

默认配置启动容器（需根据实际需求调整端口映射及环境变量）：

docker run -d \
  --name bpdm-pool \
  -p 8080:8080 \  # 映射服务端口（默认8080，可自定义）
  tractusx/bpdm-pool:latest

4.3 高级配置（docker-compose示例）

创建docker-compose.yml，配置环境变量、网络及持久化存储：

version: '3.8'
services:
  bpdm-pool:
    image: tractusx/bpdm-pool:latest
    container_name: bpdm-pool
    restart: always
    ports:
      - "8080:8080"  # 服务端口映射
    environment:
      - SPRING_PROFILES_ACTIVE=prod  # 激活生产环境配置（默认可能为dev）
      - SERVER_PORT=8080             # 服务监听端口
      - DB_URL=jdbc:postgresql://db:5432/bpdm  # 数据库连接URL（示例，需替换为实际地址）
      - DB_USERNAME=bpdm_user        # 数据库用户名
      - DB_PASSWORD=secure_password  # 数据库密码（建议通过 secrets 管理）
    volumes:
      - bpdm-data:/app/data  # 持久化应用数据（如日志、临时文件）
    networks:
      - bpdm-network  # 自定义网络，用于与其他服务（如数据库）通信
    depends_on:
      - db  # 依赖数据库服务（需提前部署，如PostgreSQL/MySQL）

networks:
  bpdm-network:
    driver: bridge

volumes:
  bpdm-data:
    driver: local  # 本地持久化存储

4.4 配置参数说明

核心环境变量（具体参数请参考项目Dockerfile及GitHub文档）：

• SPRING_PROFILES_ACTIVE：激活的Spring配置文件（如prod/dev/test），默认值需参考项目配置。
• SERVER_PORT：服务监听端口，默认8080，可通过此参数修改。
• 数据库配置：DB_URL（数据库连接URL）、DB_USERNAME（用户名）、DB_PASSWORD（密码），需根据后端数据库类型（如PostgreSQL、MySQL）配置。
• 日志配置：LOG_LEVEL（日志级别，如INFO/DEBUG），默认INFO。

4.5 基础镜像信息

本镜像基于以下基础镜像构建：

• 基础镜像：eclipse-temurin:17-jre-alpine
• 运行时：Java 17 JRE（Eclipse Temurin），遵循Adoptium规范。
• 操作系统：Alpine Linux（轻量级发行版，优化容器体积）。
• 更多信息：参考Eclipse Temurin项目文档及镜像说明。

5. 许可证与合规说明

5.1 项目许可证

BPDM Pool项目遵循Apache License, Version 2.0，允许商业使用、修改、分发，但需保留原始许可证声明及免责条款。

5.2 第三方软件说明

镜像包含基础镜像及依赖组件（如Alpine Linux中的Bash、Java运行时等），可能涉及其他开源许可证。用户需自行审查所有包含软件的许可证，确保使用合规。

5.3 合规责任

作为预构建镜像使用者，您有责任确保对镜像的使用符合所有包含软件的许可证要求及相关法律法规。

6. 项目资源

• GitHub仓库：[***]
• 项目主页：[***]
• Pool Dockerfile：[***]