gunicorn で web.py 製のアプリケーションを動かす

gunicorn とは Ruby の unicorn を元に開発された Python 用の HTTP サーバです。この gunicorn を使って web.py 製のアプリケーションを動かすことができたのでその備忘録。
後々 nginx と連携させて自作の Web アプリをデプロイしたいなーとか思ってます。

今回構築した環境は

OS: Mac OS X Snow Leopard
Python: 2.6.6 (MacPortsより)
web.py: 0.33 (easy_install にて)
gunicorn: 0.8.1 (easy_install にて）

web.py と gunicorn はそれぞれ

$ sudo easy_install-2.6 web.py
$ sudo easy_install-2.6 gunicorn

でインストールしました。

また、MacPorts からインストールした easy_install を使った場合、gunicorn は /opt/local/Library/Frameworks/Python.framework/Versions/2.6/bin にインストールされます。PATH が通ってない場合はあらかじめ設定しておく必要があります。

今回使ったソースは web.py の公式でも紹介されている 'Hello World!' アプリです。

app.py

#!/usr/bin/env python
# -*- coding:utf-8 -*-
import web

urls = (
    '/(.*)', 'hello'
)

app = web.application(urls, globals())

class hello:
    def GET(self, name):
        if not name:
            name = 'World'
        return 'Hello, ' + name + '!'

if __name__ == '__main__':
    app.run()

このソースを一行書き換えれば gunicorn （というか WSGI）への対応完了です。

app.py

#!/usr/bin/env python
# -*- coding:utf-8 -*-
import web

urls = (
    '/(.*)', 'hello'
)

app = web.application(urls, globals()).wsgifunc() # <- .wsgifunc() を追加！

class hello:
    def GET(self, name):
        if not name:
            name = 'World'
        return 'Hello, ' + name + '!'

if __name__ == '__main__':
    app.run()

次に、gunicorn での起動方法です。app.py が置いてあるディレクトリで以下のコマンドを実行します。

$ gunicorn app:app
2010-09-26 22:23:50 [93920] [INFO] Arbiter booted
2010-09-26 22:23:50 [93920] [INFO] Listening at: http://127.0.0.1:8000
2010-09-26 22:23:50 [93922] [INFO] Worker spawned (pid: 93922)

これで起動完了です。 gunicorn に渡す引数は、(モジュール名):(変数名) です。今回の場合は app.py でモジュール名が app、wsgifunc()の返り値を代入してる変数名が app なので、app:app となります。

ファイルの変更が動的に反映されるので、開発時にはかなり便利ですね。

次は nginx と連携して動作させる設定を行なってみようと思います。