linusmotu/fixed-line-transit-2.0-backend

fixed-line-transit-2.0-backend（Docker镜像）

WeGo Transit IDSS调度控制台的后端镜像，单镜像支持三种运行模式，可通过覆盖容器命令选择模式，同时支持运行初始化数据库、加载GTFS等一次性任务。

核心功能

快速启动API

bash
docker run --rm -p 8000:8000 \
  --env-file .env \
  -e TIMEZONE=America/Chicago \
  -e DATABASE_URL='postgresql+psycopg://user:pass@your-db-host:5432/transit_db' \
  -e SWIFTLY_API_KEY=<your-key> \
  -e SWIFTLY_AGENCY=nashville \
  linusmotu/fixed-line-transit-2.0-backend:latest

# 验证健康状态
curl -fsS http://localhost:8000/health
# → {"status":"healthy","database":"connected","timestamp":...}

数据库要求

需使用PostgreSQL 18 + PostGIS 3.6扩展（或兼容版本），因为多个表使用空间列（geography(Point,4326)）和PostGIS函数。

本地开发

通过docker-compose启动符合要求的PostgreSQL：

yaml
db:
  image: postgis/postgis:18-3.6

bash
docker compose -f docker/docker-compose.yml --env-file .env up -d

注意：在Mac/Windows上，若PostgreSQL运行在宿主机，需将POSTGRES_HOST设为host.docker.internal；Linux环境可使用--network host或宿主机IP。

生产环境

• Amazon RDS for PostgreSQL：需先在目标数据库执行CREATE EXTENSION postgis;
• 自托管PostGIS：使用postgis/postgis:18-3.6镜像

环境变量配置

必填变量

生产推荐变量

首次设置步骤

1. 初始化数据库 schema 和默认策略

bash
docker run --rm \
  -e TIMEZONE=America/Chicago \
  -e DATABASE_URL='postgresql+psycopg://user:pass@your-db-host:5432/transit_db' \
  linusmotu/fixed-line-transit-2.0-backend:latest \
  python bin/init_db.py -y

-y跳过交互确认，--keep-data保留现有数据。

2. 加载GTFS数据

需挂载本地GTFS文件目录：

bash
docker run --rm \
  -e TIMEZONE=America/Chicago \
  -e DATABASE_URL='postgresql+psycopg://user:pass@your-db-host:5432/transit_db' \
  -v "$(pwd)/data:/app/data:ro" \
  linusmotu/fixed-line-transit-2.0-backend:latest \
  python bin/load_gtfs.py data/gtfs/google_transit.zip --routes 55,56,20 --service all --promote

3. 同步Alembic状态（可选）

bash
docker run --rm \
  -e DATABASE_URL='postgresql+psycopg://...' \
  linusmotu/fixed-line-transit-2.0-backend:latest \
  alembic stamp head

运行工作者

车辆工作者

bash
docker run -d --restart unless-stopped \
  --name flt-vehicles \
  -e TIMEZONE=America/Chicago \
  -e DATABASE_URL='postgresql+psycopg://...' \
  -e SWIFTLY_API_KEY=<key> \
  -e SWIFTLY_AGENCY=nashville \
  -e MONITORED_ROUTES=55,56,20 \
  linusmotu/fixed-line-transit-2.0-backend:latest \
  python -m app.workers.vehicles_worker

调整工作者

bash
docker run -d --restart unless-stopped \
  --name flt-adjustments \
  -e TIMEZONE=America/Chicago \
  -e DATABASE_URL='postgresql+psycopg://...' \
  -e SWIFTLY_API_KEY=<key> \
  -e SWIFTLY_AGENCY=nashville \
  -e SWIFTLY_ADJUSTMENT_QUERY_AGENCY=<your-agency> \
  -e SWIFTLY_ADJUSTMENT_CREATE_AGENCY=<your-agency> \
  linusmotu/fixed-line-transit-2.0-backend:latest \
  python -m app.workers.adjustment_worker

健康检查

API模式通过/health端点提供健康检查：

dockerfile
HEALTHCHECK --interval=30s --timeout=5s --start-period=20s --retries=3 \
  CMD curl -fsS http://localhost:8000/health || exit 1

工作者无HTTP服务，docker ps显示(health: starting)为正常状态。

镜像内部信息

• 基础镜像：python:3.13-slim
• 运行用户：非root用户app
• 工作目录：/app
• 依赖管理：通过uv export生成锁文件，pip install安装

生产部署注意事项

• 单镜像可部署为三个ECS服务（API、车辆工作者、调整工作者）
• 数据库使用RDS，通过Secrets Manager管理密钥
• API服务部署在ALB后，工作者服务无需暴露HTTP
• 敏感信息（如DATABASE_URL）应从Secrets Manager获取，避免明文存储

源码地址

https://github.com/smarttransit-ai/fixed-line-transit-2.0-backend