logistimo/locations-service

镜像概述

Locations-service是一个Web服务镜像，专注于返回地点相关信息，涵盖国家及其多层级行政区域（省/州、区/县、乡/镇、城市等）的结构化数据。

核心功能

• 提供国家、省/州、区/县、乡/镇、城市等地理层级信息查询
• 支持与MariaDB数据库集成，读取结构化地理数据
• 通过环境变量灵活配置服务端口、数据库连接等参数

使用场景

• 物流系统中获取配送区域的行政层级信息
• 地图应用中补充地理区域数据支撑
• 行政信息查询工具中提供标准化地点层级数据

配置说明

关键环境变量配置：

• SPRING_PROFILES_ACTIVE：Spring运行环境（如dev）
• SERVER_PORT：服务监听端口
• MYSQL_LOGI_HOST：Logistimo数据库连接地址
• MYSQL_LOC_HOST：Locations数据库连接地址
• MYSQL_LOC_USER/MYSQL_LOC_PASS：Locations数据库的用户名/密码
• MYSQL_LOGI_USER/MYSQL_LOGI_PASS：Logistimo数据库的用户名/密码

部署示例

Docker Run启动

bash
docker run --net=host \
  -e SPRING_PROFILES_ACTIVE="dev" \
  -e SERVER_PORT="9090" \
  -e MYSQL_LOGI_HOST="jdbc:mariadb://<mariadb_host>:3306/logistimo?useUnicode=true&characterEncoding=UTF-8" \
  -e MYSQL_LOC_HOST="jdbc:mariadb://<mariadb_host>:3306/locations?useUnicode=true&characterEncoding=UTF-8" \
  -e MYSQL_LOC_USER="<mysql_user>" \
  -e MYSQL_LOC_PASS="<mysql_password>" \
  -e MYSQL_LOGI_USER="<mysql_user>" \
  -e MYSQL_LOGI_PASS="<mysql_password>" \
  -e APP_START="true" \
  --name locations-service \
  -d logistimo/locations-service:latest

容器操作

进入容器Shell

bash
docker exec -it locations-service /bin/bash

查看服务日志

bash
docker logs -f locations-service