/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to doc/ja/user-guide/server.txt

  • Committer: Vincent Ladeuil
  • Date: 2012-01-18 14:09:19 UTC
  • mto: This revision was merged to the branch mainline in revision 6468.
  • Revision ID: v.ladeuil+lp@free.fr-20120118140919-rlvdrhpc0nq1lbwi
Change set/remove to require a lock for the branch config files.

This means that tests (or any plugin for that matter) do not requires an
explicit lock on the branch anymore to change a single option. This also
means the optimisation becomes "opt-in" and as such won't be as
spectacular as it may be and/or harder to get right (nothing fails
anymore).

This reduces the diff by ~300 lines.

Code/tests that were updating more than one config option is still taking
a lock to at least avoid some IOs and demonstrate the benefits through
the decreased number of hpss calls.

The duplication between BranchStack and BranchOnlyStack will be removed
once the same sharing is in place for local config files, at which point
the Stack class itself may be able to host the changes.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/ja/user-guide/server.txt
 
1
スマートサーバーを稼働させる
 
2
============================
 
3
 
 
4
BazaarはHTTP、FTPもしくはSFTPを通して動作するので特化したサーバーは\
 
5
必須ではありません。
 
6
SSH、inetd、もしくは専用モードで起動できるスマートサーバー(smart server)\
 
7
の選択肢があります。
 
8
 
 
9
ダムサーバー
 
10
-------------
 
11
 
 
12
HTTP、FTP、SFTPとHTTP-WebDAVを"ダム(dumb)"サーバーとして記述します。
 
13
これらはBazaarに支援を提供しないからです。
 
14
これらのプロトコルのどれかを通してBazaarリポジトリを利用できるようにする場合、
 
15
Bazaarはリモートからの読み込みを許可します。
 
16
実行しているBazaarコマンドの中でブランチへのURLを入力するだけです。::
 
17
 
 
18
    bzr log http://bazaar.launchpad.net/~bzr-pqm/bzr/bzr.dev
 
19
 
 
20
BazaarはFTP、SFTPと(プラグインを通した)HTTP-WebDAVを通した書き込みをサポートします。
 
21
 
 
22
ハイパフォーマンスなスマートサーバー
 
23
-------------------------------------
 
24
 
 
25
ハイパフォーマンスなスマートサーバー(hpss - high-performance smart server)は\
 
26
いくつかのオペレーションをダムサーバーよりも遙かに高速に実行します。
 
27
開発者がパフォーマンスのチューニングを継続するので、将来のリリースでは\
 
28
スマートサーバーを利用することで改善されるオペレーションの範囲は増えます。
 
29
 
 
30
高度なセキュリティの維持を可能にするために、
 
31
デフォルトでは現在のスマートサーバーはリードオンリーになります。
 
32
読み込みと書き込み権限を有効にするには、 ``--allow-writes`` で動かします。
 
33
SSHアクセスメソッドを利用するとき、bzrは ``--allow-writes`` オプションで\
 
34
自動的に実行します。
 
35
 
 
36
次はスマートサーバーの代替の設定方法を説明します。
 
37
 
 
38
SSH
 
39
~~~
 
40
 
 
41
SSHを通してBazaarを利用する際にサーバー上の特別な設定は必要ありません。
 
42
サーバーに Bazaar がインストールされていれば、 ``bzr+ssh`` の URL を
 
43
利用することができます。 例::
 
44
 
 
45
    bzr log bzr+ssh://host/path/to/branch
 
46
 
 
47
`bzr` がサーバーのシステムワイドな場所にインストールされていない場合、
 
48
リモートの `bzr` がどこにあるかをローカルの `bzr` に教える必要があるかも
 
49
しれません。 ::
 
50
 
 
51
    BZR_REMOTE_PATH=~/bin/bzr bzr log bzr+ssh://host/path/to/branch
 
52
 
 
53
``BZR_REMOTE_PATH`` 環境変数はリモートシステムで `bzr` が起動する方法を調整します。
 
54
デフォルトでは単に `bzr` として起動するので、 `bzr` 実行ファイルはデフォルトの\
 
55
検索パス上にあることが要求されます。
 
56
この設定を場所ごとの設定ファイルである ``locations.conf`` に書いて
 
57
永続化することもできます。
 
58
 
 
59
SFTP と同じく、 ``~`` で始まるパスはホームディレクトリからの相対パスになります。
 
60
例えば ``bzr+ssh://example.com/~code/proj`` のようになります。
 
61
加えて、 ``~user`` は user のホームディレクトリからの相対パスになります。
 
62
 
 
63
inetd
 
64
~~~~~
 
65
 
 
66
この例では ``/srv/bzr/repo/branchname`` にブランチがある ``/srv/bzr/repo`` 内の
 
67
共用リポジトリ用に専用ユーザーの `bzruser` で `bzr` を実行する方法を示しています。
 
68
 
 
69
inetdからBazaarサーバーを動かすにはinetd.confエントリが必要です::
 
70
 
 
71
    4155  stream  TCP  nowait  bzruser  /usr/bin/bzr /usr/bin/bzr serve --inet --directory=/srv/bzr/repo
 
72
 
 
73
クライアントコマンドを実行するとき、提供するURLは
 
74
inetd.confに渡される ``--directory`` オプションに相対的な `bzr://` です::
 
75
 
 
76
    bzr log bzr://host/branchname
 
77
 
 
78
可能であれば、 ``~`` や ``~user`` で始まるパスは ``bzr+ssh`` と同じように展開されますが、
 
79
``bzr serve`` に指定された ``--directory`` オプションの外にあるホームディレクトリには
 
80
アクセスできません。
 
81
 
 
82
専用サーバー
 
83
~~~~~~~~~~~~~
 
84
 
 
85
このモードはinetdモードと同じパスとURLのふるまいを持ちます。
 
86
特定のユーザーとして実行するには、 ``su`` を使うもしくはそのユーザーとしてログインします。
 
87
 
 
88
この例では公式のポート番号の `4155` 上でbzrを稼働しすべてのインターフェイス上でリスンします。
 
89
これによってポート `4155` 上のマシンに到達できる世界のどこからでも接続できます。
 
90
 
 
91
サーバー::
 
92
 
 
93
    bzr serve --directory=/srv/bzr/repo
 
94
 
 
95
クライアント::
 
96
 
 
97
    bzr log bzr://host/branchname
 
98
 
 
99
この例では `localhost` のポート `1234` で ``bzr serve`` が実行されます。
 
100
 
 
101
サーバー::
 
102
 
 
103
    bzr serve --port=localhost:1234 --directory=/srv/bzr/repo
 
104
 
 
105
クライアント::
 
106
 
 
107
    bzr log bzr://localhost:1234/branchname
 
108