ビルド ワークスペースの使用
、次のように dev 自分のコンピューターのワークスペース を使用するアプリケーションを開発することを必要とする独自のアプリケーションをビルドおよびテストに使用するビルド エージェントがワークスペースを指定する必要があります。
目的に合ったトピックをクリックしてください
ビルド定義のワークスペースにを指定します。
ビルド定義のワークスペースの例を参照してください。
ワークスペース間のデータのコピー
ビルド ワークスペースのしくみを理解します。
ビルド定義のワークスペースにを指定します。
ワークスペースを指定すると ビルド処理を定義します。のベスト プラクティスに従う必要があります。
必要なフォルダーをすべて含める。
必ず、ビルド処理に必要なファイルが存在するすべてのフォルダーを含めてください。たとえば、[プロセス] のタブの [ビルドする項目] のフィールドに別のソリューションを追加すると、ワークスペースに別のマッピングを追加する必要がある場合があります。
必要なフォルダーのみ含める。
[アクティブ] の [状態] の値をにしてマップ、ビルド処理が必要なフォルダーのみ。マップされたフォルダーのサブフォルダーに、ビルド処理が必要ないファイルが含まれている場合、[クローク] の [状態] の値にマップします。多くの状況では、ビルド定義を作成するとき、チーム プロジェクトのルート フォルダーがワークスペースでマップされます。この構成では、ビルド エージェントが、チーム プロジェクトのバージョン コントロール フォルダーですべてのファイルをダウンロードします。このフォルダーに多くのデータが含まれている場合、ビルドはビルド システム リソースが浪費され、要求せず、大量のデータをダウンロードして、ビルド処理が低下する可能性があります。
[プロセス] タブの [ビルドする項目] フィールドから項目を削除するときは、ワークスペースから削除できるマッピングを探します。
.gif "ヒント") ヒント |
|---|
ワークスペースの最適化に関する詳細については、ワークスペースの最適化"を参照してください。 |
$(SourceDir) トークンを使用して、サーバー フォルダーを .. \Sources サブディレクトリのローカル フォルダーに対マップする。
ほとんどの場合、ビルド エージェント上のソース ファイルに最適な場所は、作業ディレクトリにある ..\Sources サブディレクトリの下です。この場所は、[ビルド エージェント フォルダー] ボックスで $(SourceDir) トークンを使用することで指定できます。
チェックインによりトリガーされるビルド定義にワークスペースが与える影響に注意する。
ビルド定義の [トリガー] を [継続的インテグレーション]、[ビルドのロール]、または [ゲート チェックイン] に設定した場合、マップされたサーバー フォルダーがビルド処理にバインドされます。例を次に示します。開発者のチェックインは、フォルダーに変更します。フォルダーは、ビルド定義のワークスペースにマップされ、そのビルド定義に [ゲート チェックイン] のトリガーがあります。変更は、ビルド処理が完了するまでブロックします。
ビルド定義ワークスペースの例
ビルド エンジニアの Roberto 氏が Storefront Nightly ビルド定義を作成しました。
.png "ビルド定義ワークスペースの例")
.gif "手順 1.")
このビルド定義は、$/Core/Controllers/Controllers.sln および $/Core/Viewers/Viewers.sln の 2 つのソリューションをビルドします。そのため、これらのソリューションが存在する 2 つのフォルダー、それらのフォルダーが含まれるプロジェクト、および必要な他のすべてのファイルをマップする必要があります。
.gif "手順 2.")
ビルド処理の効率を上げるため、Roberto 氏はビルド処理が必要としないドキュメント ファイルが存在するフォルダー $/Core/Viewers/Docs を除外しています。
.gif "手順 3.")
ソリューションは、他社のコンポーネント ライブラリに存在するいくつかのバイナリに依存しています。これらのバイナリは、特定の物理フォルダー c:\adatum\widgets に配置することを要求する独自のメカニズムにより保護されます。
ワークスペース間のデータのコピー
あるワークスペースから別のワークスペースにマッピングをコピーすることで、時間を節約できます。
いずれかのワークスペースからマッピングをコピーするには
[既存のワークスペースのコピー] をクリックします。
[コピーするワークスペースを選択] ダイアログ ボックスで、ワークスペースからマッピングをコピーします。
別のビルド定義ワークスペースまたは別のチーム メンバーのワークスペースからマッピングをコピーするには
次のいずれかの操作を実行します。
別のビルド定義ワークスペースからマッピングをコピーするには、ビルド定義を開き、[ワークスペース] タブをクリックします。
別のチーム メンバーのワークスペースからマッピングをコピーするには、メニューバーから [ファイル]、[ソース管理]、[ワークスペース] を選択するようにチーム メンバーに依頼します。ワークスペースを選択し、[編集] をクリックします。
[作業フォルダー] テーブルの行のショートカット メニューを開き、[すべて選択] をクリックします。
[作業フォルダー] テーブルの行のショートカット メニューを開き、[コピー] をクリックします。
テキスト ファイルを作成し、クリップボードの内容をテキスト ファイルに貼り付けて保存します。
ビルド定義を作成するか、コピーする対マッピングの対象である既存のビルド定義を変更します。
[ワークスペース] タブで、[作業フォルダー] テーブルの行のショートカット メニューを開き、[貼り付け] をクリックします。
必要に応じて、マッピングをビルド エージェントでの使用に合わせます。特に、[ビルド エージェント フォルダー] ボックスの値が適切で、必要な場合は $(SourceDir) トークンが含まれていることを確認してください。
ビルド ワークスペースのしくみを理解します。
ビルド処理では、ビルド エージェントがソース ファイルのコンパイルと他の操作を行います。ビルド エージェントは、この操作を行う前に、バージョン コントロール サーバー上のフォルダーからローカル作業ディレクトリにファイルをダウンロードします。これらのファイルをダウンロードしやすくするため、ビルド エージェントはサーバー上のフォルダーをビルド エージェントの作業ディレクトリ内のローカル フォルダーにマップするバージョン コントロール ワークスペースを作成します。
.png "ビルド ワークスペースが果たす役割")
ビルド処理の開始前
ビルド システムで、各ビルド エージェントの作業ディレクトリを設定します。詳細については、「ビルド エージェントの配置および構成」を参照してください。
ビルド定義を作成するときは、[ワークスペース] タブで、ダウンロードするファイルが存在するフォルダーと、これらのフォルダーをビルド エージェント上のローカル フォルダーにマップする方法を指定します。
ビルド処理中
ビルド処理は、ワークスペースの仕様を CreateWorkspace アクティビティ ワークフロー アクティビティに渡して、その作業ディレクトリ内でワークスペースを作成します。
.gif "手順 4.")
ビルド処理は、DownloadFiles アクティビティ アクティビティを使用してファイルをワークスペースにダウンロードします。この手順の後、ビルド エージェントはそれらのファイルを操作 (コンパイルなど) です。