spbc/hybris

Specialized Bicycle Components Hybris Docker镜像文档

1. 镜像概述

本镜像为Specialized Bicycle Components（以下简称"SBC"）专用的SAP Hybris电商平台容器化解决方案，基于SAP官方Hybris版本构建并针对SBC自行车零部件业务场景进行优化。旨在通过容器化技术简化Hybris应用的部署流程、统一运行环境，提升SBC相关业务系统（如产品管理、订单处理、库存管理等）的开发、测试及生产环境一致性。

2. 核心功能与特性

• 业务定制化：针对SBC自行车零部件业务需求预配置相关组件，适配产品分类、属性管理及供应链集成场景。
• 容器化部署简化：集成Hybris运行所需的基础依赖（如JDK、应用服务器等），无需手动配置底层环境。
• 环境一致性：确保开发、测试、生产环境配置统一，减少"环境差异"导致的部署问题。
• 版本稳定：基于特定Hybris版本构建，版本信息明确，便于版本追溯和升级管理。
• 灵活配置：支持通过环境变量或外部配置文件自定义Hybris参数（如数据库连接、端口、日志级别等）。

3. 使用场景与适用范围

• 开发环境：供开发团队快速搭建本地Hybris开发环境，无需手动安装和配置完整Hybris套件。
• 测试环境：用于自动化测试或QA验证，确保测试环境与生产环境配置一致。
• 生产环境：作为SBC自行车零部件电商系统的生产部署载体，支持高可用集群配置。

4. 使用方法与配置说明

4.1 基础运行（docker run）

bash
docker run -d \
  --name sbc-hybris \
  -p 9001:9001 \  # Hybris后台管理端口
  -p 9002:9002 \  # Hybris前端应用端口
  -e DB_HOST=mysql-host \
  -e DB_PORT=3306 \
  -e DB_USER=hybris_user \
  -e DB_PASSWORD=hybris_password \
  -v /path/to/local/config:/opt/hybris/config \  # 挂载外部配置文件
  specialized-bicycle-components/hybris:latest

4.2 环境变量配置

4.3 持久化配置

建议通过外部挂载目录持久化Hybris配置文件、日志及数据：

• /opt/hybris/config：Hybris核心配置文件目录（如local.properties）
• /opt/hybris/log：应用日志目录
• /opt/hybris/data：数据存储目录（如媒体文件、缓存等）

示例（挂载多目录）：

bash
docker run -d \
  --name sbc-hybris \
  -p 9001:9001 -p 9002:9002 \
  -e DB_HOST=mysql-host \
  -e DB_USER=hybris_user \
  -e DB_PASSWORD=secure_password \
  -v /local/config:/opt/hybris/config \
  -v /local/log:/opt/hybris/log \
  -v /local/data:/opt/hybris/data \
  specialized-bicycle-components/hybris:latest

4.4 Docker Compose配置示例

yaml
version: '3.8'
services:
  hybris:
    image: specialized-bicycle-components/hybris:latest
    container_name: sbc-hybris
    ports:
      - "9001:9001"
      - "9002:9002"
    environment:
      - DB_HOST=mysql
      - DB_PORT=3306
      - DB_USER=hybris
      - DB_PASSWORD=hybris_password
      - HYBRIS_MODE=prod
      - MEMORY_XMX=8g
    volumes:
      - ./config:/opt/hybris/config
      - ./log:/opt/hybris/log
      - ./data:/opt/hybris/data
    depends_on:
      - mysql

  mysql:
    image: mysql:5.7
    container_name: sbc-hybris-mysql
    environment:
      - MYSQL_ROOT_PASSWORD=root_password
      - MYSQL_DATABASE=hybris
      - MYSQL_USER=hybris
      - MYSQL_PASSWORD=hybris_password
    volumes:
      - mysql-data:/var/lib/mysql

volumes:
  mysql-data:

5. 注意事项

• 首次启动时，Hybris会执行初始化流程（如数据库表创建、数据导入），耗时较长，请耐心等待。
• 生产环境建议配合负载均衡器使用，并启用数据卷备份策略，防止数据丢失。
• 如需升级Hybris版本，请先备份现有配置和数据，再通过新版本镜像重新部署。