通常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>

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

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守护进程。