mapproxy-docker

镜像概述和主要用途

本项目旨在创建一个可用于Kubernetes等可扩展基础设施的Docker基础镜像，同时支持通过单条docker run命令轻松使用。该镜像不在Docker构建过程中复制配置文件，并包含必要的依赖安装（如pip install ... gunicorn uwsgi ...），为Mapproxy应用提供灵活的部署基础。

主要用途是运行Mapproxy应用，用户只需添加自己的mapproxy.yaml配置即可。对于docker-compose或Kubernetes等复杂部署场景，该镜像可作为创建多容器/ pods部署的起点。

核心功能和特性

• 简单易用：仅需添加自定义mapproxy.yaml配置文件即可启动Mapproxy服务
• 灵活配置：通过挂载配置目录实现配置注入，无需在构建时固化配置
• 多场景支持：支持单容器运行、docker-compose多容器部署及Kubernetes大规模集群部署
• 基础设施兼容：适用于Kubernetes等可扩展基础设施，同时保持单机使用简便性

使用场景和适用范围

• 开发测试：通过单条docker run命令快速启动Mapproxy服务，验证配置效果
• 多容器部署：结合docker-compose实现多服务协同部署
• 大规模部署：作为Kubernetes pods部署的基础镜像，支持集群化扩展

详细使用方法和配置说明

快速启动

docker build -t pdok/mapproxy .
docker run --rm -d -p 80:80 --name mapproxy-example -v `pwd`/examples/config:/srv/mapproxy/config pdok/mapproxy

docker stop mapproxy-example

构建镜像

docker build -t pdok/mapproxy .

运行容器

该镜像可直接通过命令行运行，需将包含配置文件的目录挂载到容器的/srv/mapproxy/config目录。

docker run -d -p 80:80 --name mapproxy-example -v `pwd`/examples/config:/srv/mapproxy/config pdok/mapproxy

上述命令将启动一个基础Mapproxy服务，通过http://localhost/demo可访问测试页面。替换示例mapproxy.yaml为自定义配置后，服务将使用新配置启动。

Docker-compose部署

docker-compose示例文件可在此处查看。

Kubernetes部署

Kubernetes部署示例可在此处查看。