特定のビルドを配置する

[アーティクル]
07/13/2023

このトピックでは、Web パッケージとデータベーススクリプトを、以前の特定のビルドからステージング環境や運用環境などの新しい移行先にデプロイする方法について説明します。

このトピックは、Fabrikam, Inc という架空の会社のエンタープライズ展開要件に基づく一連のチュートリアルの一部です。このチュートリアルシリーズでは、サンプルソリューションである Contact Manager ソリューションを使用して、ASP.NET MVC 3 アプリケーション、Windows Communication Foundation (WCF) サービス、データベースプロジェクトなど、現実的なレベルの複雑さの Web アプリケーションを表します。

これらのチュートリアルの中心にある配置方法は、「プロジェクトファイルの理解」で説明されている分割プロジェクトファイルのアプローチに基づいています。この方法では、ビルドと配置のプロセスが 2 つのプロジェクトファイルによって制御されます。1 つは、すべての移行先環境に適用されるビルド命令を含み、もう 1 つは環境固有のビルドと配置設定を含みます。ビルド時に、環境固有のプロジェクトファイルが環境に依存しないプロジェクトファイルにマージされ、ビルド手順の完全なセットが形成されます。

タスクの概要

これまで、このチュートリアルセットのトピックでは、単一ステップまたは自動プロセスの一部として Web アプリケーションとデータベースをビルド、パッケージ化、デプロイする方法に重点を置いてきた。ただし、一般的なシナリオでは、ドロップフォルダー内のビルドの一覧からデプロイするリソースを選択する必要があります。つまり、最新のビルドがデプロイするビルドではない可能性があります。

前のトピック「配置をサポートするビルド定義の作成」で説明した継続的インテグレーション (CI) シナリオについて考えてみましょう。 Team Foundation Server (TFS) 2010 でビルド定義を作成しました。開発者が TFS にコードをチェックインするたびに、Team Build によってコードがビルドされ、ビルドプロセスの一部として Web パッケージとデータベーススクリプトが作成され、単体テストが実行され、リソースがテスト環境にデプロイされます。ビルド定義の作成時に構成したアイテム保持ポリシーに応じて、TFS は特定の数の以前のビルドを保持します。

ビルド定義の作成時に構成したアイテム保持ポリシーに応じて、T F S は特定の数の以前のビルドを保持します。 =======

次に、テスト環境でこれらのビルドのいずれかに対して検証と検証テストを実行し、ステージング環境にアプリケーションをデプロイする準備ができたとします。それまでの間、開発者は新しいコードをチェックインしている可能性があります。ソリューションをリビルドしてステージング環境にデプロイする必要がなく、最新のビルドをステージング環境にデプロイする必要はありません。代わりに、テストサーバーで検証および検証した特定のビルドをデプロイする必要があります。

これを実現するには、特定のビルドで生成された Web パッケージとデータベーススクリプトを見つける場所をMicrosoft Build Engine (MSBuild) に指示する必要があります。

OutputRoot プロパティのオーバーライド

サンプルソリューションでは、Publish.proj ファイルによって OutputRoot という名前のプロパティが宣言されています。名前が示すように、これはビルドプロセスによって生成されるすべてのものを含むルートフォルダーです。 Publish.proj ファイルでは、OutputRoot プロパティがすべてのデプロイリソースのルートの場所を参照していることがわかります。

Note

OutputRoot は、一般的に使用されるプロパティ名です。また、Visual C# および Visual Basic プロジェクトファイルでは、このプロパティを宣言して、すべてのビルド出力のルートの場所を格納します。

<PropertyGroup>
  <!--This is where the .deploymanifest file will be written to during a build-->    
  <_DbDeployManifestPath>
    $(OutputRoot)ContactManager.Database.deploymanifest
  </_DbDeployManifestPath>    
  
  <!-- The folder where the .zip and .cmd file will be located for 
                ContactManager.Mvc Web project -->
  <_ContactManagerDest>
    $(OutputRoot)_PublishedWebsites\ContactManager.Mvc_Package\
  </_ContactManagerDest>
  
  <!-- The folder where the .zip and .cmd file will be located for 
                ContactManager.Service Web project -->
   <_ContactManagerSvcDest>
    $(OutputRoot)_PublishedWebsites\ContactManager.Service_Package\
  </_ContactManagerSvcDest>
  
  <!-- ... -->
</PropertyGroup>

プロジェクトファイルで Web パッケージとデータベーススクリプトを別の場所 (以前の TFS ビルドの出力など) からデプロイする場合は、 OutputRoot プロパティをオーバーライドするだけで済みます。プロパティの値は、Team Build サーバー上の関連するビルドフォルダーに設定する必要があります。コマンドラインから MSBuild を実行していた場合は、コマンドライン引数として OutputRoot の値を指定できます。

msbuild.exe Publish.proj /p:TargetEnvPropsFile=EnvConfig\Env-Dev.proj 
  /p:OutputRoot=\\TFSBUILD\Drops\DeployToTest\DeployToTest_20120228.3\

ただし、実際には、ビルドターゲットもスキップする必要があります。 ビルド 出力を使用する予定がない場合は、ソリューションをビルドする意味はありません。これを行うには、コマンドラインから実行するターゲットを指定します。

