ビルドをキューに配置する

1 つ以上のビルド定義を作成することでビルド プロセスを定義すると、ビルド システムを活用することができます。ほとんどのビルド処理は自動 トリガーとして定義されます。ビルド定義に手動トリガーと自動トリガーのどちらが含まれていても、必要な場合はいつでもビルドを手動でキューに配置することができます。

一般的なタスク	関連する参照先
パブリック ビルドをキューに配置する: バージョン コントロール サーバーで、最新バージョンのソース コードをビルドする場合です。 コマンド プロンプトでパブリック ビルドをキューに配置するには、TFSBuild start コマンドを使用します。	パブリック ビルド Start コマンド (Team Foundation ビルド)
プライベート ビルドをキューに配置する: シェルブセットに加える変更をビルドする場合です。プライベート ビルド ("関連ビルド" とも呼ばれます) を使用すると、チェックイン前にコードの変更を検証できます。 コマンド プロンプトでプライベート ビルドをキューに配置するには、/shelveset オプションを付けて TFSBuild start コマンドを使用します。	プライベート ビルド Start コマンド (Team Foundation ビルド)
完了したビルドと同じオプションを使用してパブリック ビルドまたはプライベート ビルドをキューに入れるには、[完了したビルドの再試行] を選択します。	完了したビルドの再試行

パブリック ビルド

ビルド定義で自動トリガーが指定されているかどうかにかかわらず、ビルドを手動でキューに配置することができます。

必要なアクセス許可

この手順を実行するには、[ビルドをキューに挿入] の [許可]、のアクセス許可がに設定されている必要があります。詳細については、「Team Foundation Server のアクセス許可」を参照してください。

Visual Studio からパブリック ビルドをキューに配置するには

1. チーム エクスプローラーで、次の作業を行います。

   1. 作業するチーム プロジェクトにまだ接続されていない場合は、チーム プロジェクトに接続します。

   2. [ホーム] を選択し、[ビルド] を選択します。

   3. [ビルド] ページの [お気に入りのビルド定義] または [すべてのビルド定義] で、ビルド定義のショートカット メニューを開き、[新しいビルドをキューに配置] を選択します。

   [キュー ビルドTeamProjectName] ダイアログ ボックスが表示されます。

2. [ビルド定義] リストでは、ビルド定義が選択され、その説明が下に表示されます。別のビルド定義をキューに配置する場合は、リストから 1 つ選択できます。

3. [ビルド対象の選択] ボックスの一覧で、[最新のソース] をオンのままにします。

4. (省略可能) [ビルド コントローラー] ボックスの一覧で、既定のビルド コントローラー以外のビルド コントローラーを選択します。

5. (省略可能) [キュー内の優先度] ボックスの一覧で、[高]、[標準以上]、[標準]、[標準以下]、[低] のいずれかをクリックします。

   [位置] ボックスには、キュー内の推測されるビルドの位置が表示されます。

6. (省略可能) [このビルドの格納フォルダー] ボックスには、ビルドが完了すると、binary、ログ ファイルなどの出力が保存される位置を表示します。出力を別の場所に保存する場合は、このボックスにその場所のパスを入力してください。

   重要
   この値を変更する場合、格納フォルダーとして使用できるように準備したフォルダーを指定する必要があります。ビルド定義には、ステージング位置として [ビルド出力をサーバーにコピーする] を指定した場合は、この値を変更できません。 「ドロップ フォルダーのセットアップ」を参照してください。

7. (省略可能) [パラメーター] タブで、他のビルド定義設定を表示して、この実行に関してのみオーバーライドします。

   ビルド定義が既定テンプレートまたはアップグレード テンプレートに基づいている場合、これらのパラメーターの詳細については、「既定テンプレートに基づくビルド プロセスの定義」または「レガシ ビルド プロセスの使用」を参照してください。

8. [キュー] を選択します。

プライベート ビルド

シェルブセットに加える変更をビルドする場合は、プライベート ビルドをキューに配置します。プライベート ビルド ("関連ビルド" とも呼ばれます) を使用すると、チェックイン前にコードの変更を検証できます。変更のプライベート ビルドを実行してチェックインする前に、チームが定期的に実行する夜間ビルドなどのビルドが中断する可能性を減らすことができます。

プライベート ビルドとパブリック ビルドの違い

完了したプライベート ビルドの結果は、次の点で完了したパブリック ビルドと異なります。

• プライベート ビルドは、シェルブセットでの変更が含まれるコードをビルドするゲート チェックイン ビルドと似ています。ただし、プライベート ビルドの後は、ゲート チェックイン ビルドの後のように変更は自動的にチェックインされません。

• 次のビルド プロセス パラメーターは、False に設定されていると思われるため、ビルド定義で指定された設定にかかわらず効果はありません。

  • ソースのラベル作成

  • 失敗時に作業項目を作成

  • 変更セットと作業項目を関連付ける

