はじめに
uwsgiでは、オプションの設定値をコマンドライン引数、ini、xml、jsonなど複数の形式から指定できる。
本記事では視認性に長けているini形式の文法について記載する。
iniファイルの文法
コメント文
冒頭に記載された下記の3文字はコメントとして扱われる。
- ;
- /
基本構成
一般的なアプリケーション開発で使用されるiniファイルと同じ形式で、セクションとキー(設定項目)で構成される。
[uwsgi]
socket = /tmp/uwsgi.sock
socket = 127.0.0.1:8000
workers = 3
master = true
[section1]
socket = /tmp/uwsgi.sock
socket = 127.0.0.1:8000
workers = 3
master = true
キー (オプション)
設定可能なキーは下記URLのuwsgiのオプション一覧に記載されている。
省略系なども含めると1200以上のオプションが存在する。
https://uwsgi-docs.readthedocs.io/en/latest/Options.html
https://qiita.com/11ohina017/items/4cd29ec3e5c58685d784
下表に一部の項目を記載する。
| オプション | 内容 | 例 |
|---|---|---|
| async | 指定されたコアで非同期モードで実行する | 100 |
| chdir | アプリをロードする前に、指定したディレクトリに移動 | /var/www/uwsgi |
| chdir2 | アプリをロードした後に、指定したディレクトリに移動 | /var/www/uwsgi |
| chmod-socket | sockファイルのパーミッションを指定 | 666 |
| gid | 実行するグループID | nginx |
| http-websockets | WebSocket接続を自動的に検出してセッションをRAWモードにする | true |
| logto | ログファイル、UDPアドレスの設定 | /var/log/uwsgi/uwsgi.log |
| master | マスターモードで実行するか否か | true |
| max-requests | ワーカーのリロードを実施するリクエストの閾値 | 100 |
| pidfile | 出力するpidファイルパスの設定 | /var/www/uwsgi/uwsgi.pid |
| 標準出力にメッセージを出力 | test message | |
| processes | 実行するプロセス数 | 1 |
| socket | ソケットの設定 | 127.0.0.1:3031 |
| stats | 指定したアドレスでuWSGI Stats Serverを起動する | 127.0.0.1:9191 |
| touch-reload | 指定されたファイルが変更または修正された場合は、uWSGIをリロードする | /var/www/uwsgi/uwsig_reload |
| ugreen | uWSGI Green Threadsを有効にするか否か | true |
| uid | ユーザID | nginx |
| vacuum | プロセス終了時にファイル/ソケットをすべて削除する | true |
| version | uwsgiバージョンを標準出力に出力 | 指定不可 |
| home, virtualenv, venv, pyhome | virtualenv使用時のPYTHON_HOMEディレクトリを指定 | /usr/local/virtualenv/test |
| python-path, pythonpath, pp | アプリがあるディレクトリを指定 | /var/www/uwsgi/ |
| module | ||
| wsgi | loadするwsgiモジュールを指定 | |
| pyargv | Python実行時の引数を指定 ( sys.argv ) | "foo bar" |
| wsgi-file | ロードするuswgiファイルを指定 | /var/www/uwsgi/index.py |
セクション
実行時にiniファイルだけしか指定しない場合、デフォルトのセクションuwsgiが実行される。
セクションを指定すると、対象のセクションが実行される。
* デフォルトセクションで実行
uwsgi --ini config.ini
* セクションを指定して実行
uwsgi --ini config.ini:section1
他のセクションを外部参照
ファイル名を省略してセクション名だけを指定することによって、
同一または、外部のiniファイルに定義されている他のセクションを読み込みすることも可能。
することも可能。
※ 読み込まれるセクションは、最後にロードされた.iniファイルからセクションを読み込むことになるので、注意が必要
[uwsgi]
# 同一iniファイル内のsection1を読み込む
ini = :section1
# 外部iniファイルのsection2を読み込む
ini = reference.ini
ini = :section2
[section1]
socket = /tmp/uwsgi.sock
socket = 127.0.0.1:8000
マジック変数
uwsgiに標準で用意されている特別な変数。
「%」から始まり、特定の文字列へと置換することができる。
例えば、%n とするとiniファイルのファイル名に置換される
※ 拡張子(ini)は外される
uwsgi.ini
[uwsgi]
socket = /tmp/%n.sock → /tmp/uwsgi.sockに置換される
プレースホルダ
標準で用意されたものではなく、
ユーザが独自にiniファイルに定義するマジック変数のこと。
定義の方法として、下記の2つがある。
- オプションなしで変数を定義
- set-placeholder (set-ph) オプションを使って定義する
[uwsgi]
# オプションなしで定義
value1 = 1
socket = %(value1).sock
# オプションを使って定義
set-ph = value2=2
socket = %(value2).sock
set-placeholder = value3=3
socket = %(value3).sock
set-placeholderを使用すると、プレースホルダであることが明確になり、
uWSGiに標準で用意されているオプションとの誤認を避けることができる。
算術プレースホルダ
計算式に%をつけると、計算結果への置換を行う。
[uwsgi]
x = 1
y = 2
total = %(x + y + 3 * 4)
# インクリメントも可能 (plus = 2になる)
plus = %(x ++)
@マジック
@(ファイル名) と記載するとファイルの内容への置換を行う。
[uwsgi]
sock = @(/tmp/socket)
ロジック設定
for、ifなどプログラミング形式での設定を行う。
for
下記のようにスペースで区切られた文字列を、
プレースホルダ %(_) を置換する。
[uwsgi]
for = 3031 3032 3033
socket = 127.0.0.1:%(_)
endfor =
if-env
環境変数が定義されているかを確認し、
その値をプレースホルダに置換する。
[uwsgi]
if-env = PATH
print = Path is %(_)
endif =
用語
harakiri ( リクエストタイムアウト )
過度に長時間リクエストを処理しているワーカーを中止するuWSGIの機能。
harakiriタイムアウトに指定した秒数より長い時間がかかるリクエストはすべて破棄され、
対応するワーカーはリサイクルされる。
master
uWSGIの内蔵prefork +スレッディングマルチワーカー管理モード。
一般的にはマスターモードで実行することが推奨されている。
Emperor
uWSGI Emperorは、指定したディレクトリにある複数のuWSGIの設定ファイルを読み込んでuWSGIプロセスを起動する機能。
設定を読み込みプロセス起動を一括管理することができる。
ugreen
uWSGI Green Threadsの略。
グリーンスレッドは、OSではなく仮想マシン (VM) によってスケジュールされるスレッド。
グリーンスレッドはネイティブのOSの機能に依存せずにマルチスレッド環境をエミュレートする。