← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: John Arbash Meinel
  • Author(s): Mark Hammond
  • Date: 2008-09-09 17:02:21 UTC
  • mto: This revision was merged to the branch mainline in revision 3697.
  • Revision ID: john@arbash-meinel.com-20080909170221-svim3jw2mrz0amp3
An updated transparent icon for bzr.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/ja/user-guide/stacked.txt
1
 
スタックブランチを利用する
2
 
==========================
3
 
 
4
 
.. _motivation:
5
 
 
6
 
ユースケース
7
 
--------------
8
 
 
9
 
あるプロジェクトで作業しようとしていて、公開されているリポジトリに対して
10
 
読み込みアクセスはできるものの書き込みができないとしましょう。
11
 
公開されているリポジトリと同じホストで自分のブランチを公開したりバックアップ
12
 
したりする場合、スタックブランチを使うことができるかもしれません。
13
 
 
14
 
スタックブランチの他のユースケースとしては、実験的なブランチと、コード
15
 
ホスティングサイトが挙げられます。これらのシナリオではスタックブランチの
16
 
特性がぴったりあいます。
17
 
 
18
 
 
19
 
スタックブランチとは？
20
 
-------------------------
21
 
 
22
 
スタックブランチ(stacked branch)は別の(スタック先)ブランチのリビジョンを
23
 
見つける方法を知っています。
24
 
スタックブランチはスタック先ブランチには存在しないユニークなリビジョンのみを
25
 
保存することで、ブランチの作成を高速にしたり、ディスク利用効率を向上します。
26
 
これらの観点から、スタックブランチは共用リポジトリと似ています。
27
 
しかしながら、スタックブランチは追加の利点があります:
28
 
 
29
 
* 新しいブランチはスタックされたブランチとは完全に異なる位置に設置できます。
30
 
 
31
 
* スタックブランチを削除すれば(共用リポジトリだと残ってしまう)
32
 
  リビジョンの情報も削除されます
33
 
 
34
 
* セキュリティは共用リポジトリよりも向上しています。
35
 
  スタック先のリポジトリはスタックブランチにコミットする開発者に対して
36
 
  物理的にリードオンリーだからです。
37
 
 
38
 
 
39
 
スタックブランチを作成する
40
 
--------------------------
41
 
 
42
 
スタックブランチを作成するには、branchコマンドの ``stacked`` オプションを使用します。
43
 
例です::
44
 
 
45
 
  bzr branch --stacked source-url my-dir
46
 
 
47
 
このコマンドによって ``my-dir`` がローカルリビジョンなしのスタックブランチ\
48
 
として作成されます。
49
 
定義されると、 ``source-url`` に関連づけされた公開ブランチは
50
 
*スタックドオン(stacked on)* の位置として使われます。
51
 
さもなければ、 ``source-url`` は *スタックドオン* の位置になります。
52
 
 
53
 
 
54
 
スタックチェックアウトを作成する
55
 
-----------------------------------
56
 
 
57
 
スタックチェックアウトを直接作成する機能はまもなくサポートされる予定です。
58
 
それまでの間、2段階の処理が必要です:
59
 
 
60
 
1. 上記で示されたようにスタックブランチを作成する。
61
 
 
62
 
2. ``reconfigure`` もしくは ``bind`` コマンドのどちらかを利用して
63
 
   ブランチをチェックアウトに変換する。
64
 
 
65
 
 
66
 
スタックブランチをプッシュする
67
 
---------------------------------
68
 
 
69
 
多くのプロジェクトの大部分の変更は
70
 
*開発トランク* or *現在の安定* ブランチといった既存のブランチを基礎としています。
71
 
これらの1つにスタックされた新しいブランチの作成は ``push`` コマンドを利用して
72
 
次のように簡単にできます::
73
 
 
74
 
  bzr push --stacked-on reference-url my-url
75
 
 
76
 
このコマンドでは、 ``reference-url`` にスタックした新しいブランチを ``my-url``
77
 
に作成し、 ``reference-url`` には無いリビジョンだけをそこに格納します。
78
 
``my-url`` は ``reference-url`` と同じホストでも構いません。
79
 
 
80
 
.. The following text is hidden because bug 375013 breaks the example.
81
 
   When bug 375013 is fixed, we should unhide this text.
82
 
      - Andrew Bennetts, 10 March 2010
83
 
 
84
 
ローカルブランチがスタックブランチとして作成された場合、
85
 
``push`` するには ``--stacked`` オプションを使うことが可能で
86
 
スタック先の位置を省略できます。::
87
 
 
88
 
  bzr branch --stacked source-url my-dir
89
 
  cd my-dir
90
 
  (hack, hack, hack)
91
 
  bzr commit -m "fix bug"
92
 
  bzr push --stacked
93
 
 
94
 
この使い方は、上述したユースケースにマッチしています。
95
 
 
96
 
 
97
 
スタックブランチの制限
98
 
----------------------
99
 
 
100
 
スタックブランチに関して覚えておくべき大事なことは、ほとんど全ての\
101
 
オペレーションでスタック先ブランチが必要になることです。
102
 
これは両方のブランチがローカルもしくは同じサーバーにあるときは\
103
 
問題にはなりません。
104
 
 
105
 
また、ほとんどの履歴がスタック先リポジトリに格納されているので、スタック先
106
 
リポジトリへのアクセスがネットワーク経由だった場合に ``bzr log``
107
 
のようなコマンドが遅くなるかもしれません。
108
 
 
109
 
スタックするブランチを変更する
110
 
-------------------------------
111
 
 
112
 
``bzr reconfigure`` コマンドを使ってスタックドオンブランチを変更したり\
113
 
スタックするのをやめたりすることができます。
114
 
``bzr reconfigure --unstacked`` を実行した場合、bzrは全ての参照されているデータを\
115
 
スタックドオンブランチからスタックされていたブランチにコピーしてくることに\
116
 
注意してください。
117
 
大きなレポジトリにおいては、これは時間がかかったりリポジトリサイズを増大\
118
 
させたりします。