• ビルド エクスプローラーでは、完了したビルドが次のアイコンの横に表示されます。

• 完了したビルドはファイル形式 BuildN を使用して N は一意の整数値です。ではという名前です。この形式は、[ビルド番号形式] パラメーターを使用して指定するパブリック ビルドの形式とは異なります。

• ビルド定義ごとに、別個の (および必要に応じて異なる) アイテム保持ポリシーを指定して、システムに保存される完了したプライベート ビルドの数を制限します。

プライベート ビルドをキューに配置する

必要なアクセス許可

この手順を実行するには、[ビルドをキューに挿入] の [許可]、のアクセス許可がに設定されている必要があります。詳細については、「Team Foundation Server のアクセス許可」を参照してください。

Visual Studio からプライベート ビルドをキューに配置するには

1. チーム エクスプローラーで、次の作業を行います。

   1. 作業するチーム プロジェクトにまだ接続されていない場合は、チーム プロジェクトに接続します。

   2. [ホーム] を選択し、[ビルド] を選択します。

   3. [ビルド] ページの [お気に入りのビルド定義] または [すべてのビルド定義] で、ビルド定義のショートカット メニューを開き、[新しいビルドをキューに配置] を選択します。

   [キュー ビルドTeamProjectName] ダイアログ ボックスが表示されます。

2. [ビルド定義] リストでは、ビルド定義が選択され、その説明が下に表示されます。別のビルド定義をキューに配置する場合は、リストから 1 つ選択できます。

3. [ビルド対象の選択] ボックスの一覧で、[シェルブセットを持つ最新のソース] を選択します。

   [シェルブセット名] ボックスが表示されます。

4. 次のいずれかの手順を実行します。

   • 既存のシェルブセットがある場合は、その名前を [シェルブセット名] ボックスに入力するか、省略記号 ([…]) ボタンを選択してシェルブセットを検索します。

   • 保留中の変更をワークスペースからシェルブセットに追加し、それらの変更をビルドするには、[作成] を選択します。

5. (省略可能) ビルドが成功した場合にシェルブセットで変更をチェックインする場合は、[ビルド成功後に変更をチェックイン] チェック ボックスをオンにします。

   重要
   このチェック ボックスをオンにした場合、ビルドはプライベート ビルドではなくゲート チェックイン ビルドとして実行されます。ゲート チェックイン ビルドの詳細については、「変更内容を検証するためのゲート チェックイン ビルド プロセスの定義」を参照してください。

6. (省略可能) [ビルド コントローラー] ボックスの一覧で、既定のビルド コントローラー以外のビルド コントローラーを選択します。

7. (省略可能) [キュー内の優先度] ボックスの一覧で、[高]、[標準以上]、[標準]、[標準以下]、[低] のいずれかをクリックします。

   [位置] ボックスには、キュー内の推測されるビルドの位置が表示されます。

8. (省略可能)、ビルドの出力 (binary など、ダウンロードするフォルダーを指定するには、次の手順を実行する:

   [!メモ]

   プライベート ビルドでは効果がないため、[このビルドの格納フォルダー] ボックスは無視します。

   1. [パラメーター] タブを選択し、[詳細設定] グループを展開します。

   2. [個人のビルドの格納場所] ボックスに、ビルドが完了したときに出力を保存するフォルダーの UNC パスを入力します。

      [!メモ]

      • このフォルダーを指定しない場合、ビルドは失敗しませんが、ビルド ログに警告が記録されます。

      • この値を変更する場合、格納フォルダーとして使用できるように準備したフォルダーを指定する必要があります。詳細については、「ドロップ フォルダーのセットアップ」を参照してください。

9. (省略可能) [パラメーター] タブで、他のビルド定義設定を表示して、この実行に関してのみオーバーライドします。

   ビルド定義が既定テンプレートまたはアップグレード テンプレートに基づいている場合、これらのパラメーターの詳細については、「既定テンプレートに基づくビルド プロセスの定義」または「レガシ ビルド プロセスの使用」を参照してください。

10. [キュー] を選択します。

完了したビルドの再試行

ビルド プロセスに変更を加える可能性をテストしたり、オプションを試したりする場合は、現在完了しているビルドをキューに配置したときに指定したのと同じオプションを使用して、パブリック ビルドまたはプライベート ビルドをすばやくキューに配置できます。

ビルド ページからの完了したビルドを再試行するには

• チーム エクスプローラーで、次の作業を行います。

  1. 作業するチーム プロジェクトにまだ接続されていない場合は、チーム プロジェクトに接続します。

  2. [ホーム] を選択し、[ビルド] を選択します。

  3. [ビルド] ページの [マイ ビルド] で、完了したビルドのショートカット メニューを開き、[ビルドの再試行] を選択します。