Apache重新加载WSGI应用

通常 python 写的wsgi app可以使用mod_wsgi模块来部署到apache服务中。本文介绍在这种方式下如何重新加载wsgi应用。

1. mod_wsgi的运行模式

mod_wsgi在apache中上有两种工作模式，分别是：

1. Embedded Mode
2. Daemon Mode

针对python程序来讲，Daemon Mode能获得更好的性能，在多站点时也有很好的控制能力，所以推荐这种运行模式部署。

1.1 Embedded Mode

默认情况下，WSGI应用程序以这种模式运行。在这种模式下，WSGI应用会被托管在处理静态文件请求的apache工作进程中，通过Apache MPM模块处理。在apache MPM的默认配置下，WSGI的应用程序无法达到比较好的性能，而且如果apache需要管理多个站点时，无法单独对每个站点做一些单独的控制（比如每个站点的进程数）。

1.2 Daemon Mode

在守护模式下，Apache创建了一组用于托管WSGI应用程序的进程，对该WSGI应用程序的任何请求都会自动路由到这些进程以进行处理。如果要使用这种模式，你需要在配置文件中添加如下的配置：

<VirtualHost *:8001>
    WSGIDaemonProcess example1.com processes=2 threads=15
    WSGIProcessGroup example1.com
    ...略...
</VirtualHost>

<VirtualHost *:8002>
    WSGIDaemonProcess example2.com processes=2 threads=25
    WSGIProcessGroup example2.com
    ...略...
</VirtualHost>

通过配置 WSGIDaemonProcess 和 WSGIProcessGroup ，我们可以比较方便的为每个站点配置进程数和线程数，这在嵌入模式中是无法做到的。

2. 重新加载WSGI

本章节只介绍守护模式下的重新加载，嵌入模式不再讨论。

在守护模式下有种方式重新脚在wsgi的脚本文件，当然重启apache服务也会重新加载，这种方式并不包括在这两种方式中。

2.1 重启WSGI守护进程

这种方式可以由WSGI应用本身来控制，只需要在WSGI程序中向自己发送一个SIGINT信号即可，WSGI守护进程会被关掉，Apache再自动重新拉起，实现WSGI重新加载。

这种方式可能会影响请求的处理。

import os
import signal

os.kill(os.getpid(), signal.SIGINT)

更安全的做法是在发送信号前判断下当前是否处于守护进程模式：

if environ['mod_wsgi.process_group'] != '':
    import signal, os
    os.kill(os.getpid(), signal.SIGINT)

但在有的wsgi应用程序中，并没有这个环境变量，所以需要按实际情况使用。

2.2 WSGI应用入口文件

Apache在运行过程中会监控WSGI的入口文件，也就是如下配置指定的文件：

WSGIScriptAlias / /project/example/wsgi.py

当这个wsgi.py文件发生修改后，Apache会自动关闭守护进程并重新启动。所以我们只需要使用命令 touch 来更新下文件时间戳或修改文件内容即可，例如：

touch /project/example/wsgi.py

这种方式不会影响请求的处理，一旦重新启动守护程序进程，它仍然会被处理。

上述的重启行为还收到另外一个配置的控制：

WSGIScriptReloading On

只有该配置为 On 时，才起作用，如果为 Off ，即使修改了WSGI入口文件，Apache也不会重启WSGI守护进程。