~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: Martin Pool
  • Date: 2010-01-29 14:09:05 UTC
  • mto: This revision was merged to the branch mainline in revision 4992.
  • Revision ID: mbp@sourcefrog.net-20100129140905-2uiarb6p8di1ywsr
Correction to url

from review: https://code.edge.launchpad.net/~mbp/bzr/doc/+merge/18250

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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 を参照してください。