4634.99.1
by Naoki INADA
import doc-ja rev90 |
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 を参照してください。 |