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拉取最新镜像：

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

核心环境变量（具体参数请参考项目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。