jore4-tiamat Docker镜像文档

镜像概述

jore4-tiamat是Jore4公共交通规划系统的关键组件，专为赫尔辛基地区交通局（HSL）及相关机构设计。该镜像封装了Tiamat服务，主要负责公共交通网络数据的处理、存储、API接口提供及系统集成，支持交通规划数据的全生命周期管理，是Jore4生态中连接数据层与应用层的核心服务。

核心功能与特性

• 数据处理与存储：支持公共交通线路、站点、时刻表等核心数据的标准化处理与结构化存储
• API服务：提供RESTful API接口，支持交通数据的查询、更新与批量操作
• 系统集成：与Jore4其他组件（如数据导入工具、前端应用）无缝对接，实现数据流转与共享
• 数据验证：内置数据校验机制，确保交通网络数据的准确性与一致性
• 可扩展性：支持水平扩展，通过容器化部署适应不同规模的交通数据处理需求

使用场景与适用范围

• 公共交通管理部门：用于交通规划数据的集中管理与维护
• 开发者集成：供第三方应用或服务调用交通数据API，开发交通相关应用
• Jore4系统部署：作为Jore4完整生态的必要组件，参与交通规划系统的整体部署
• 交通数据研究：为交通规划研究提供标准化数据接口与查询能力

使用方法与配置说明

前提条件

• Docker Engine 20.10+
• Docker Compose 2.0+（如需使用compose部署）
• 网络环境需支持与Jore4其他组件（如数据库、消息队列）的通信

Docker Run部署示例

bash
docker run -d \
  --name jore4-tiamat \
  -p 8080:8080 \
  -e SPRING_PROFILES_ACTIVE=prod \
  -e DB_HOST=jore4-db \
  -e DB_PORT=5432 \
  -e DB_NAME=jore4 \
  -e DB_USER=tiamat \
  -e DB_PASSWORD=secure-password \
  hsldevcom/jore4-tiamat:latest

Docker Compose部署示例

yaml
version: '3.8'
services:
  tiamat:
    image: hsldevcom/jore4-tiamat:latest
    container_name: jore4-tiamat
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=prod
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_NAME=jore4
      - DB_USER=tiamat
      - DB_PASSWORD=${DB_PASSWORD}
      - KAFKA_BOOTSTRAP_SERVERS=kafka:9092
    depends_on:
      - postgres
      - kafka
    restart: unless-stopped

  postgres:
    image: postgres:14
    environment:
      - POSTGRES_DB=jore4
      - POSTGRES_USER=tiamat
      - POSTGRES_PASSWORD=${DB_PASSWORD}
    volumes:
      - postgres-data:/var/lib/postgresql/data

  kafka:
    image: confluentinc/cp-kafka:7.3.0
    environment:
      - KAFKA_ADVERTISED_LISTENERS=PLAINTEXT://kafka:9092
      - KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR=1
    depends_on:
      - zookeeper

  zookeeper:
    image: confluentinc/cp-zookeeper:7.3.0
    environment:
      - ZOOKEEPER_CLIENT_PORT=2181

volumes:
  postgres-data:

环境变量配置

数据持久化

建议通过外部卷挂载或数据库持久化存储交通数据，避免容器重启导致数据丢失。示例中已包含PostgreSQL数据卷配置，实际部署时可根据需求调整存储策略。

健康检查

服务启动后，可通过访问 http://<host>:<port>/actuator/health 检查服务健康状态，返回 UP 表示服务正常运行。