pdok/mapserver

Mapserver Docker

快速使用

docker
docker build -t pdok/mapserver .
docker run -e MS_MAPFILE=/srv/data/example.map --rm -d \
            -p 80:80 --name mapserver-example -v `pwd`/example:/srv/data pdok/mapserver

docker stop mapserver-example

简介

本项目旨在满足两个需求：

1. 创建可在可扩展基础设施上部署的OGC服务。
2. 创建可用的Docker基础镜像。

为满足第一个需求，主要目的是创建可在Kubernetes等平台上运行的Docker基础镜像。

关于第二个需求，找到可用的https://github.com/mapserver/mapserver Docker镜像是一个挑战。大多数镜像在GetCapabilities中暴露&map=...查询字符串，不运行在FastCGI模式下，且基于Apache。

功能说明

本项目将创建一个通过Lighttpd运行的Mapserver应用。通过lua脚本过滤传入请求中的map=...查询字符串，即只能通过环境变量设置使用的Mapfile。

包含的EPSG文件（包含投影参数）仅包含少量可用的EPSG代码，即本组织使用的那些。如果需要使用其他EPSG投影，可以覆盖此文件。

Docker镜像

Docker镜像包含两个阶段：

1. builder（构建器）
2. service（服务）

builder

builder阶段编译Mapserver。Dockerfile中明确列出了所有可用的Mapserver构建选项，清晰显示哪些选项已启用和禁用。

service

service阶段将第一阶段构建的Mapserver应用复制到该阶段，并配置Lighttpd。

使用方法

构建

docker
docker build -t pdok/mapserver .

对于特定的荷兰版本，包含特定（更小的）epsg文件和必要的网格校正文件：

docker
docker build -t pdok/mapserver:nl -f Dockerfile.NL .

运行

此镜像可直接从命令行运行。需要将卷挂载到容器目录/srv/data，挂载的卷需包含与MS_MAPFILE环境变量匹配的*.map文件。

sh
docker run \
   --rm -d \
   -e MS_MAPFILE=/srv/data/example.map \
   -p 80:80 \
   --name mapserver-example \
   -v `pwd`/example:/srv/data \
   pdok/mapserver

运行上述示例将在http://localhost/?REQUEST=GetCapabilities&SERVICE=WMS创建服务，可接受类似GetMap请求。

可设置的环境变量如下：

• DEBUG：调试模式开关
• MIN_PROCS：最小进程数
• MAX_PROCS：最大进程数
• MAX_LOAD_PER_PROC：每个进程的最大负载
• IDLE_TIMEOUT：空闲超时时间
• MS_MAPFILE：Mapfile路径（必需）
• PROJ_LIB：PROJ投影文件目录

除MS_MAPFILE外，其他环境变量在Dockerfile中有默认值。

GDAL的PROJ_LIB环境变量默认值为/usr/share/proj。为提高性能，可设置包含最少可用EPSG代码的自定义PROJ_LIB，通过上述PROJ_LIB环境变量实现。

sh
docker run \
   --rm -d \
   -p 80:80 \
   --name mapserver-run-example \
   -v `pwd`/example:/srv/data \
   -e DEBUG=0 \
   -e MIN_PROCS=1 \
   -e MAX_PROCS=3 \
   -e MAX_LOAD_PER_PROC=4 \
   -e IDLE_TIMEOUT=20 \
   -e MS_MAPFILE=/srv/data/example.map \
   pdok/mapserver

投影

修改proj文件的原因包括添加自定义投影或删除“未使用”的投影以提高性能。可通过以下几种方式实现：

基础镜像

最佳示例是本仓库中的Dockerfile.NL。该Dockerfile以主Dockerfile为基础镜像，复制特定的大地测量网格文件，并使用为荷兰优化的epsg文件覆盖默认文件。

大地测量文件的良好资源是PROJ.org Datumgrid CDN。

卷挂载

另一种方式是创建proj文件（如nl文件夹中的文件），将其挂载到容器，并通过以下参数设置PROJ_LIB环境变量指向该位置：

sh
-e PROJ_LIB=/my-custom-proj-dir \
-v `pwd`/path/to/proj/dir:/my-custom-proj-dir \

示例

启动容器后，将在访问点http://localhost创建WMS和WFS服务。

示例请求

• http://localhost/?SERVICE=WFS&REQUEST=GetCapabilities
• http://localhost/?SERVICE=WMS&REQUEST=GetCapabilities
• http://localhost/?SERVICE=WFS&VERSION=2.0.0&REQUEST=GetFeature&TYPENAMES=example:example&COUNT=1
• http://localhost/?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetMap&BBOX=50,2,54,9&CRS=EPSG:4326&WIDTH=905&HEIGHT=517&LAYERS=example&STYLES=&FORMAT=image/png&DPI=96&MAP_RESOLUTION=96&FORMAT_OPTIONS=dpi:96&TRANSPARENT=TRUE
• http://localhost/?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetFeatureInfo&BBOX=48.9306039592783506,0.48758765231731171,55.46504193821721884,12.33319204541738756&CRS=EPSG:4326&WIDTH=1530&HEIGHT=844&LAYERS=example&STYLES=&FORMAT=image/png&QUERY_LAYERS=example&INFO_FORMAT=text/html&I=389&J=537&FEATURE_COUNT=10

其他

为什么选择Lighttpd

在之前的配置中，我们使用NGINX，虽然它是一个优秀的Web服务且有很多配置选项，但它运行多个进程，因此需要supervisord进行管理，而lighttpd作为单个进程运行。此外，路由配置选项不是必需的，因为这由基础设施/平台（如Kubernetes）处理。如果需要配置简单路由，仍可在lighttpd.conf中完成。

参考示例

• https://github.com/srounet/docker-mapserver
• https://github.com/Amsterdam/mapserver