← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

Unfuck upgrade.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/ja/user-guide/svn_plugin.txt
1
 
bzr-svn
2
 
=======
3
 
 
4
 
概要
5
 
-----
6
 
 
7
 
bzr-svnによって集中型のSubversionリポジトリをまだ利用しているプロジェクトで\
8
 
BazaarをVCSクライアントとして使うことができます。
9
 
Subversionリポジトリへのアクセスは大部分は透明、\
10
 
すなわちネイティブのBazaarブランチで ``bzr`` を使用するようにSubversion\
11
 
リポジトリで大部分の ``bzr`` コマンドを直接利用できます。
12
 
 
13
 
多くのbzr-svnユーザーは集中型のSubversionトランクのローカルミラーを作成し、\
14
 
機能ブランチに取り組み、準備ができたときに変更をすべててSubversionに戻します。
15
 
これによって既存のチーム規模のプロセスとSubversionの上に現在組み込まれている\
16
 
ツール統合フックを妨げずに分散型VCSツールの多くの利点を得られます。
17
 
本当に、これはBazaarを採用しようとしているがタイミングもしくは非技術的な\
18
 
利用からまだ採用していないチームのための共通の暫定ステップです
19
 
 
20
 
インストールの手引きに関しては、bzr-svnのホームページをご覧ください:
21
 
http://bazaar-vcs.org/BzrForeignBranches/Subversion.
22
 
 
23
 
 
24
 
シンプルな例
25
 
-------------
26
 
 
27
 
GNOMEプロジェクトの **beagle** でのシンプルな使い方です。
28
 
最初に、ブランチの保存用のローカルな共用リポジトリをセットアップして\
29
 
トランクをチェックアウトします::
30
 
 
31
 
  bzr init-repo --rich-root-pack beagle-repo
32
 
  cd beagle-repo
33
 
  bzr checkout svn+ssh://svn.gnome.org/svn/beagle/trunk beagle-trunk
34
 
 
35
 
 
36
 
``init-repo`` に対して ``rich-root-pack`` オプションを使うことが重要です。
37
 
bzr-svnは追加のメタデータがいくつか必要ですが、Bazaarのデフォルトのリポジトリフォーマットではまだサポートされないからです。
38
 
(訳注: Bazaar 2.0以降を使っているのであれば、 --rich-root-pack オプションは不要です。)
39
 
次に、フィーチャブランチを作成してハックします::
40
 
 
41
 
  bzr branch beagle-trunk beagle-feature1
42
 
  cd beagle-feature1
43
 
  (hack, hack, hack)
44
 
  bzr commit -m "blah blah blah"
45
 
  (hack, hack, hack)
46
 
  bzr commit -m "blah blah blah"
47
 
 
48
 
機能がクックされたとき、トランクをリフレッシュして変更をマージします::
49
 
 
50
 
  cd ../beagle-trunk
51
 
  bzr update
52
 
  bzr merge ../beagle-feature1
53
 
  bzr commit -m "Complete comment for SVN commit"
54
 
 
55
 
トランクミラーはチェックアウトなので、それにコミットすれば実際のSubversionトランクにコミットされます。
56
 
以上です！
57
 
 
58
 
 
59
 
集中型のミラーを利用する
60
 
-------------------------
61
 
 
62
 
大きなプロジェクトに関しては、上記のレシピを調整すれば役立つことがしばしあります。
63
 
とりわけ、初期のチェックアウトはとても遅い可能性があるので\
64
 
プロジェクトに関するすべてのSubversionリポジトリをBazaarリポジトリに一旦インポートして、
65
 
そのネイティブのBazaarリポジトリからブランチを作成します。
66
 
bzr-svnはリポジトリからリポジトリへの変換を行うために ``svn-import`` コマンドを提供します。
67
 
使い方の例です::
68
 
 
69
 
  bzr svn-import svn+ssh://svn.gnome.org/svn/beagle
70
 
 
71
 
中央のBazaarミラーを利用するために更新された上記からのレシピです::
72
 
 
73
 
  bzr init-repo --rich-root-pack beagle-repo
74
 
  cd beagle-repo
75
 
  bzr branch bzr+ssh://bzr.gnome.org/beagle.bzr/trunk beagle-trunk
76
 
  bzr branch beagle-trunk beagle-feature1
77
 
  cd beagle-feature1
78
 
  (hack, hack, hack)
79
 
  bzr commit -m "blah blah blah"
80
 
  (hack, hack, hack)
81
 
  bzr commit -m "blah blah blah"
82
 
  cd ../beagle-trunk
83
 
  bzr pull
84
 
  bzr merge ../beagle-feature1
85
 
  bzr commit -m "Complete comment for SVN commit"
86
 
  bzr push
87
 
 
88
 
この場合、トランクへのコミットをしてもローカルでマージをコミットするだけです。
89
 
マスターのSubversionトランクにコミットを戻すには、追加コマンド(``bzr push``)が必要です。
90
 
 
91
 
注:  トランクブランチで ``pull`` と ``push`` のコマンドを最初に使う際に
92
 
これらのコマンドに関連URLを渡す必要があります。
93
 
その後で、bzrはそれらを記憶します。
94
 
 
95
 
このセットアップの最後のピースはSubversionのものと同期される中心のBazaarミラーを\
96
 
Subversionのリポジトリと同期し続けるためにスクリプトを適切な場所に設置することです。
97
 
これはcronジョブを追加したり、Subversionフックを利用するなどによって行われます。
98
 
 
99
 
 
100
 
bzr-svnの制限
101
 
--------------
102
 
 
103
 
BazaarとはSubversionは異なる機能を持つ異なるツールなので\
104
 
何らかの相互運用問題が常に存在します。
105
 
bzr-svn 0.5.4 に関するいくつかの例です:
106
 
 
107
 
 * Bazaarはversioned propertiesをサポートしません
108
 
 
109
 
 * Bazaarはファイルのコピーのトラッキングをサポートしません
110
 
 
111
 
現在の制約の一覧に関しては、bzr-svnのウェブページ、\
112
 
http://bazaar-vcs.org/BzrForeignBranches/Subversion を参照してください。