Changes between Version 2 and Version 3 of TracStandalone


Ignore:
Timestamp:
2012/06/16 22:07:38 (12 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracStandalone

    v2 v3  
    1 = Tracd = 
    2  
    3 Tracd は軽量なスタンドアロンの Trac Web サーバです。ほとんどのケースでは [wiki:TracCgi CGI] よりセットアップが簡単で、処理速度も速くなります。 
     1= Tracd = #Tracd 
     2 
     3Tracd は軽量なスタンドアロンの Trac web サーバです。 
     4Tracd は様々な場面で使用することができます。テストや開発用のサーバからロードバランサとして使用されているもう一つのウェブサーバの後段に複数のプロセスを配置するときなどに使われます。 
    45 
    56== 利点 == #Pros 
    67 
    7  * 依存性が低い: Apache その他 Web サーバをインストールする必要がありません。 
    8  * 速い: [wiki:TracModPython mod_python] バージョンと同じくらい速いでしょう。 ([wiki:TracCgi CGI] よりはずっと速い)。 
    9  * 自動リロード: 開発のために、 Tracd は ''auto_reload'' モードを使用しています。そのため、コード (Trac 自身またはプラグインのコード) を更新したときに、自動的にサーバが再起動します。 
     8 * 依存性が低い: apache その他 web サーバをインストールする必要がありません。 
     9 * 速い: [wiki:TracModPython mod_python] バージョンと同じくらい速いでしょう。 ([wiki:TracCgi CGI] よりはずっと速い)。そして、 バージョン 0.12 以降では、デフォルトで HTTP のバージョン 1.1 が使えるようになりました。 
     10 * 自動リロード: 開発のために、 Tracd は ''auto_reload'' モードを使用しています。そのため、コード ( Trac 自身またはプラグインのコード ) を更新したときに、自動的にサーバが再起動します。 
    1011 
    1112== 欠点 == #Cons 
    1213 
    13  * 機能が少ない: Tracd に実装されている Web サーバはとてもシンプルで、 Apache HTTPD のように拡張性のある設定ができません。 
     14 * 機能が少ない: Tracd に実装されている web サーバはとてもシンプルで、 Apache httpd のように拡張性のある設定ができません。 
    1415 * ネイティブで HTTPS に対応しない: 代わりに [http://www.rickk.com/sslwrap/ sslwrap] または 
    1516   [http://trac.edgewall.org/wiki/STunnelTracd stunnel -- tracd と stunnel を使うためのチュートリアル] または Apache の mod_proxy を使用します。 
     
    4243== Windows サービスとしてインストールする == #InstallingasaWindowsService 
    4344 
    44 Windows サービスとしてインストールするには [http://www.google.com/search?q=srvany.exe SRVANY] を取得して起動します: 
     45=== オプション 1 === #Option1 
     46Windows のサービスとしてインストールするには、 [http://www.google.com/search?q=srvany.exe SRVANY] ユーティリティを入手し起動します: 
    4547{{{ 
    4648 C:\path\to\instsrv.exe tracd C:\path\to\srvany.exe 
     
    5860空白には意味があります。そのまま入力して下さい。 
    5961 
     62{{{#!div 
     63一度、Windows サービスがインストールされると、上記の `reg add` コマンドを使用するよりも、レジストリエディタを起動するほうが簡単かもしれません。指定のパスへの移動:[[BR]] 
     64`HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\tracd\Parameters` 
     65 
     663 つの文字列のパラメータが提供されています: 
     67||!AppDirectory ||C:\Python26\ || 
     68||Application ||python.exe || 
     69||!AppParameters ||scripts\tracd-script.py -p 8080 ... || 
     70 
     71Note: もし !AppDirectory が上記のように設定されているならば、実行ファイル ''と'' スクリプトのパス、パラメータの値は、設定したフォルダへの相対パスになります。ここ一点に絞って言うと、これにより Python をアップデートするときに変更箇所が限定されるため少しだけ楽になります。 
     72(ドキュメントでは、 /full/path/to/htpasswd とフルパス指定するよう書いてあるかもしれませんが、これは、 .htpasswd ファイルについても同様のことが言えます;このファイルを Python ディレクトリ配下に配置したいと思わないかもしれません。) 
     73}}} 
     74 
     75Windows 7 ユーザは、 srvany.exe は使用できないかもしれません。代わりに [http://www.google.com/search?q=winserv.exe WINSERV] ユーティリティを使用して、起動してください: 
     76{{{ 
     77"C:\path\to\winserv.exe" install tracd -displayname "tracd" -start auto "C:\path\to\python.exe" c:\path\to\python\scripts\tracd-script.py <your tracd parameters>" 
     78 
     79net start tracd 
     80}}} 
     81 
     82=== オプション 2 === #Option2 
     83 
     84[http://trac-hacks.org/ Trac Hacks] より [http://trac-hacks.org/wiki/WindowsServiceScript WindowsServiceScript] を入手して下さい。 Trac のサービスを インストール、削除、開始、停止などできます。 
     85 
    6086== 認証を使用する == #UsingAuthentication 
    6187 
    62 tracd は Apache の .htpasswd ファイルを使用できます: 
    63  
    64 .htpasswd ファイルは htpasswd コマンドを使用して作成します: 
    65  
    66 {{{ 
    67 sudo htpasswd -c /path/to/env/.htpasswd username 
    68 }}} 
    69 ユーザを追加する場合は以下の通りです: 
    70 {{{ 
    71 sudo htpasswd /path/to/env/.htpasswd username2 
    72 }}} 
    73 tracd の起動オプションにファイルを指定してください: 
    74 {{{ 
    75 tracd -p 8080 --basic-auth=environmentname,/fullpath/environmentname/.htpasswd,/fullpath/environmentname /fullpath/environmentname 
    76 }}} 
    77  
    78  
    79 Tracd は基本認証とダイジェスト認証の両方に対応しています。デフォルトはダイジェスト認証です; 基本認証を使用するためには、以降の例で使用する `--auth` を `--basic-auth` に置き換えて下さい。 (ダイアログに使用する "realm" を指定しなければなりません。 BASICAUTH には カンマ を末尾に指定した空の文字列を指定することができます。) 
    80  
    81   ''基本認証への対応はバージョン 0.9 以降で追加されました。'' 
    82  
    83 認証を使用するための一般的なコマンドは以下の通りです: 
    84  
    85 {{{ 
    86  $ tracd -p port --auth=base_project_dir,password_file_path,realm project_path 
    87 }}} 
    88  
     88Tracd は基本認証とダイジェスト認証の両方に対応しています。ダイジェスト認証の方がより安全です。以降の例ではダイジェスト認証を使用しています。; 基本認証を使用するためには、下記のコマンドライン入力時に `--auth` を `--basic-auth` に置き換えて下さい。 
     89 
     90認証を使用する際の一般的なフォーマット: 
     91{{{ 
     92 $ tracd -p port --auth="base_project_dir,password_file_path,realm" project_path 
     93}}} 
    8994オプションについて: 
    90  
    91  * '''base_project_dir''' はプロジェクトのベースディレクトリ; Note: これはプロジェクト名ではありません。そして Windows の環境においても、大文字と小文字を区別します。 
    92  * '''password_file_path''' パスワードファイルのパス 
    93  * '''realm''' レルム 
    94  * '''project_path''' プロジェクトのパス 
    95  
    96 使用例: 
     95 * '''base_project_dir''': 下記の通りプロジェクトのベースのディレクトリを特定する: 
     96   * 複数のプロジェクトを立てているとき: `project_path` への ''相対パス'' 
     97   * 1 つのみプロジェクトを立てているとき (`-s` オプション使用): プロジェクトのディレクトリの名前 
     98 絶対パスを使用しないで下さい。 ''Note:'' このパラメータは、 Windows の環境であっても大文字小文字を区別します。 
     99 * '''password_file_path''': パスワードファイルへのパス 
     100 * '''realm''': realm の名前 ( なんでも指定できます ) 
     101 * '''project_path''': プロジェクトへのパス 
     102 
     103 * **`--auth`** 上記の例では、ダイジェスト認証を使用しています。基本認証を使用する際は `--auth` を `--basic-auth` に置き換えてください。基本認証は "realm" を必要としませんが、コマンドとしては、最後の引用句に空のレルム名前が直接続くことになるので、2つ目のコンマは必要になります。  
     104 
     105例: 
    97106 
    98107{{{ 
    99108 $ tracd -p 8080 \ 
    100    --auth=project1,/path/to/users.htdigest,mycompany.com /path/to/project1 
    101 }}} 
    102 もちろん、ダイジェストファイルは複数のプロジェクト間で共有することが出来ます: 
     109   --auth="project1,/path/to/passwordfile,mycompany.com" /path/to/project1 
     110}}} 
     111 
     112もちろん、パスワードファイルは 1 つ以上のプロジェクトで共有することができます。 
    103113{{{ 
    104114 $ tracd -p 8080 \ 
    105    --auth=project1,/path/to/users.htdigest,mycompany.com \ 
    106    --auth=project2,/path/to/users.htdigest,mycompany.com \ 
     115   --auth="project1,/path/to/passwordfile,mycompany.com" \ 
     116   --auth="project2,/path/to/passwordfile,mycompany.com" \ 
    107117   /path/to/project1 /path/to/project2 
    108118}}} 
    109119 
    110 ダイジェストファイルを共有するもうひとつの方法は、プロジェクトの名前に "*"  
    111 を指定することです: 
     120パスワードファイルを共有するもう一つの方法として、プロジェクトの名前を指定するところで、 "*" を使用します: 
    112121{{{ 
    113122 $ tracd -p 8080 \ 
    114    --auth="*",/path/to/users.htdigest,mycompany.com \ 
     123   --auth="*,/path/to/users.htdigest,mycompany.com" \ 
    115124   /path/to/project1 /path/to/project2 
    116125}}} 
    117 `-s` パラメータを使用すると、一つの Trac environment をドメインのルートとして提供するようになり、プロジェクト名として `*` を使用せねばなりません。 
    118  
    119 == htdigest パスワードファイルの設定方法 == #Howtosetupanhtdigestpasswordfile 
     126 
     127=== 基本認証: htpasswd パスワードを使用する === #BaseicAuthorizationUsingahtpasswdpasswordfile 
     128このセクションでは、 `tracd` と Apache の .htpasswd ファイルの使用方法について記述します。 
     129 
     130Apache の `htpasswd` コマンドを使用して、 .htpasswd ファイルを作成します。 ( Apache を使用せずにこれらのファイルを作成する方法については [#GeneratingPasswordsWithoutApache 下記] を参照して下さい): 
     131{{{ 
     132 $ sudo htpasswd -c /path/to/env/.htpasswd username 
     133}}} 
     134そしてユーザを追加します。 
     135{{{ 
     136 $ sudo htpasswd /path/to/env/.htpasswd username2 
     137}}} 
     138 
     139そして、 `tracd` をこのように起動します: 
     140{{{ 
     141 $ tracd -p 8080 --basic-auth="projectdirname,/fullpath/environmentname/.htpasswd,realmname" /fullpath/environmentname 
     142}}} 
     143 
     144例: 
     145{{{ 
     146 $ tracd -p 8080 --basic-auth="testenv,/srv/tracenv/testenv/.htpasswd,My Test Env" /srv/tracenv/testenv 
     147}}} 
     148''Note:'' いくつかのプラットフォーム (OpenBSD) では、htpasswd に "-m" をパラメータで渡す必要があるかもしれません。 
     149 
     150=== ダイジェスト認証: htdigest パスワードファイルの設定方法 === #DigestauthentitionUsingahtdigestpasswordfile 
    120151 
    121152もし、 Apache がインストールされているなら、パスワードファイルを生成するのに、 htdigest コマンドを使用することができます。 'htdigest' とタイプして使用方法を見るか、詳細な使用方法を見るために Apache のマニュアルの [http://httpd.apache.org/docs/2.0/programs/htdigest.html このページ] を読んでください。ユーザを作成するたびに、パスワードを入力するように求められます。パスワードファイルの名前には好きな名前をつけることができますが、 `users.htdigest` というような名前にしておけば、ファイルに何が含まれているかを覚えておけるでしょう。このファイルは <projectname>/conf フォルダに [TracIni trac.ini] ファイルと一緒に置いておくとよいでしょう。 
     
    123154引数 --auth なしで tracd をスタートできることに注意して下さい。ただし、 ''ログイン'' (英語版では ''Login'') リンクをクリックするとエラーになります。 
    124155 
    125 == Apache 以外の環境でパスワードを生成する == #GeneratingPasswordsWithoutApache 
    126  
    127 もし Apache が使用できない場合でも、簡単な Python スクリプトでパスワードを生成できます: 
     156=== Apache 以外の環境でパスワードを生成する === #GeneratingPasswordsWithoutApache 
     157 
     158基本認証は [http://www.4webhelp.net/us/password.php online HTTP Password generator] を用いて完成させることができます。生成した password-hash をシステムの .htpasswd ファイルにコピーします。 
     159 
     160簡単な Python スクリプトで '''digest''' 認証のパスワードファイルを生成できます: 
    128161 
    129162{{{ 
     
    159192}}} 
    160193 
    161 Note: もし tracd を --basic-auth ではなくて、 --auth オプションを使用して起動するときに、上記のスクリプトを使わないといけないとしたら --auth の値に 'trac' を(シングルクォートなしで) 指定し、レルムを設定しなければなりません。(上記スクリプトを trac-digest.py として保存したとします) 
    162  
    163 {{{ 
    164 python trac-digest.py -u username -p password >> c:\digest.txt 
    165 tracd --port 8000 --auth=proj_name,c:\digest.txt,trac c:\path\to\proj_name 
    166 }}} 
    167  
    168 Note: --basic-auth を使用したければ、 .htpasswd ファイルを作成するのに Apache サーバの htpasswd ツールを使用する必要があります。 他の部分についてはダイジェスト認証を行う場合とほとんど同じ方法です。しかしレルムには必ず empty 値 (すなわち、パス後のカンマのみ) を指定するようにしてください。 Windows で使用する場合は必ず -m オプションを使用してください。 (*nix ではテストしなかったので、その場合は不明です) Apache がない環境では、 [http://trac.edgewall.org/browser/tags/trac-0.11b2/contrib/htpasswd.py htpasswd.py] を使うとよいでしょう。 (このスクリプトは `crypt` か `fcrypt` モジュールが必要です; ソースのコメントに詳細が書いてあります。) 
    169  
    170 md5sum ユーティリティを使用するとダイジェストパスワードを作成することができます: 
     194Note: 上記のスクリプトを使用する場合、 --auth の引数に '''`trac`''' を指定し、レルムを設定しなければなりません。使用例 (上記スクリプトを trac-digest.py として保存したとします): 
     195 
     196{{{ 
     197 $ python trac-digest.py -u username -p password >> c:\digest.txt 
     198 $ tracd --port 8000 --auth=proj_name,c:\digest.txt,trac c:\path\to\proj_name 
     199}}} 
     200 
     201==== `md5sum` を使用する 
     202`md5sum` ユーティリティを使用するとダイジェスト認証のパスワードファイルを作成することができます: 
    171203{{{ 
    172204 $ printf "${user}:trac:${password}" | md5sum - >>user.htdigest 
    173205}}} 
    174206'to-file' は手で編集が必要です。行末の " -" を削除し、行頭に "${user}:trac:" を追加してください。 
     207 
     208== リファレンス == #Reference 
     209 
     210これはリマインダとして、オンラインヘルプです。 (`tracd --help`): 
     211{{{ 
     212Usage: tracd [options] [projenv] ... 
     213 
     214Options: 
     215  --version             show program's version number and exit 
     216  -h, --help            show this help message and exit 
     217  -a DIGESTAUTH, --auth=DIGESTAUTH 
     218                        [projectdir],[htdigest_file],[realm] 
     219  --basic-auth=BASICAUTH 
     220                        [projectdir],[htpasswd_file],[realm] 
     221  -p PORT, --port=PORT  the port number to bind to 
     222  -b HOSTNAME, --hostname=HOSTNAME 
     223                        the host name or IP address to bind to 
     224  --protocol=PROTOCOL   http|scgi|ajp 
     225  -q, --unquote         unquote PATH_INFO (may be needed when using ajp) 
     226  --http10              use HTTP/1.0 protocol version (default) 
     227  --http11              use HTTP/1.1 protocol version instead of HTTP/1.0 
     228  -e PARENTDIR, --env-parent-dir=PARENTDIR 
     229                        parent directory of the project environments 
     230  --base-path=BASE_PATH 
     231                        the initial portion of the request URL's "path" 
     232  -r, --auto-reload     restart automatically when sources are modified 
     233  -s, --single-env      only serve a single project without the project list 
     234}}} 
    175235 
    176236== Tips == #Tips 
     
    187247例: ファイル名が `$TRAC_ENV/htdocs/software-0.1.tar.gz` だったとき、 
    188248対応する URL は `/<project_name>/chrome/site/software-0.1.tar.gz` となります。 
    189 Wiki には、相対リンクシンタックスを使用して、  
    190 `[/<project_name>/chrome/site/software-0.1.tar.gz]` と書くことができます。 (訳注: `[/chrome/site/software-0.1.tar.gz]` が正しい) 
    191  
    192 Trac の開発バージョンでは新しく `htdocs:` に対応します。 TracLinks は 
    193 上記のようなシンタックスになります。これによって、上記の例のリンクはただ単に  
    194 `htdocs:software-0.1.tar.gz` と書くことができます。 
    195  
    196 === Apache の書き換え規則を使用する === #Usingapacherewriterules 
    197 Apache のビハインドで tracd を使用すると、いくつかの状況で不正なホストまたはプロトコルに URL をリダイレクトされる問題が発生するかもしれません。この場合 (この場合だけ) `[trac] use_base_url_for_redirect` を `true` に設定することができます。これによって Trac がやむを得ず `[trac] base_url` の値を使用するためリダイレクトを行います。 
    198  
    199 === 検索パスとは別のベースパス (/) === #Servingadifferentbasepaththan 
    200 Tracd は、プロジェクト毎に異なるベース URL 、および /<project> をサポートします。コマンドは以下の通りです。 
     249代わりに `htdocs:software-0.1.tar.gz` (TracLinks のシンタックス) や `[/<project_name>/chrome/site/software-0.1.tar.gz]` (相対リンクのシンタックス) で記述することができます。 
     250 
     251 ''TracLinks における `htdocs:` のサポートは Trac のバージョン 0.10 で追加されました。'' 
     252 
     253=== tracd をプロキシの背後で使用する #Usingtracdbehindaproxy 
     254 
     255ある状況において tracd を Apache もしくは他のウェブサーバの背後で使用するときについてです。 
     256 
     257この状況において、間違ったホストやプロトコルにリダイレクトされてしまったなどの経験があるかもしれません。この場合 (そして、この場合に限って) `[trac] use_base_url_for_redirect` を `true` に設定することによって、リダイレクトを行なう際 Trac に `[trac] base_url` の値を強制的に使用させることができます。 
     258 
     259もし、`tracd` に接続するために AJP プロトコルを使用しているならば (flup をインストールしているならば可能です) 、ダブルクオテーションの問題にぶつかったことがあるかもしれません。その際は、 `--unquote` パラメータを追加することを考えてください。 
     260 
     261See also [http://trac.edgewall.org/wiki/TracOnWindowsIisAjp TracOnWindowsIisAjp], [http://trac.edgewall.org/wiki/TracNginxRecipe TracNginxRecipe]. 
     262 
     263===  / (root) とは異なるベースパスで起動する === #Servingadifferentbasepaththan 
     264Tracd は /<project> とは異なるベース URL でプロジェクトを提供することをサポートします。変更するためのパラメータは以下の通りです 
    201265{{{ 
    202266 $ tracd --base-path=/some/path 
     
    204268 
    205269---- 
    206 See also: TracInstall, TracCgi, TracModPython, TracGuide, [http://trac.edgewall.org/wiki/TracOnWindowsStandalone?version=13#RunningTracdasservice tracd.exe を Windows のサービスとして起動する] 
     270See also: TracInstall, TracCgi, TracModPython, TracGuide, [trac:TracOnWindowsStandalone#RunningTracdasservice Running tracd.exe as a Windows service]