部署¶

测试¶

这个 serve-develop 子命令 mapproxy-util 启动HTTP服务器进行本地测试。它将现有的maproxy配置文件作为参数：：

mapproxy-util serve-develop mapproxy.yaml

如果配置或任何maproxy代码更改，服务器将自动重新加载。

--bind, -b¶

设置mapproxy应该监听的套接字。默认为 localhost:8080 . 接受端口号或 hostname:portnumber .

--debug¶

在调试模式下启动maproxy。如果已安装 Werkzeug, 对于任何未处理的异常（内部错误），您将在Web浏览器中获得交互式跟踪。

这个 serve-multiapp-develop 子命令 mapproxy-util 类似于 serve-develop 但是需要一个maproxy配置目录。见 MultiMapProxy .

生产¶

在生产环境中部署maproxy有两种常见方法。

嵌入在HTTP服务器中

您可以直接将maproxy集成到Web服务器中。Apache可以将python Web服务与 mod_wsgi 例如，扩展。

在HTTP服务器或代理之后

您可以在现有Web服务器之后作为单独的本地HTTP服务器运行maproxy。 (nginx, Apache等）或HTTP代理 (Varnish, 鱿鱼等）。

这两种方法都需要一个将您的maproxy配置映射到maproxy应用程序的配置。您可以为此编写一个小脚本文件。

mapproxy-util create -t wsgi-app -f mapproxy.yaml config.py

from mapproxy.wsgiapp import make_wsgi_app
application = make_wsgi_app('examples/minimal/etc/mapproxy.yaml')

from mapproxy.wsgiapp import make_wsgi_app
application = make_wsgi_app('examples/minimal/etc/mapproxy.yaml', reloader=True)

阿帕奇莫迪WSGI¶

ApacheHTTP服务器可以直接将python应用程序与 mod_wsgi 延伸。好处是您不必启动其他服务器。读 mod_wsgi installation 详细说明。

mod_wsgi 需要一个服务器脚本，该脚本将配置的wsgi函数定义为 application . 见 above .

你需要修改你的Apache httpd.conf 如下：

# if not loaded elsewhere
LoadModule wsgi_module modules/mod_wsgi.so

WSGIScriptAlias /mapproxy /path/to/mapproxy/config.py

<Directory /path/to/mapproxy/>
  Order deny,allow
  Allow from all
</Directory>

mod_wsgi has a lot of options for more fine tuning. WSGIPythonHome or WSGIPythonPath lets you configure your virtualenv and WSGIDaemonProcess/WSGIProcessGroup 允许您启动多个进程。见 mod_wsgi configuration directives documentation . 使用mapnik还需要 WSGIApplicationGroup 选择权。

更完整的配置可能如下所示：

# if not loaded elsewhere
LoadModule wsgi_module modules/mod_wsgi.so

WSGIScriptAlias /mapproxy /path/to/mapproxy/config.py
WSGIDaemonProcess mapproxy user=mapproxy group=mapproxy processes=8 threads=25
WSGIProcessGroup mapproxy
# WSGIPythonHome should contain the bin and lib dir of your virtualenv
WSGIPythonHome /path/to/mapproxy/venv
WSGIApplicationGroup %{GLOBAL}

<Directory /path/to/mapproxy/>
  Order deny,allow
  # For Apache 2.4:
  Require all granted
  # For Apache 2.2:
  # Allow from all
</Directory>

在HTTP服务器或代理之后¶

有可用的python http服务器可以直接运行maproxy。它们中的大多数都是健壮和高效的，但是有一些奇怪的HTTP客户机（mis）以各种方式解释HTTP标准。因此，建议将成熟且广泛部署的HTTP服务器或代理放在前面（如 Apache, Nginx, 等等）。

cd /path/of/config.py/
waitress --listen 127.0.0.1:8080 config:application

server {
  server_name example.org;
  location /mapproxy {
    proxy_pass http://localhost:8181;
    proxy_set_header Host $http_host;
    proxy_set_header X-Script-Name /mapproxy;
  }
}

<IfModule mod_proxy.c>
  <IfModule mod_headers.c>
        <Location /mapproxy>
                ProxyPass http://localhost:8181
                ProxyPassReverse  http://localhost:8181
                RequestHeader add X-Script-Name "/mapproxy"
        </Location>
  </IfModule>
</IfModule>

性能¶

由于python在计算重应用程序（如maproxy wms）时处理线程的方式，您应该选择使用多个进程（基于预复刻）以获得最佳性能的服务器。

上面的示例都是最少的，您应该阅读组件的文档，以获得安装程序的最佳性能。

负载平衡和高可用性¶

您可以轻松地并行运行多个maproxy实例，并使用负载均衡器在所有实例之间分发请求，但是当实例与NFS或其他网络文件系统共享同一个tile缓存时，有一些事情需要考虑。

maproxy使用文件锁来防止多个进程从一个源请求同一个映像两次。当maproxy并行处理两个或多个丢失的图块请求，并且这些图块属于同一个元图块时，通常会发生这种情况。如果不锁定，maproxy将为每个请求请求元数据块。有了锁，只有第一个进程才能获得锁并请求元数据块。其他进程将等待，直到第一个进程释放锁，然后使用新创建的图块。

由于文件锁定在大多数网络文件系统上都不起作用，所以当maproxy在网络文件系统上写入这些文件时，很可能会出错。您应该将maproxy配置为在本地文件系统上写入所有锁文件，以防止发生这种情况。见 globals.cache.lock_dir 和 globals.cache.tile_lock_dir .

使用此设置，只有当对同一元图块的图块的并行请求转到同一个maproxy实例时，锁定才会有效。因为这些请求通常是从同一个客户机发出的，所以应该启用 粘性会话 在您的负载均衡器中，当您提供平铺服务（wmts/tms/kml）时。

登录¶

maproxy使用python日志库来报告运行时信息、错误和警告。您可以使用python代码或ini样式配置来配置日志记录。阅读 logging documentation for more information .

mapproxy-util create -t log-ini log.ini

MultiMapProxy¶

您可以使用multimaproxy应用程序在一个进程中运行多个maproxy实例（配置）。

multimaproxy可以动态加载配置。您可以将所有配置放在一个目录中，并将每个文件映射到一个URL: conf/proj1.yaml 可在 http://hostname/proj1/ .

每个配置都将按需加载，并且maproxy缓存每个加载的实例。如果文件更改，将重新加载配置。

多映射代理作为以下选项：

config_dir

maproxy应查找配置的目录。

allow_listing

如果设置为 true ，mapproxy将在mapproxy的根URL中列出所有可用的配置。默认为 false .

from mapproxy.multiapp import make_wsgi_app
application = make_wsgi_app('/path/to.projects', allow_listing=True)