ターゲット環境の配置プロパティを構成する

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

このトピックでは、サンプルの Contact Manager ソリューションを特定のターゲット環境に展開するために、環境固有のプロパティを構成する方法について説明します。

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

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

プロセスの概要

Contact Manager ソリューションのビルドと展開に使用するプロジェクトファイルは、次の 2 つの物理ファイルに分割されます。

ユニバーサルビルド設定と命令 ( Publish.proj ファイル) を含む 1 つ。
環境固有のビルド設定 (Env-Dev.proj、 Env-Stage.proj など) を含む 1 つ。

ビルド時に、適切な環境固有のプロジェクトファイルがユニバーサル Publish.proj ファイルにマージされ、ビルド手順の完全なセットが形成されます。環境固有のプロジェクトファイルを作成またはカスタマイズし、独自の展開シナリオを記述する設定を使用して、特定の移行先環境へのデプロイを構成できます。

これらの値の多くは、ターゲット環境の構成方法 (特に、ターゲット Web サーバーが Web Deployment Agent サービス (リモートエージェント) と Web 配置ハンドラーのどちらを使用するように構成されているかによって決まります。これらのアプローチの詳細と、独自の環境に適したアプローチの選択に関するガイダンスについては、「 Web 配置に対する適切なアプローチの選択」を参照してください。

Contact Manager のシナリオでは、次の 2 つの環境固有のプロジェクトファイルが必要です。

開発者テスト環境へのデプロイ (Env-Dev.proj)。開発者テスト環境は、「シナリオ: Web 配置用のテスト環境の構成」の説明に従って、リモートエージェントを使用してリモート展開を受け入れるように構成されています。このファイルでは、リモートエージェントエンドポイントアドレスと、接続文字列やサービスエンドポイントなどの場所固有の設定を指定する必要があります。
ステージング環境へのデプロイ (Env-Stage.proj)。ステージング環境は、「シナリオ: Web 配置用のステージング環境の構成」の説明に従って、Web 配置ハンドラーを使用してリモートデプロイを受け入れるように構成されています。このファイルでは、Web 配置ハンドラーエンドポイントアドレスと、接続文字列やサービスエンドポイントなどの場所固有の設定を指定する必要があります。

環境固有のプロジェクトファイルで構成する設定は、Web パッケージ自体の内容には影響しません。代わりに、パッケージの展開方法と、パッケージの抽出時に提供されるパラメーター値を制御します。「シナリオ: Web 配置用の運用環境の構成」と「Web パッケージの手動インストール」の説明に従って、Web パッケージを運用環境に手動でインポートするため、パッケージの生成時に環境固有のプロジェクトファイルで使用した設定は関係ありません。インターネットインフォメーションサービス (IIS) マネージャーは、パッケージをインポートするときに、接続文字列やサービスエンドポイントなどのパラメーター化された値を求めるメッセージを表示します。

Contact Manager ソリューションを独自のターゲット環境に展開するには、このファイルをカスタマイズするか、テンプレートとして使用して独自のファイルを作成します。

Contact Manager ソリューションの環境固有の展開設定を構成するには

Visual Studio 2010 で ContactManager-WCF ソリューションを開きます。
[ソリューションエクスプローラー] ウィンドウで、[発行] フォルダーを展開し、[EnvConfig] フォルダーを展開して、[Env-Dev.proj] をダブルクリックします。
Env-Dev.proj ファイルのプロパティ値を、独自のテスト環境に適した値に置き換えます。

Note

この手順に従う表では、これらの各プロパティについて詳しく説明します。
作業内容を保存し、 Env-Dev.proj ファイルを閉じます。

適切な展開プロパティの選択

この表では、環境固有のサンプルプロジェクトファイル Env-Dev.proj の各プロパティの目的について説明し、指定する必要がある値に関するいくつかのガイダンスを示します。

プロパティ名	詳細
MSDeployComputerName 移行先の Web サーバーまたはサービスエンドポイントの名前。	移行先 Web サーバー上のリモートエージェントサービスに展開する場合は、ターゲットコンピューター名 ( TESTWEB1 や TESTWEB1.fabrikam.net など) を指定するか、 `http://TESTWEB1/MSDEPLOYAGENTSERVICE`リモートエージェントエンドポイント (例: ) を指定できます。デプロイは、いずれの場合も同じように動作します。移行先 Web サーバーの Web 配置ハンドラーにデプロイする場合は、サービスエンドポイントを指定し、IIS Web サイトの名前をクエリ文字列パラメーターとして含める必要があります (例: `https://STAGEWEB1:8172/MSDeploy.axd?site=DemoSite`)。
MSDeployAuth リモートコンピューターに対する認証に Web 配置で使用する必要があるメソッド。	これは NTLM または Basic に設定する必要があります。通常、リモートエージェントサービスにデプロイする場合は NTLM を使用し、Web 配置ハンドラーにデプロイする場合は Basic を使用します。基本認証を使用する場合は、IIS Web 展開ツール (Web 配置) が展開を実行するために偽装する必要があるユーザー名とパスワードも指定する必要があります。この例では、これらの値は MSDeployUsername プロパティと MSDeployPassword プロパティを使用して提供されます。 NTLM 認証を使用する場合は、これらのプロパティを省略するか、空白のままにすることができます。
MSDeployUsername 基本認証を使用する場合、Web 配置ではリモートコンピューターでこのアカウントが使用されます。	これは DOMAINusername という形式になります ( FABRIKAM\matt など)。この値は、基本認証を指定する場合にのみ使用されます。 NTLM 認証を使用する場合は、プロパティを省略できます。値を指定すると、無視されます。
MSDeployPassword 基本認証を使用する場合、Web Deploy はリモートコンピューターでこのパスワードを使用します。	これは、 MSDeployUsername プロパティで指定したユーザーアカウントのパスワードです。この値は、基本認証を指定する場合にのみ使用されます。 NTLM 認証を使用する場合は、プロパティを省略できます。値を指定すると、無視されます。
ContactManagerIisPath Contact Manager MVC アプリケーションを展開する IIS パス。	これは、[IIS Web サイト名]/[Webアプリケーション名] の形式で、IIS マネージャーに表示されるパスである必要があります。アプリケーションを展開する前に、IIS Web サイトが存在する必要があります。たとえば、DemoSite という名前の IIS Web サイトを作成した場合は、MVC アプリケーションの IIS パスを DemoSite/ContactManager として指定できます。
ContactManagerServiceIisPath Contact Manager WCF サービスを展開する IIS パス。	たとえば、DemoSite という名前の IIS Web サイトを作成した場合は、WCF サービスの IIS パスを DemoSite/ContactManagerService として指定できます。
ContactManagerTargetUrl WCF サービスにアクセスできる URL。	[IIS Web サイトのルート URL]/[サービスアプリケーション名]/[サービスエンドポイント] という形式になります。たとえば、ポート 85 で IIS Web サイトを作成した場合、URL はという形式 `http://localhost:85/ContactManagerService/ContactService.svc`になります。 MVC アプリケーションと WCF サービスは同じサーバーにデプロイされていることに注意してください。その結果、この URL は、インストールされているコンピューターからのみアクセスされます。このため、URL には、コンピューター名やホストヘッダーではなく、localhost または IP アドレスを使用することをお勧めします。コンピューター名またはホストヘッダーを使用する場合、IIS のループバックチェックセキュリティ機能によって URL がブロックされ、HTTP 401.1 - Unauthorized エラーが返されることがあります。
CmDatabaseConnectionString データベースサーバーの接続文字列。	接続文字列は、VSDBCMD がデータベースサーバーに接続し、データベースを作成するために使用する資格情報と、Web サーバーアプリケーションプールがデータベースサーバーに接続してデータベースと対話するために使用する資格情報の両方を決定します。基本的に、ここには 2 つの選択肢があります。 Integrated Security=true を指定できます。この場合、統合Windows 認証が使用されます。Data Source=TESTDB1;Integrated Security=true この場合、VSDBCMD 実行可能ファイルを実行するユーザーの資格情報を使用してデータベースが作成され、アプリケーションは Web サーバーコンピューターアカウントの ID を使用してデータベースにアクセスします。または、SQL Server アカウントのユーザー名とパスワードを指定することもできます。この場合、SQL Server資格情報は VSDBCMD によってデータベースを作成し、アプリケーションプールによってデータベースと対話するために使用されます。Data Source=TESTDB1;User Id=ASqlUser;Password=Pa$$w 0rd このトピックのチュートリアルでは、統合Windows 認証を使用することを前提としています。
CmTargetDatabase データベースサーバーに作成するデータベースに指定する名前。	ここで指定した値は、パラメーターとして VSDBCMD コマンドに追加されます。また、Web サーバー上のアプリケーションプールがデータベースとの対話に使用できる完全な接続文字列を構築するためにも使用されます。

これらの例では、特定の展開シナリオに合わせてこれらのプロパティを構成する方法を示します。

例 1 : リモートエージェントサービスへの展開

次の点に注意してください。

TESTWEB1 上のリモートエージェントサービスにデプロイしています。
NTLM 認証を使用するように Web Deploy に指示しています。 Web Deploy は、Microsoft Build Engine (MSBuild) の呼び出しに使用した資格情報を使用して実行されます。
統合認証を使用して 、ContactManager データベースを TESTDB1 にデプロイしています。データベースは、MSBuild の呼び出しに使用した資格情報を使用してデプロイされます。

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>    
    <MSDeployComputerName Condition=" '$(MSDeployComputerName)'=='' ">
      TESTWEB1.fabrikam.net
    </MSDeployComputerName>
    <MSDeployAuth Condition=" '$(MSDeployAuth)'=='' ">NTLM</MSDeployAuth>
    <ContactManagerTargetUrl Condition =" '$(ContactManagerTargetUrl)'=='' ">
      http://localhost:85/ContactManagerService/ContactService.svc
    </ContactManagerTargetUrl>
    <ContactManagerIisPath Condition=" '$(ContactManagerIisPath)'=='' ">
      DemoSite/ContactManager
    </ContactManagerIisPath>
    <ContactManagerServiceIisPath 
      Condition=" '$(ContactManagerServiceIisPath)'=='' ">
        DemoSite/ContactManagerService
    </ContactManagerServiceIisPath>
    <CmDatabaseConnectionString Condition=" '$(CmDatabaseConnectionString)'=='' ">
      Data Source=TESTDB1;Integrated Security=true</CmDatabaseConnectionString>
    <CmTargetDatabase Condition=" '$(CmTargetDatabase)'=='' ">
      ContactManager
    </CmTargetDatabase>
  </PropertyGroup>  
</Project>

例 2 - Web 配置ハンドラーエンドポイントへのデプロイ

次の点に注意してください。

STAGEWEB1 の Web 配置ハンドラーサービスエンドポイントにデプロイしています。
基本認証を使用するように Web Deploy に指示しています。
Web 配置でリモートコンピューター上の FABRIKAM\stagingdeployer アカウントを偽装する必要があることを指定しています。
SQL Server認証を使用して、ContactManager データベースを STAGEDB1 にデプロイしています。

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>    
    <MSDeployComputerName Condition=" '$(MSDeployComputerName)'=='' ">
      https://STAGEWEB1:8172/MSDeploy.axd?site=DemoSite
    </MSDeployComputerName>
    <MSDeployAuth Condition=" '$(MSDeployAuth)'=='' ">Basic</MSDeployAuth>
    <MSDeployUsername Condition=" '$(MSDeployUsername)'=='' ">
      FABRIKAM\stagingdeployer
    </MSDeployUsername>
    <MSDeployPassword Condition=" '$(MSDeployPassword)'=='' ">
      Pa$$w0rd
    </MSDeployPassword>
    <ContactManagerTargetUrl Condition =" '$(ContactManagerTargetUrl)'=='' ">
      http://localhost:85/ContactManagerService/ContactService.svc
    </ContactManagerTargetUrl>
    <ContactManagerIisPath Condition=" '$(ContactManagerIisPath)'=='' ">
      DemoSite/ContactManager
    </ContactManagerIisPath>
    <ContactManagerServiceIisPath 
      Condition=" '$(ContactManagerServiceIisPath)'=='' ">
        DemoSite/ContactManagerService
    </ContactManagerServiceIisPath>
    <CmDatabaseConnectionString Condition=" '$(CmDatabaseConnectionString)'=='' ">
      Data Source=STAGEDB1;User ID=sa;'$($CREDENTIAL_PLACEHOLDER$)'
    </CmDatabaseConnectionString>
    <CmTargetDatabase Condition=" '$(CmTargetDatabase)'=='' ">
      ContactManager
    </CmTargetDatabase>
  </PropertyGroup>  
</Project>

まとめ

この時点で、プロジェクトファイルは、Contact Manager ソリューションをビルドして 1 つ以上の移行先環境に展開するように完全に構成されています。

これらのプロジェクトファイルを単一ステップの反復可能な配置プロセスの一部として使用するには、MSBuild を使用して Publish.proj ファイルを実行し、環境固有のプロジェクトファイルの場所をパラメーターとして渡す必要があります。これを行うには、さまざまな方法があります。

MSBuild の概要とカスタムプロジェクトファイルの概要については、「プロジェクトファイルについて」を参照してください。
カスタムプロジェクトファイルを実行する MSBuild コマンドを作成する方法については、「 Web パッケージの配置」を参照してください。
単一ステップで繰り返し可能な展開のコマンドファイルに MSBuild コマンドを組み込む方法については、「配置コマンドファイルの作成と実行」を参照してください。
チームビルドからカスタムプロジェクトファイルを実行する方法については、「配置をサポートするビルド定義の作成」を参照してください。

[戻る]

ターゲット環境の配置プロパティを構成する

プロセスの概要

適切な展開プロパティの選択

例 1 : リモートエージェントサービスへの展開

例 2 - Web 配置ハンドラーエンドポイントへのデプロイ

まとめ

フィードバック

フィードバック

その他のリソース

ターゲット環境の配置プロパティを構成する

プロセスの概要

適切な展開プロパティの選択

例 1 : リモート エージェント サービスへの展開

例 2 - Web 配置ハンドラー エンドポイントへのデプロイ

まとめ

フィードバック

フィードバック

その他のリソース

例 1 : リモートエージェントサービスへの展開

例 2 - Web 配置ハンドラーエンドポイントへのデプロイ