msbuild.exe Publish.proj /p:TargetEnvPropsFile=EnvConfig\Env-Dev.proj 
  /p:OutputRoot=\\TFSBUILD\Drops\DeployToTest\DeployToTest_20120228.3\
  /target:GatherPackagesForPublishing;PublishDBPackages;PublishWebPackages

ただし、ほとんどの場合、TFS ビルド定義にデプロイロジックをビルドする必要があります。これにより、 キュービルド アクセス許可を持つユーザーは、TFS サーバーへの接続を使用して Visual Studio のインストールからデプロイをトリガーできます。

特定のビルドをデプロイするためのビルド定義の作成

次の手順では、ユーザーが 1 つのコマンドを使用してステージング環境へのデプロイをトリガーできるようにするビルド定義を作成する方法について説明します。

この場合、ビルド定義を実際にビルドする必要はありません。カスタムプロジェクトファイルで配置ロジックを実行するだけです。 Publish.proj ファイルには、ファイルが Team Build で実行されている場合にビルド ターゲットをスキップする条件付きロジックが含まれています。これを行うには、組み込みの BuildingInTeamBuild プロパティを評価します。これは、チームビルドでプロジェクトファイルを実行すると自動的に true に設定されます。その結果、ビルドプロセスをスキップし、単にプロジェクトファイルを実行して既存のビルドをデプロイできます。

デプロイを手動でトリガーするビルド定義を作成するには

Visual Studio 2010 の [チームエクスプローラー] ウィンドウで、チームプロジェクトノードを展開し、[ビルド] を右クリックし、[新しいビルド定義] をクリックします。
[ 全般 ] タブで、ビルド定義に名前 ( DeployToStaging など) と説明 (省略可能) を指定します。
[ トリガー ] タブで、[ 手動 - チェックイン] を選択すると、新しいビルドがトリガーされません。
[ ビルドの既定値 ] タブの [ ビルド出力を次のドロップフォルダーにコピー する] ボックスに、ドロップフォルダーの汎用名前付け規則 (UNC) パス ( \TFSBUILD\Drops など) を入力します。

$[ビルドの既定値] タブの [ビルド出力を次のドロップフォルダーにコピーする] ボックスに、ドロップフォルダーのユニバーサル名前付け規則 (U N C) パス (\TFSBUILD\Drops など) を入力します。$
[ プロセス ] タブの [ ビルドプロセスファイル ] ドロップダウンリストで、[ DefaultTemplate.xaml] を選択したままにします。これは、すべての新しいチームプロジェクトに追加される既定のビルドプロセステンプレートの 1 つです。
[ ビルドプロセスパラメーター ] テーブルで、[ ビルドする項目 ] 行をクリックし、 省略記号 ボタンをクリックします。
[ ビルドする項目 ] ダイアログボックスで、[ 追加] をクリックします。
[ 種類の項目] ドロップダウンリストで、[ MSBuild プロジェクトファイル] を選択します。
配置プロセスを制御するカスタムプロジェクトファイルの場所を参照し、ファイルを選択して、[OK] をクリック します。
[ ビルドする項目 ] ダイアログボックスで、[ OK] をクリックします。
[ ビルドプロセスパラメーター ] テーブルで、[ 詳細設定 ] セクションを展開します。
[ MSBuild 引数] 行で、環境固有のプロジェクトファイルの場所を指定し、ビルドフォルダーの場所のプレースホルダーを追加します。
```
/p:TargetEnvPropsFile=EnvConfig\Env-Stage.proj;
OutputRoot=PLACEHOLDER
```
Note

ビルドをキューに入れるたびに OutputRoot 値をオーバーライドする必要があります。これについては、次の手順で説明します。
[保存] をクリックします。

ビルドをトリガーするときは、デプロイするビルドを指す OutputRoot プロパティを更新する必要があります。

ビルド定義から特定のビルドをデプロイするには

[チームエクスプローラー] ウィンドウで、ビルド定義を右クリックし、[新しいビルドのキュー] をクリックします。
[ キューのビルド ] ダイアログボックスの [ パラメーター ] タブで、[ 詳細設定 ] セクションを展開します。
[ MSBuild 引数] 行で、 OutputRoot プロパティの値をビルドフォルダーの場所に置き換えます。次に例を示します。
```
/p:TargetEnvPropsFile=EnvConfig\Env-Stage.proj;
   OutputRoot=\\TFSBUILD\Drops\DeployToTest\DeployToTest_20120228.3\
```
Note

ビルドフォルダーへのパスの末尾に末尾のスラッシュを含めるようにしてください。
[ キュー] をクリックします。

ビルドをキューに入れると、プロジェクトファイルは OutputRoot プロパティで指定したビルドドロップフォルダーからデータベーススクリプトと Web パッケージをデプロイします。

まとめ

このトピックでは、分割プロジェクトファイル配置モデルを使用して、特定の以前のビルドから Web パッケージやデータベーススクリプトなどのデプロイリソースを発行する方法について説明しました。 OutputRoot プロパティをオーバーライドする方法と、TFS ビルド定義にデプロイロジックを組み込む方法について説明しました。

もっと読む

ビルド定義の作成の詳細については、「基本的なビルド定義を作成する」および「ビルドプロセスを定義する」を参照してください。ビルドのキューに関する詳細なガイダンスについては、「ビルドをキューに登録する」を参照してください。

前へ次へ