hsldevcom/opentripplanner-data-container-waltti-alt

OpenTripPlanner 数据容器镜像文档

镜像概述

OpenTripPlanner-data-container 是 OpenTripPlanner (OTP) 生态系统的官方数据容器，专门用于存储和管理 OTP 出行规划服务运行所需的地理空间数据。该镜像为 OTP 服务提供标准化的数据存储结构，支持公共交通数据（GTFS）、街道地图数据（OSM）等核心数据集的集成、验证与版本管理，简化 OTP 服务部署流程中的数据准备工作。

核心功能与特性

数据管理能力

• 结构化存储：采用标准化目录结构组织 GTFS（公共交通时刻表与路线数据）、OSM（开放街道地图基础地理数据）等 OTP 必需的输入数据。
• 数据验证：内置基础数据验证工具，可自动检查 GTFS 数据格式合规性（如必填字段、时间逻辑）和 OSM 数据完整性，减少因数据错误导致的 OTP 服务异常。
• 版本管理：支持多版本数据并存，可通过目录或环境变量指定特定版本数据，便于服务升级或回滚时的数据切换。

部署与集成优势

• 轻量级设计：基于 Alpine 或 Debian 精简镜像构建，最小化资源占用，适合容器化部署环境。
• 无缝集成：与 OTP 服务容器（opentripplanner 镜像）通过数据卷或网络共享实现数据联动，支持动态数据更新。
• 配置灵活：支持通过环境变量或配置文件自定义数据路径、下载源和更新周期，适应不同规模的部署需求。

使用场景

• 公共交通规划系统：为城市公共交通管理部门提供标准化数据容器，支撑 OTP 后端服务实现实时/离线出行规划。
• 多模式出行应用：作为出行类 App 后端的数据底座，存储公交、地铁、步行、骑行等多模式出行数据。
• 交通数据分析平台：为交通研究机构提供结构化的 GTFS/OSM 数据存储方案，便于基于历史数据进行交通行为分析。
• OTP 开发与测试：开发者可快速搭建包含标准测试数据的本地环境，验证 OTP 功能或自定义算法。

使用方法与配置说明

前提条件

• 已安装 Docker Engine（20.10+）或 Docker Desktop。
• 具备 GTFS 数据文件（.zip）或 OSM 数据文件（.pbf），或可访问公开数据下载 URL。

获取镜像

从 Docker Hub 或 GitHub Container Registry 获取官方镜像：

bash
docker pull docker.xuanyuan.run/hsldevcom/opentripplanner-data-container:latest

基础使用（Docker Run）

1. 本地数据挂载模式

将本地 GTFS/OSM 数据目录挂载到容器，供 OTP 服务读取：

bash
docker run -d \
  --name otp-data \
  -v /path/to/local/data:/data \  # 本地数据目录（需包含 gtfs/ 和 osm/ 子目录）
  -e DATA_REGION=eu-west-1 \      # 可选：指定数据区域（用于日志和版本标记）
  -e LOG_LEVEL=info \             # 可选：日志级别（debug/info/warn/error）
  hsldevcom/opentripplanner-data-container:latest

说明：本地数据目录需按规范组织，例如：

/path/to/local/data/
  ├── gtfs/          # GTFS 数据目录，存放 *.zip 文件
  │   ├── city-bus.zip
  │   └── metro.zip
  └── osm/           # OSM 数据目录，存放 *.pbf 文件
      └── city.osm.pbf

2. 远程数据下载模式

通过环境变量指定 GTFS/OSM 数据下载 URL，容器启动时自动下载并解压数据：

bash
docker run -d \
  --name otp-data \
  -e GTFS_URL=https://example.com/gtfs/city-bus.zip \  # GTFS 数据下载 URL
  -e OSM_URL=https://example.com/osm/city.osm.pbf \    # OSM 数据下载 URL
  -e DATA_PATH=/data \                                 # 容器内数据存储路径（默认 /data）
  hsldevcom/opentripplanner-data-container:latest

与 OTP 服务容器联动（Docker Compose）

通过 docker-compose.yml 定义数据容器与 OTP 服务容器的联动，实现一键部署：

yaml
version: '3.8'
services:
  otp-data:
    image: docker.xuanyuan.run/hsldevcom/opentripplanner-data-container:latest
    volumes:
      - otp-data-volume:/data  # 持久化数据卷
    environment:
      - GTFS_URL=https://transitfeeds.com/p/example/1234/latest/download
      - OSM_URL=https://download.geofabrik.de/europe/germany/berlin-latest.osm.pbf
      - AUTO_UPDATE=true       # 启用每日自动数据更新（默认 false）
      - UPDATE_TIME=03:00      # 自动更新时间（UTC，默认 02:00）

  otp-service:
    image: docker.xuanyuan.run/opentripplanner:latest
    depends_on:
      - otp-data
    ports:
      - "8080:8080"
    volumes_from:
      - otp-data  # 共享数据卷，直接访问 /data 目录
    command: --basePath /data --server

volumes:
  otp-data-volume:  # 持久化数据卷，避免容器重启后数据丢失

环境变量配置

数据目录结构

容器内 DATA_PATH 目录默认结构如下（自动创建）：

/data/
├── gtfs/          # GTFS 数据目录（存放下载或挂载的 *.zip 文件）
├── osm/           # OSM 数据目录（存放下载或挂载的 *.pbf 文件）
├── logs/          # 数据下载、验证、更新日志
└── versions/      # 历史版本数据备份（仅当启用版本管理时）

数据更新与维护

• 手动触发更新：进入容器执行数据更新脚本

  bash
  docker exec -it otp-data /scripts/update-data.sh
  

• 查看数据状态：检查数据验证结果和版本信息

  bash
  docker exec -it otp-data /scripts/check-data-status.sh
  

• 清理历史版本：保留最近 3 个版本数据（需启用版本管理）

  bash
  docker exec -it otp-data /scripts/clean-versions.sh --keep 3