エクスポート (0) 印刷
すべて展開

Windows Azure サービスの定義スキーマ (.csdef ファイル)

更新日: 2014年2月

サービス定義ファイルは、アプリケーションのサービス モデルを定義します。このファイルは、クラウド サービスで使用できるロールの定義を含んでおり、サービス エンドポイントを指定して、サービスの構成設定を確立します。「Windows Azure サービスの構成スキーマ (.cscfg ファイル)」で説明されているように、構成設定値はサービス構成ファイルで設定されます。

既定では、Windows Azure 診断の構成スキーマ ファイルは、C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas ディレクトリにインストールされます。<version>Windows Azure SDK のインストール済みバージョンで置き換えてください。

サービス定義ファイルの既定の拡張子は .csdef です。

サービス定義ファイルには 1 つの ServiceDefinition 要素を含める必要があります。サービス定義には、少なくとも 1 つのロール (WebRole または WorkerRole) 要素を含める必要があります。1 つの定義には最大 25 のロールを含めることができ、ロールの種類を混在させることができます。サービス定義には、省略可能な NetworkTrafficRules 要素も含まれています。この要素は、指定されている内部エンドポイントと通信できるロールを制限します。サービス定義には、省略可能な LoadBalancerProbes 要素も含まれています。この要素には、顧客が定義する、エンドポイントの正常性プローブが含まれます。

サービス定義ファイルの基本形式は次のとおりです。


<ServiceDefinition name="<service-name>" topologyChangeDiscovery="<change-type>" xmlns=”http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceDefinition” upgradeDomainCount="<number-of-upgrade-domains>" schemaVersion=”<version>”>

  <LoadBalancerProbes>
         …
  </LoadBalancerProbes>

  <WebRole …>
         …
  </WebRole>

  <WorkerRole …>
         …
  </WorkerRole>
 
  <NetworkTrafficRules>
         …
  </NetworkTrafficRules>
</ServiceDefinition>

ServiceDefinition 要素は、サービス定義ファイルの最上位要素です。

次の表では、ServiceDefinition 要素の属性について説明します。

 

属性 説明

name

必須。サービスの名前です。この名前は、サービス アカウント内で一意になる必要があります。

topologyChangeDiscovery

省略可能。トポロジ変更通知の種類を指定します。次の値をとります。

  • Blast - 更新情報をできるだけ早くすべてのロール インスタンスに送信します。このオプションを選択した場合、ロールでは再起動せずにトポロジの更新を処理できます。

  • UpgradeDomainWalk - 更新情報を各ロール インスタンスに順番に送信します。この場合、前のインスタンスが更新情報を正しく受け取った後で、次のインスタンスに送信されます。

schemaVersion

省略可能。サービス定義スキーマのバージョンを指定します。スキーマ バージョンは、SDK の複数のバージョンがサイド バイ サイドでインストールされている場合に、スキーマ検証に使用する正しい SDK ツールを Visual Studio で選択できるようにします。

upgradeDomainCount

省略可能。このサービスのロールが割り当てられているアップグレード ドメインの数を指定します。サービスがデプロイされると、ロール インスタンスがアップグレード ドメインに割り当てられます。詳細については、「方法: クラウド サービス ロールまたはデプロイの更新」を参照してください。

アップグレード ドメインは最大 20 まで指定できます。指定しない場合、アップグレード ドメインの既定の数は 5 になります。

表示:
© 2014 Microsoft