WSGIアプリをPasteで組み合わせるなど¶
シンプルなWSGIアプリを用意¶
まずは環境構築のために以下を実行します。
$ python bootstrap.py -d init
$ bin/buildout
bucho 0.0.5 からwsgiアプリケーション機能を提供しているので、これを使って WSGIアプリを起動します。
buildout.cfg:
[buildout]
parts = app
[app]
recipe = zc.recipe.egg
eggs = bucho
interpreter = py
bin/buildout を実行してbucho環境を構築します。
$ bin/buildout
Pythonインタプリタを起動して、以下のようにして実際にサーバー起動させます (以下のコードはPython-2.5以降で動作します)。
$ bin/py
>>> from wsgiref.simple_server import make_server
>>> from bucho.wsgi import wsgi_app
>>> make_server('', 8000, wsgi_app).serve_forever()
これで http://localhost:8000/ にアクセスすると、シンプルなテキストでbucho wsgiアプリが提供している機能が表示されます。bucho-0.0.5では以下のように表示されます:
bucho provide below urls:
* /show
* /latest_status
* /all_status
* /torumemo
bucho wsgiアプリが提供するURLが表示されますが、テキストなのでリンクされていません。手でURLを書き換えてアクセスするとそれぞれのページを確認することが出来ます。とりあえずbuildout paste wsgiの説明としてはトップページが表示されれば十分ですね。
bucho.wsgi.wsgi_app がどのような作りなのかはコードを見てください。また、Pythonのドキュメントにも有用な情報が多く掲載されています。Python-2.5から導入された wsgiref パッケージのドキュメントを参照してください。
paster から起動する¶
wsgiアプリを起動するために、前述のような wsgiref.simple_server.make_server を使った簡単なプログラムを書いても良いのですが、そのあたりもコードを書かずに手軽に動かしたいところです。そこで、PasteDeployを使用してwsgiサーバーを起動してみます(bin/pasterコマンド生成のためPasteScriptも必要)。
buildout.cfg:
[buildout]
parts = app
[app]
recipe = zc.recipe.egg
eggs =
PasteScript
PasteDeploy
bucho
interpreter = py
そして環境更新のために以下を実行します。
$ bin/buildout
これで bin/paster が作成されました。
bin/paster でwsgiアプリを起動するためには、設定ファイルでどのようなアプリ構成で動かすのかを指定する必要があります。とりあえず動かすために以下のようにiniファイルを作成してください。
app.ini:
[server:main]
use = egg:Paste#http
host = 0.0.0.0
port = 8000
[app:main]
use = egg:bucho#main
簡単にapp.iniの内容を説明します。
[server:main] は paster serve コマンドで実行したときのサーバー設定です。 use で記載しているのはsetuptoolsのエントリーポイントで、 use = egg:Paste#http と指定することでPasteパッケージのserver_runnerセクションにあるhttpエントリーポイントを使うことを宣言しています。
他のパラメータhost,portはPaste#httpで解釈され、サーバーのホスト名、ポート番号として使用されます。
設定ファイルの詳細についてはPasteの以下のドキュメントを参照してください。
サーバー起動は以下のように実行します。
$ bin/paster serve app.ini
Starting server in PID 6536.
serving on 0.0.0.0:8000 view at http://127.0.0.1:8000
最初と同じように、 http://localhost:8000/ にアクセスすると、buchoが表示されますね。
paster の引数を設定済みの起動コマンドを作る¶
ところで、毎回 bin/paster serve app.ini と入力するのは面倒なものです。 そこで設定を追加して bin/server だけで起動出来るように変更します。
buildout.cfg:
[buildout]
parts = app server
[app]
recipe = zc.recipe.egg
eggs =
PasteScript
PasteDeploy
bucho
interpreter = py
[server]
recipe = zc.recipe.egg:scripts
eggs = ${app:eggs}
entry-points = server=paste.script.command:run
arguments = ['serve', 'app.ini']
上記のようなserverセクションを追加すると、特定のコマンド実行時の引数を指定済みの実行スクリプトをbin/serverとして生成してくれます。entry-pointsに指定している値 paste.script.command:run はPasteパッケージの console_scripts セクションからコピーして作りました。 entry-points = の書式については zc.recipe.egg を参照してください。
buildout.cfgを更新したら環境更新のために以下を実行します。
$ bin/buildout
これで、サーバー起動は以下のように実行できるようになりました。簡単ですね。
$ bin/server
Starting server in PID 6536.
serving on 0.0.0.0:8000 view at http://127.0.0.1:8000
app.ini をbuildoutの設定から半自動生成する¶
課題
説明を書く
apacheから接続するためのスクリプトを用意する¶
課題
説明を書く
apacheから接続するためのテンプレートを用意する¶
課題
説明を書く
まとめ¶
最終的に以下のようになりました。
課題
もうちょっと説明を書く
buildout.cfg:
[buildout]
parts = app wsgiapp server app-ini apache-conf
versions = versions
extensions = buildout.dumppickedversions
dump-picked-versions-file = versions.cfg
extends = versions.cfg
[app]
recipe = zc.recipe.egg
eggs =
PasteScript
WebError
bucho
interpreter = py
[wsgiapp]
recipe = collective.recipe.modwsgi
eggs = ${app:eggs}
config-file = ${app-ini:output}
[server]
recipe = zc.recipe.egg:scripts
eggs = ${app:eggs}
entry-points = server=paste.script.command:run
arguments = ['serve', 'etc/app.ini']
[app-ini]
recipe = collective.recipe.template
input = ${buildout:directory}/templates/etc/app.ini.in
output = ${buildout:directory}/etc/app.ini
server-host = 0.0.0.0
server-port = 8080
urlpath-prefix =
logfilename = python.log
[apache-conf]
recipe = collective.recipe.template
input = ${buildout:directory}/templates/etc/apache-vhost.conf.in
output = ${buildout:directory}/etc/apache-vhost.conf
domain = www.example.com
wsgi-processes = 2
wsgi-threads = 2
effective-user = www
実行すると以下のようになります:
$ touch versions.cfg
$ bin/buildout
サーバー起動
$ bin/server
Starting server in PID 6536.
serving on 0.0.0.0:8000 view at http://127.0.0.1:8000
cat versions.cfg
[versions]
collective.recipe.modwsgi = 1.2
collective.recipe.template = 1.8
distribute = 0.6.14
paste = 1.7.5.1
pastedeploy = 1.3.4
pastescript = 1.7.3
pygments = 1.4
tempita = 0.5dev
weberror = 0.10.3
webob = 1.0.3
z3c.recipe.scripts = 1.0.1
zc.recipe.egg = 1.3.2
$ cat etc/apache-vhost.conf
<Directory c:\Project\freia\buildout\source\code\paste-wsgi/parts/wsgiapp>
Order deny,allow
Allow from all
</Directory>
<VirtualHost *:80>
ServerName www.example.com
CustomLog /var/log/httpd/www.example.com-access.log combined
ErrorLog /var/log/httpd/www.example.com-error.log
WSGIDaemonProcess www.example.com processes=2 threads=2 maximum-requests=10000 user=www group=www
WSGIScriptAlias / c:\Project\freia\buildout\source\code\paste-wsgi/parts/wsgiapp/wsgi
WSGIProcessGroup www.example.com
WSGIPassAuthorization On
</VirtualHost>
cat etc/app.ini
[DEFAULT]
debug = true
[server:main]
use = egg:Paste#http
host = 0.0.0.0
port = 8000
[composite:main]
use = egg:Paste#urlmap
/static = static
/ = bucho-pipeline
[app:static]
use = egg:Paste#static
document_root = c:\Project\freia\buildout\source\code\paste-wsgi/static
[pipeline:bucho-pipeline]
pipeline = egg:WebError#evalerror
bucho-main
[app:bucho-main]
use = egg:bucho#main
;#####################################
; logger setting for mod_wsgi app
[loggers]
keys=root
[handlers]
keys=hand01
[formatters]
keys=form01
[logger_root]
level=INFO
handlers=hand01
[handler_hand01]
class=FileHandler
level=INFO
formatter=form01
args=('python.log', 'w')
[formatter_form01]
format=F1 %(asctime)s %(levelname)s %(message)s
datefmt=
class=logging.Formatter
