tractusx/bpdm-pool

BPDM Pool Docker镜像文档

1. 镜像概述与主要用途

1.1 基本信息

• 镜像名称：tractusx/bpdm-pool
• DockerHub地址：https://hub.docker.com/r/tractusx/bpdm-pool
• 所属项目：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拉取最新镜像：

bash
docker pull tractusx/bpdm-pool:latest

4.2 基本运行

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

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

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

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

yaml
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 配置参数说明

核心环境变量（具体参数请参考https://github.com/eclipse-tractusx/bpdm/blob/main/docker/pool/Dockerfile%E5%8F%8AGitHub%E6%96%87%E6%A1%A3%EF%BC%89%EF%BC%9A

• 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 基础镜像信息

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

• 基础镜像：https://hub.docker.com/_/eclipse-temurin
• 运行时：Java 17 JRE（Eclipse Temurin），遵循Adoptium规范。
• 操作系统：Alpine Linux（轻量级发行版，优化容器体积）。
• 更多信息：参考Eclipse Temurin项目文档及https://github.com/docker-library/repo-info/tree/master/repos/eclipse-temurin%E3%80%82

5. 许可证与合规说明

5.1 项目许可证

BPDM Pool项目遵循https://github.com/eclipse-tractusx/bpdm/blob/main/LICENSE%EF%BC%8C%E5%85%81%E8%AE%B8%E5%95%86%E4%B8%9A%E4%BD%BF%E7%94%A8%E3%80%81%E4%BF%AE%E6%94%B9%E3%80%81%E5%88%86%E5%8F%91%EF%BC%8C%E4%BD%86%E9%9C%80%E4%BF%9D%E7%95%99%E5%8E%9F%E5%A7%8B%E8%AE%B8%E5%8F%AF%E8%AF%81%E5%A3%B0%E6%98%8E%E5%8F%8A%E5%85%8D%E8%B4%A3%E6%9D%A1%E6%AC%BE%E3%80%82

5.2 第三方软件说明

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

5.3 合规责任

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

6. 项目资源

• GitHub仓库：https://github.com/eclipse-tractusx/bpdm
• 项目主页：[***]
• Pool Dockerfile：https://github.com/eclipse-tractusx/bpdm/blob/main/docker/pool/Dockerfile