tuesd4y/osrm-backend-eks

osrm-backend for AWS Elastic Kubernetes Service

镜像概述和主要用途

该Docker镜像专为AWS Elastic Kubernetes Service (EKS) 设计，提供两种运行模式：CREATE模式用于下载.osm.pbf文件、构建路由图并上传至指定S3存储桶；LOAD模式用于从S3存储桶下载预构建路由图并在5000端口启动OSRM后端服务器，提供地理路由服务。

核心功能和特性

• 双模式运行：支持CREATE（数据处理与上传）和LOAD（服务启动）两种模式，满足不同场景需求
• S3集成：无缝对接AWS S3存储桶，实现路由图的存储与加载
• Webhook支持：CREATE模式下可配置Webhook，在数据上传后发送通知
• 灵活配置：支持多种环境变量配置，包括路由图标签、AWS认证信息、服务参数等
• 多配置文件支持：可通过OSRM_GRAPH_PROFILE指定不同的路由配置文件（如car、bike等）

使用场景和适用范围

• 动态路由图构建：需要定期更新地理数据并生成新路由图的场景（如城市交通数据更新）
• 快速路由服务部署：已存在预构建路由图，需快速启动路由服务的场景
• AWS云环境集成：在EKS集群中部署地理路由服务，利用S3进行数据持久化
• 微服务架构：作为地理路由微服务，为导航、物流等应用提供路径计算支持

使用方法和配置说明

CREATE模式：下载源文件并构建路由图

该模式用于从指定URL下载OSM数据，构建路由图，并上传至S3存储桶。

bash
docker run -d -p 5000:5000 \
-e OSRM_PBF_URL='http://download.geofabrik.de/europe/germany/berlin-latest.osm.pbf' \
-e OSRM_DATA_LABEL='berlin-new' \
-e OSRM_S3_BUCKET='s3://triply-routing-data' \
-e OSRM_AWS_ACCESS_KEY_ID='YOUR_ACCESS_KEY' \
-e OSRM_AWS_SECRET_ACCESS_KEY='YOUR/SECRET' \
-e OSRM_WEBHOOK_URL='https://example.com/post' \
--name osrm-backend tuesd4y/osrm-backend-eks:latest

CREATE模式特殊说明：

• Webhook通知：若设置OSRM_WEBHOOK_URL，数据上传后会向该URL发送POST请求，请求体格式如下：

  json
  {
    "label":"$OSRM_DATA_LABEL", 
    "mode":"$OSRM_GRAPH_PROFILE",
    "source":"$OSRM_PBF_URL",
    "target":"$OSRM_S3_BUCKET/$OSRM_DATA_LABEL"
  }
  

• 服务启动控制：若OSRM_EXIT_AFTER_UPLOAD设为非空值，路由图构建并上传后容器会退出；否则会在5000端口启动OSRM服务。

LOAD模式：下载预构建路由图并启动服务

该模式用于从S3存储桶下载预构建的路由图并启动OSRM路由服务。

bash
docker run -d -p 5000:5000 \
-e OSRM_DATA_LABEL='berlin-new' \
-e OSRM_MODE='LOAD' \
-e OSRM_S3_BUCKET='s3://triply-routing-data' \
-e OSRM_AWS_ACCESS_KEY_ID='YOUR_ACCESS_KEY' \
-e OSRM_AWS_SECRET_ACCESS_KEY='YOUR/SECRET' \
--name osrm-backend-load tuesd4y/osrm-backend-eks:latest

服务验证：

通过以下命令检查路由服务是否正常运行：

bash
curl http://localhost:5000/route/v1/driving/13.388860,52.517037;13.385983,52.496891?steps=true

配置选项

OSRM核心配置

AWS相关配置

更新日志

v1.1

• 为CREATE模式添加Webhook支持（通过设置OSRM_WEBHOOK_URL启用）
• 支持配置CREATE模式下路由图上传后是否启动OSRM服务（通过OSRM_EXIT_AFTER_UPLOAD控制）

v1

• 初始版本发布

许可证

本镜像基于MIT许可证发布，详情请参见许可证文件。

本仓库的开发深受Peter Evans的https://github.com/peter-evans/osrm-backend-k8s%E4%BB%93%E5%BA%93%E5%90%AF%E5%8F%91%E3%80%82