ビルドをキューに配置する
1 つ以上のビルド定義を作成することでビルド処理を定義したら、ビルド システムを活用することができます。 ほとんどのビルド処理は、自動トリガーで定義されます。 詳細については、「ビルド トリガーと理由の指定」を参照してください。
ビルド定義に手動トリガーと自動トリガーのどちらが含まれていても、必要な場合はいつでもビルドを手動でキューに配置することができます。
一般的なタスク |
関連する参照先 |
|---|---|
パブリック ビルドをキューに配置する: バージョン コントロール サーバーで、最新バージョンのソース コードをビルドする場合です。 コマンド プロンプトでパブリック ビルドをキューに配置するには、TFSBuild start コマンドを使用します。 |
|
プライベート ビルドをキューに配置する: シェルブセットに加える変更をビルドする場合です。 プライベート ビルド ("関連ビルド" とも呼ばれます) を使用すると、チェックイン前にコードの変更を検証できます。 コマンド プロンプトでプライベート ビルドをキューに配置するには、/shelveset オプションを付けて TFSBuild start コマンドを使用します。 |
パブリック ビルド
ビルド定義で自動トリガーが指定されているかどうかにかかわらず、ビルドを手動でキューに配置することができます。
必要なアクセス許可
この手順を実行するには、[ビルドをキューに挿入] のアクセス許可が [許可] に設定されている必要があります。 詳細については、「Team Foundation Server のアクセス許可」を参照してください。
Visual Studio からパブリック ビルドをキューに配置するには
チーム エクスプローラー で、適切なチーム プロジェクトをクリックします。
[ビルド] メニューの [新しいビルドをキューに配置] をクリックします。
[キュー ビルド TeamProjectName] ダイアログ ボックスが表示されます。
[ビルド定義] ボックスの一覧から、ビルド定義を選択します。
選択したビルド定義に説明が加えられている場合は、[ビルド定義] ボックスの一覧の下に説明が表示されます。
[ビルド対象の選択] ボックスの一覧で、[最新のソース] をオンのままにします。
(省略可能) [ビルド コントローラー] ボックスの一覧で、既定のビルド コントローラー以外のビルド コントローラーを選択します。
(省略可能) [キュー内の優先度] ボックスの一覧で、[高]、[標準以上]、[標準]、[標準以下]、[低] のいずれかをクリックします。
[位置] ボックスには、キュー内の推測されるビルドの位置が表示されます。
(省略可能) [このビルドの格納フォルダー] ボックスには、ビルド完了時にバイナリなどの出力が保存されるフォルダーが示されます。 出力を別の場所に保存する場合は、このボックスにその場所の汎用名前付け規則 (UNC) パスを入力してください。
重要
この値を変更する場合、格納フォルダーとして使用できるように準備したフォルダーを指定する必要があります。 詳細については、「ドロップ フォルダーのセットアップ」を参照してください。
(省略可能) [パラメーター] タブで、他のビルド定義設定を表示して、この実行に関してのみオーバーライドします。
ビルド定義が既定のテンプレートまたはアップグレード テンプレートに基づいている場合、これらのパラメーターの詳細については、「既定のテンプレートを使用してワークフロー ビルドを定義します。」または「アップグレード テンプレートを使用したレガシ MSBuild ビルドの使用」を参照してください。
[キューに登録] をクリックします。
ビルド エクスプローラーに [キューに挿入済み] タブが表示されます。 詳細については、「完了したビルドの管理と表示」を参照してください。
プライベート ビルド
シェルブセットに加える変更をビルドする場合は、プライベート ビルドをキューに配置します。 プライベート ビルド ("関連ビルド" とも呼ばれます) を使用すると、チェックイン前にコードの変更を検証できます。 チェックイン前に変更のプライベート ビルドを実行することで、チームが定期的に (夜間ビルドなど) 実行するビルドが中断する可能性を下げることができます。
プライベート ビルドとパブリック ビルドの違い
完了したプライベート ビルドの結果は、次の点で完了したパブリック ビルドと異なります。
プライベート ビルドは、シェルブセットでの変更が含まれるコードをビルドするゲート チェックイン ビルドと似ています。 ただし、プライベート ビルドの後は、ゲート チェックイン ビルドの後のように変更は自動的にチェックインされません。
次のビルド プロセス パラメーターは、False に設定されていると思われるため、ビルド定義で指定された設定にかかわらず効果はありません。
ソースのラベル作成
失敗時に作業項目を作成
変更セットと作業項目を関連付ける
ビルド エクスプローラーでは、完了したビルドが次のアイコンの横に表示されます。
.gif "ms181722.Icon_BldPrivateBuild(ja-jp,VS.100).gif")
完了したビルドには、Build N (N は一意の整数値) の形式を使用して名前が付けられます。 この形式は、[ビルド番号形式] パラメーターを使用して指定するパブリック ビルドの形式とは異なります。
ビルド定義ごとに、別個の (および必要に応じて異なる) アイテム保持ポリシーを指定して、システムに保存される完了したプライベート ビルドの数を制限します。
プライベート ビルドをキューに配置する
必要なアクセス許可
この手順を実行するには、[ビルドをキューに挿入] のアクセス許可が [許可] に設定されている必要があります。 詳細については、「Team Foundation Server のアクセス許可」を参照してください。
Visual Studio からプライベート ビルドをキューに配置するには
チーム エクスプローラー で、適切なチーム プロジェクトをクリックします。
[ビルド] メニューの [新しいビルドをキューに配置] をクリックします。
[キュー ビルド TeamProjectName] ダイアログ ボックスが表示されます。
[ビルド定義] ボックスの一覧から、ビルド定義を選択します。
選択したビルド定義に説明が加えられている場合は、[ビルド定義] ボックスの一覧の下に説明が表示されます。
[ビルド対象の選択] ボックスの一覧で、[シェルブセットを持つ最新のソース] を選択します。
[シェルブセット名] ボックスが表示されます。
次のいずれかの操作を実行します。
既存のシェルブセットがある場合は、その名前を [シェルブセット名] ボックスに入力するか、省略記号 ([…]) ボタンをクリックしてシェルブセットを検索します。
保留中の変更をワークスペースからシェルブセットに追加し、それらの変更をビルドするには、[作成] をクリックします。
(省略可能) ビルドが成功した場合にシェルブセットで変更をチェックインする場合は、[ビルド成功後に変更をチェックイン] チェック ボックスをオンにします。
重要
このチェック ボックスをオンにした場合、ビルドはプライベート ビルドではなくゲート チェックイン ビルドとして実行されます。 ゲート チェックイン ビルドの詳細については、「ゲート チェックイン ビルドの定義と変更内容の検証」を参照してください。
(省略可能) [ビルド コントローラー] ボックスの一覧で、既定のビルド コントローラー以外のビルド コントローラーを選択します。
(省略可能) [キュー内の優先度] ボックスの一覧で、[高]、[標準以上]、[標準]、[標準以下]、[低] のいずれかをクリックします。
[位置] ボックスには、キュー内の推測されるビルドの位置が表示されます。
(省略可能) 次の手順を実行して、ビルドの出力 (バイナリなど) がダウンロードされるフォルダーを指定します。
注意
プライベート ビルドでは効果がないため、[このビルドの格納フォルダー] ボックスは無視します。
[パラメーター] タブをクリックし、[詳細設定] グループを展開します。
[個人のビルドの格納場所] ボックスに、ビルドが完了したときに出力を保存するフォルダーの UNC パスを入力します。
注意
-
このフォルダーを指定しない場合、ビルドは失敗しませんが、ビルド ログに警告が記録されます。
-
この値を変更する場合、格納フォルダーとして使用できるように準備したフォルダーを指定する必要があります。 詳細については、「ドロップ フォルダーのセットアップ」を参照してください。
-
(省略可能) [パラメーター] タブで、他のビルド定義設定を表示して、この実行に関してのみオーバーライドします。
ビルド定義が既定のテンプレートまたはアップグレード テンプレートに基づいている場合、これらのパラメーターの詳細については、「既定のテンプレートを使用してワークフロー ビルドを定義します。」または「アップグレード テンプレートを使用したレガシ MSBuild ビルドの使用」を参照してください。
[キューに登録] をクリックします。
ビルド エクスプローラーに [キューに挿入済み] タブが表示されます。 詳細については、「完了したビルドの管理と表示」を参照してください。