Context Navigation

Changes between Version 1 and Version 2 of TracFastCgi

Timestamp:: May 13, 2012, 9:15:45 PM (12 years ago)
Author:: trac
Comment:: --

Legend:

: Unmodified
: Added
: Removed
: Modified

TracFastCgi

-              v1
+              v2
 = Trac を FastCGI で使用する =
 バージョン 0.9 以降、 Trac は [http://www.fastcgi.com/ FastCGI] インタフェースに対応するようになりました。 [wiki:TracModPython mod_python] 同様、 Trac を常駐させるため、外部の各リクエストに対して新しいプロセスを生成する CGI インタフェースよりも処理速度が速いです。その上 `mod_python` とは異なり [http://httpd.apache.org/docs/suexec.html SuEXEC] に対応することも可能です。また、より多くの種類の Web サーバにサポートされています。
+== 単純な Apache の設定 ==
+Apache で利用可能な FastCGI モジュールは 2 種類あります: `mod_fastcgi` と
+`mod_fcgid` です。 これ以降に書かれている `FastCgiIpcDir` と `FastCgiConfig` ディレクティブ
+は `mod_fastcgi` のディレクティブです; `DefaultInitEnv` は `mod_fgcid`
 のディレクティブです。
+`mod_fastcgi` では、 Apache の設定ファイルに以下の設定を追記します。
 ファイル:
+= Trac を FastCGI で使用する = #TracwithFastCGI
+[http://www.fastcgi.com/ FastCGI] インタフェースを使用すると [wiki:TracModPython mod_python] 同様に Trac を常駐させることができます。そのため、外部からのリクエストごとに新しいプロセスを生成する CGI インタフェースよりも処理速度は速くなるうえ、 mod_python では実現出来ない [http://httpd.apache.org/docs/suexec.html Apache の SuEXEC] に対応させることができます (例えば、 Web サーバとは異なる権限で起動させることができます)。また、 mod_python より多くの種類の Web サーバでサポートされています。
+'''Windows 向けの Note:''' Trac の FCGI は Windows では使用できません。 `_fcgi.py` が必要とする `Socket.fromfd` が Windows では実装されていないためです。 IIS を使用しているのであれば、 [http://trac.edgewall.org/wiki/TracOnWindowsIisAjp AJP] を使うこともできます。 (訳注: Apache でも mod_proxy_ajp 経由で ajp を使用できます。)
+== 単純な Apache の設定 == #SimpleApacheconfiguration
+Apache で利用可能な FastCGI モジュールは 2 種類あります: `mod_fastcgi` と
+`mod_fcgid` (推奨) です。後者の方がよりメンテナンスされています。
+==== `mod_fastcgi` でのセットアップ ==== #setupwithmod_fastcgi
+`mod_fastcgi` では `FastCgiIpcDir` と `FastCgiConfig` ディレクティブを使用して Apache の設定ファイルに設定を行います:
 {{{
 # Enable fastcgi for .fcgi files
 …
 デフォルトの設定に問題がなければ、 `FastCgiIpcDir` の設定は必須ではありません。 `LoadModule` の行は `IfModule` グループの後になければいけないことに注意して下さい。
 `ScriptAlias` を設定するもしくは似たオプションが TracCgi で説明されていますが、
 `trac.cgi` の代わりに `trac.fcgi` を呼びます。
+`ScriptAlias` もしくは TracCgi で説明されている類似のオプションを設定しますが、
+`trac.cgi` の代わりに `trac.fcgi` を指定してください。
 `TRAC_ENV` を以下のように設定することができます:
 …
 }}}
 もしくは複数の Trac プロジェクトを扱っているときは、このように設定します:
+複数の Trac プロジェクトを扱っているときは、このように設定します:
 {{{
 FastCgiConfig -initial-env TRAC_ENV_PARENT_DIR=/parent/dir/of/projects
 }}}
+これらの設定は、 `mod_fcgid` では動きません。似ていますが
+`mod_fcgid` での部分的な解決策は以下の通りになります:
+==== `mod_fcgid` でのセットアップ ==== #setupwithmod_fcgid
+`ScriptAlias` を設定します。 (詳細は TracCgi を参照してください)、 ただし
+`trac.cgi` の代わりに `trac.fcgi` を呼び出します。 Note: 最後のスラッシュを忘れずに。とても重要です。
+{{{
+ScriptAlias /trac /path/to/www/trac/cgi-bin/trac.fcgi/
+}}}
+`mod_fcgid` で Trac environment を設定するには `DefaultInitEnv`
+ディレクティブを使用します。このディレクティブは `Direcotry` や `Location`
+コンテキストで使用できないので、複数のプロジェクトを設定する場合、
+下に記述する Environment を設定する別の方法を試してください。
 {{{
 DefaultInitEnv TRAC_ENV /path/to/env/trac/
 }}}
+しかし、これは `Directory` や `Location` コンテキストで使用することができません。
+よって、複数のプロジェクトに対応するのは難しくなります。
+これらのモジュールの両方 (同様に [http://www.lighttpd.net/ lighttpd] と CGI も) で動かすよりよい方法は、
+`trac.fcgi` に以下の値を設定することです。
 Web サーバに環境変数を設定する必要がなくなります。例:
+==== Environment を設定する別の方法 ==== #alternativeenvironmentsetup
+Trac environment へのパスを設定するための、より適した方法は、パスを
+`trac.fcgi` スクリプト自体に書き込むことです。これによってサーバの環境変数を
+設定する必要がなくなり、どちらの !FastCgi モジュール (および
+[http://www.lighttpd.net/ lighttpd] や CGI など) でも、動作するようになります:
 {{{
 import os
 os.environ['TRAC_ENV'] = "/path/to/projectenv"
 }}}
+or
+または
 {{{
 import os
 …
 }}}
+プロジェクトごとの `ScriptAliases` と `.fcgi` スクリプトを設定すれば、
+この方法を使用して複数のプロジェクトに対応することができます。
+`trac.fcgi` をコピーして、ファイル名を適切に変更し、上記のコードをそれぞれのスクリプトに追記します。
+== 単純な Lighttpd の設定 ==
+プロジェクトごとの `ScriptAlias` と `.fcgi` スクリプトを設定すれば、
+起動スクリプトに `TRAC_ENV` 等を設定する方法を使用して複数のプロジェクトに対応することができます。
+この [https://coderanger.net/~coderanger/httpd/fcgi_example.conf fcgid 設定例] の通り、 !ScriptAlias ディレクティブでは末尾の / も含めて設定してください:
+{{{
+ScriptAlias / /srv/tracsite/cgi-bin/trac.fcgi/
+}}}
+== Cherokee の簡単な設定 == #SimpleCherokeeConfiguration
+Cherokee 側の設定はとても簡単です。 Trac を SCGI プロセスとして起動できるかどうかのみ知っている必要があります。
+Cherokee が起動していないときにはいつでも、 Cherokee が Trac を切り離せるようにすることによって、 Trac を手動で起動することも、いっそのこと自動的に起動することもできます。
+最初に、ローカルのインタプリタである cherokee-admin で information source を設定します。
+{{{
+Host:
+localhost:4433
+Interpreter:
+/usr/bin/tracd —single-env —daemonize —protocol=scgi —hostname=localhost —port=4433 /path/to/project/
+}}}
+もしそのポート番号に到達できなければ、インタプリタコマンドは起動されたことになります。information source の定義において、 ''ローカルインタプリタ'' の代わりに、 ''リモートホスト'' を ''information source'' として使用するならば、 spawner を手動で起動する必要があることを覚えておいてください。
+そして、 Trac にアクセスするために SCGI ハンドラによって管理される新しいルールを作成しなければなりません。このルールは例えば、 trac.example.net という新しい仮想サーバ内で作成し、 2 つのルールのみを必要とします。 '''デフォルト''' ルールは以前に作成された information source に関する SCGI ハンドラで使用されます。
+つ目のルールは Trac のインタフェースを正しく表示するために必要ないくつかの静的ファイルを扱うために設定します。ルールを ''/chrome/common'' の ''ディレクトリルール'' として作成し、 ''静的ファイル'' のハンドラを適切なファイルをポイントする ''ドキュメントルート'' と共に設定するだけです: ''/usr/share/trac/htdocs/''
+Note:\\
+tracd プロセスが起動しない場合や cherokee が 503 エラーページを表示する場合、 [http://trac.saddi.com/flup python-flup] がインストールされていない可能性があります。\\
+Python-flup は SCGI の能力を trac に与える従属関係にあります。 debian 基本システムからインストールできます:
+{{{
+sudo apt-get install python-flup
+}}}
+== Lighttpd の簡単な設定 == #SimpleLighttpdConfiguration
 FastCGI フロントエンドは最初 [http://www.lighttpd.net/ lighttpd] のような、 Apache 以外の Web サーバのために開発されました。
 …
 他の Web サーバに比べて CPU や、メモリの占有率がとても少ないです。
+`trac.fcgi` を lighttpd で使用するためには、 lighttpd.conf に以下の行を追加します:
+{{{
+`trac.fcgi`(0.11 以前) / fcgi_frontend.py (0.11) を lighttpd で使用するためには、 lighttpd.conf に以下の行を追加します:
+{{{
+#var.fcgi_binary="/usr/bin/python /path/to/fcgi_frontend.py" # 0.11 if installed with easy_setup, it is inside the egg directory
+var.fcgi_binary="/path/to/cgi-bin/trac.fcgi" # 0.10 name of prior fcgi executable
 fastcgi.server = ("/trac" =>
                    ("trac" =>
                      ("socket" => "/tmp/trac-fastcgi.sock",
                       "bin-path" => "/path/to/cgi-bin/trac.fcgi",
+                      "bin-path" => fcgi_binary,
                       "check-local" => "disable",
                       "bin-environment" =>
 …
 }}}
 動かしたい Trac のインスタンス毎に `fastcgi.server` のエントリを追加する必要があります。別の方法として、、上記の `TRAC_ENV` の代わりに `TRAC_ENV_PARENT_DIR` を使用でき、
+動かしたい Trac のインスタンス毎に `fastcgi.server` のエントリを追加する必要があります。別の方法として、上記の `TRAC_ENV` の代わりに `TRAC_ENV_PARENT_DIR` を使用でき、
 `lighttpd.conf` に設定する代わりに `trac.fcgi` ファイルに
 `bin-environment` (上記の Apache の設定 に書かれています) の2つのうちのどちらかを設定します。
+Note: lighttpd には fastcgi.server の uri が例えばこの例では、 '/trac' とするところを '/' としてしまう 'SCRIPT_NAME' と 'PATH_INFO' に関するバグがあります。詳細については、 [http://trac.edgewall.org/ticket/2418 本家チケット 2418] を参照して下さい。　このバグは lighttpd 1.4.23 以降で修正されています。 fastcgi.server のパラメータとして、 `"fix-root-scriptname" => "enable"` を追加する必要があるでしょう。
 lighttpd で2つのプロジェクトを動かすには、 `lighttpd.conf` に以下の設定を追加します:
 …
                    ("first" =>
                     ("socket" => "/tmp/trac-fastcgi-first.sock",
                      "bin-path" => "/path/to/cgi-bin/trac.fcgi",
+                     "bin-path" => fcgi_binary,
                      "check-local" => "disable",
                      "bin-environment" =>
 …
                     ("second" =>
                     ("socket" => "/tmp/trac-fastcgi-second.sock",
                      "bin-path" => "/path/to/cgi-bin/trac.fcgi",
+                     "bin-path" => fcgi_binary,
                      "check-local" => "disable",
                      "bin-environment" =>
 …
+                )
 }}}
+各フィールドの値が異なることに注意して下さい。もし `.fcgi` スクリプトに
+環境変数を設定するほうが好ましい場合は、 `trac.fcgi` をコピー / 名前変更をして下さい。例として、
 `first.fcgi` と `second.fcgi` が上記の設定では参照されるようにします。
 上記の設定で、両方のプロジェクトが 同じ `trac.fcgi` スクリプトで起動していても、
+Note: 各フィールドの値が異なることに注意して下さい。もし、
+`.fcgi` スクリプト内の環境変数を設定する方が好ましいならば、 `trac.fcgi` スクリプトを
+例えば、 `first.fcgi` や `second.fcgi` というようにコピー / リネームして、上記設定の中でこれらのスクリプトを参照するようにしてください。
+両方のプロジェクトが同じ `trac.fcgi` スクリプトから起動しているとしても、
 異なるプロセスになることに注意して下さい。
 {{{
+#!html
+<p style="background: #fdc; border: 2px solid #d00; font-style: italic; padding: 0 .5em; margin: 1em 0;">
+<strong>Note from c00i90wn:</strong> server.modules をロードする順番はとても重要です。もし、 mod_auth が mod_fastcgi より <strong> 先に </strong> ロードされる設定になっていない場合、サーバはユーザの認証に失敗します。
+</p>
+#!div class=important
+'''Note''': server.modules をロードする順番はとても重要です。もし、 mod_auth が mod_fastcgi より '''先に''' mod_auth がロードされない設定になっていない場合、サーバはユーザ認証に失敗します。
 }}}
 認証のために lighttpd.conf の 'server.modules' 中で mod_auth を有効にして、 auth.backend と認証方法を選択して下さい:
 …
 }}}
 パスワードファイルがない場合、 lighttpd (確認したバージョンは 1.4.3) が停止するので注意して下さい。
 バージョン 1.3.16 以前では lighttpd は 'valid-user' をサポートしていないので注意してください。
+Note: パスワードファイルがない場合、 lighttpd (確認したバージョンは 1.4.3) が停止するので注意して下さい。
+Note: バージョン 1.3.16 以前では lighttpd は 'valid-user' をサポートしていないので注意してください。
 条件付の設定は静的リソースをマッピングするときに便利です。例として FastCGI を経由せずに直接イメージファイルや CSS を参照するときなどです。:
 …
                    ("trac" =>
                      ("socket" => "/tmp/trac-fastcgi.sock",
                       "bin-path" => "/path/to/cgi-bin/trac.fcgi",
+                      "bin-path" => fcgi_binary,
                       "check-local" => "disable",
                       "bin-environment" =>
 …
+                        (
                           "socket" => "/tmp/trac.sock",
                           "bin-path" => "/path/to/cgi-bin/trac.fcgi",
+                          "bin-path" => fcgi_binary,
                           "check-local" => "disable",
                           "bin-environment" =>
 …
                    ("trac" =>
                      ("socket" => "/tmp/trac-fastcgi.sock",
                       "bin-path" => "/path/to/cgi-bin/trac.fcgi",
+                      "bin-path" => fcgi_binary,
                       "check-local" => "disable",
                       "bin-environment" =>
 …
 使用言語指定の詳細については [http://trac.lighttpd.net/trac/wiki/TracFaq TracFaq] の 2.13 の質問を参照して下さい。
 その他重要な情報、例えば、 [http://trac.lighttpd.net/trac/wiki/TracInstall lighttpd の TracInstall] や、 [wiki:TracCgi#静的なリソースをマッピングする TracCgi] などは fast-cgi 固有ではありませんが、インストールの詳細をつかむのに有用でしょう。
+その他重要な情報、例えば、 [http://trac.lighttpd.net/trac/wiki/TracInstall lighttpd の TracInstall] や、 [wiki:TracCgi#MappingStaticResources TracCgi] などは fast-cgi 固有ではありませんが、インストールの詳細をつかむのに有用でしょう。
 trac-0.9 を使用している場合、[http://lists.edgewall.com/archive/trac/2005-November/005311.html 些細なバグ] について読んでください。
 …
 制限された権限で lighttpd を起動するにあたって気をつけること:
   もし、 trac.fcgi が lighttpd の設定で __server.username = "www-data"__ や __server.groupname = "www-data"__ を設定しても起動せずどうしようもないときは、 `bin-environment` セクションの `PYTHON_EGG_CACHE` を `www-data` のホームディレクトリまたは `www-data` アカウントで書き込みが可能なディレクトリに設定して下さい。 (訳注: debian 系 Linux に限定した話だと思われます。 `www-data` は lighttpd を起動するユーザに適宜読み替えてください。)
 == 簡単な [http://trac.edgewall.org/wiki/LiteSpeed LiteSpeeed] の設定 ==
+  もし、 trac.fcgi が lighttpd の設定で `server.username = "www-data"` や `server.groupname = "www-data"` を設定しても起動せずどうしようもないときは、 `bin-environment` セクションの `PYTHON_EGG_CACHE` を `www-data` のホームディレクトリまたは `www-data` アカウントで書き込みが可能なディレクトリに設定して下さい。 (訳注: debian 系 Linux に限定した話だと思われます。 `www-data` は lighttpd を起動するユーザに適宜読み替えてください。)
+== !LiteSpeed の簡単な設定 == #SimpleLighttpdConfiguration
 FastCGI フロントエンドは最初 [http://www.litespeedtech.com/ LiteSpeed] のような、 Apache 以外の Web サーバのために開発されました。
 [http://trac.edgewall.org/wiki/LiteSpeed LiteSpeed] Web サーバはイベント駆動、非同期型であり、Apache に代わるものとしてセキュアで拡張可能になるようにゼロからデザインされています。そして、最低限のリソースで操作できます。 [http://trac.edgewall.org/wiki/LiteSpeed LiteSpeed] は Apache の設定ファイルから直接操作でき、ビジネスに不可欠な環境をターゲットにしています。
+セットアップ
 ) 最初に Trac プロジェクトをインストールして動作することを確認して下さい。最初のインストールでは、 "tracd" を使用します。
 ) このセットアップでは仮想ホストを作成します。以下、この仮想ホストのことを !TracVhost と呼びます。このチュートリアルで、先ほど作ったプロジェクトが以下の URL 経由でアクセスできると仮定します:
+!LiteSpeed Web サーバはイベント駆動、非同期型であり、 Apache に代わるものとしてセキュアで拡張可能になるようにゼロからデザインされています。そして、最低限のリソースで操作できます。 !LiteSpeed は Apache の設定ファイルから直接操作でき、ビジネスに不可欠な環境をターゲットにしています。
+=== セットアップ ===
+. 最初に Trac プロジェクトをインストールして動作することを確認して下さい。最初のインストールでは、 "tracd" を使用します。
+. このセットアップでは仮想ホストを作成します。以下、この仮想ホストのことを !TracVhost と呼びます。このチュートリアルで、先ほど作ったプロジェクトが以下の URL 経由でアクセスできると仮定します:
 {{{
 …
 }}}
 ) "!TracVhost → External AApps" タブへ移動し、新しい "External Application" を作成します。
+. "!TracVhost → External Apps" タブへ移動し、新しい "External Application" を作成します。
 {{{
 …
 }}}
 ) (非必須) "!TracVhost → Security" タブへ移動し、新しいセキュリティ "Realm" を作成することができます。
+. (非必須) htpasswd ベースの認証を使用するならば、 "!TracVhost → Security" タブへ移動し、新しいセキュリティ "Realm" を作成することができます。
 {{{
 …
 もし、 htpasswd ファイルを持っていない、もしくは作り方を知らない場合は、 http://sherylcanter.com/encrypt.php にアクセスし、ユーザ名:パスワード の一対を生成して下さい。
 ) "!PythonVhost → Contexts" へ移動し、新しい "FCGI Context" を作成します。
+. "!PythonVhost → Contexts" へ移動し、新しい "FCGI Context" を作成します。
 {{{
 URI: /trac/                              <--- URI path to bind to python fcgi app we created
 Fast CGI App: [VHost Level] MyTractFCGI  <--- select the trac fcgi extapp we just created
 Realm: TracUserDB                        <--- only if (4) is set. select ream created in (4)
 }}}
 ) /fullpathto/mytracproject/conf/trac.ini を修正します。
+Realm: TracUserDB                        <--- only if (4) is set. select realm created in (4)
+}}}
+. /fullpathto/mytracproject/conf/trac.ini を修正します。
 {{{
 …
 }}}
+) [http://trac.edgewall.org/wiki/LiteSpeed LiteSpeed] を "lswsctrl restart" で再起動し、新しい Trac プロジェクトに以下の URL でアクセスします:
+. !LiteSpeed を "lswsctrl restart" で再起動し、新しい Trac プロジェクトに以下の URL でアクセスします:
 {{{
 …
 }}}
+== Nginx 簡単な設定 ==
+. Nginx 設定のスニペット - 0.6.32 で動作することを確認しました。
+{{{
+    server {
+        listen       10.9.8.7:443;
+        server_name  trac.example;
+        ssl                  on;
+        ssl_certificate      /etc/ssl/trac.example.crt;
+        ssl_certificate_key  /etc/ssl/trac.example.key;
+        ssl_session_timeout  5m;
+        ssl_protocols  SSLv2 SSLv3 TLSv1;
+        ssl_ciphers  ALL:!ADH:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP;
+        ssl_prefer_server_ciphers   on;
+        # (Or ``^/some/prefix/(.*)``.
+        if ($uri ~ ^/(.*)) {
+             set $path_info /$1;
+        }
+        # You can copy this whole location to ``location [/some/prefix]/login``
+        # and remove the auth entries below if you want Trac to enforce
+        # authorization where appropriate instead of needing to authenticate
+        # for accessing the whole site.
+        # (Or ``location /some/prefix``.)
+        location / {
+            auth_basic            "trac realm";
+            auth_basic_user_file /home/trac/htpasswd;
+            # socket address
+            fastcgi_pass   unix:/home/trac/run/instance.sock;
+            # python - wsgi specific
+            fastcgi_param HTTPS on;
+            ## WSGI REQUIRED VARIABLES
+            # WSGI application name - trac instance prefix.
+            # (Or ``fastcgi_param  SCRIPT_NAME  /some/prefix``.)
+            fastcgi_param  SCRIPT_NAME        "";
+            fastcgi_param  PATH_INFO          $path_info;
+            ## WSGI NEEDED VARIABLES - trac warns about them
+            fastcgi_param  REQUEST_METHOD     $request_method;
+            fastcgi_param  SERVER_NAME        $server_name;
+            fastcgi_param  SERVER_PORT        $server_port;
+            fastcgi_param  SERVER_PROTOCOL    $server_protocol;
+            fastcgi_param  QUERY_STRING     $query_string;
+            # for authentication to work
+            fastcgi_param  AUTH_USER          $remote_user;
+            fastcgi_param  REMOTE_USER        $remote_user;
+        }
+    }
+}}}
+. trac.fcgi の変更:
+{{{
+#!/usr/bin/env python
+import os
+sockaddr = '/home/trac/run/instance.sock'
+os.environ['TRAC_ENV'] = '/home/trac/instance'
+try:
+     from trac.web.main import dispatch_request
+     import trac.web._fcgi
+     fcgiserv = trac.web._fcgi.WSGIServer(dispatch_request,
+          bindAddress = sockaddr, umask = 7)
+     fcgiserv.run()
+except SystemExit:
+    raise
+except Exception, e:
+    print 'Content-Type: text/plain\r\n\r\n',
+    print 'Oops...'
+    print
+    print 'Trac detected an internal error:'
+    print
+    print e
+    print
+    import traceback
+    import StringIO
+    tb = StringIO.StringIO()
+    traceback.print_exc(file=tb)
+    print tb.getvalue()
+}}}
+. nginx をリロードし、 trac.fcgi をこのように起動します:
+{{{
+trac@trac.example ~ $ ./trac-standalone-fcgi.py
+}}}
+上記設定は以下の条件だと仮定します:
+ * trac のインスタンスを実行するためのユーザ名を 'trac' とします。ホームディレクトリに trac Environment をおきます。
+ * Trac environment は `/home/trac/instance` に配置します。
+ * `/home/trac/htpasswd` に認証情報が含まれています。
+ * `/home/trac/run` は nginx を起動しているグループが所有しています。
+  * Linux を使用しているならば、 `/home/trac/run` に (`chmod g+s run`) を設定します。
+  * [http://trac.edgewall.org/ticket/7239 本家チケット 7239] のパッチを適用し、ソケットファイルのパーミッションをそのつど修正しなければいけません。
+残念ですが、 nginx は fastcgi_pass ディレクティブ内の変数展開をサポートしていません。
+したがって、 1 つのサーバーブロックから複数の trac インスタンスを起動することができません。
+セキュリティ面で不安があるならば、 各 Trac インスタンスを別々のユーザで起動してください。
+Trac を FCGI の外部アプリケーションとして起動するもう一つの方法は、[http://trac.edgewall.org/ticket/6224 本家チケット 6224] を参照して下さい。
 ----
 See also: TracCgi, TracModPython, TracInstall, TracGuide
+See also:  TracGuide, TracInstall, [wiki:TracModWSGI ModWSGI], [wiki:TracCgi CGI], [wiki:TracModPython ModPython], [http://trac.edgewall.org/wiki/TracNginxRecipe TracNginxRecipe]