Azure Cloud Services (延長サポート) 定義スキーマ (csdef ファイル)
サービス定義ファイルは、アプリケーションのサービス モデルを定義します。 このファイルには、Cloud Services で使用できるロールの定義が含まれ、サービス エンドポイントの指定やサービスの構成設定の確立を行います。 構成設定の値は、Cloud Services (延長サポート) 構成スキーマに関するページの説明に従って、サービス構成ファイルで設定されます。
既定では、Azure Diagnostics 構成スキーマ ファイルは C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas
ディレクトリにインストールされます。 <version>
は、インストールされている Azure SDK バージョンで置き換えてください。
サービス定義ファイルの既定の拡張子は csdef です。
基本サービス定義スキーマ
サービス定義ファイルには、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
要素は、サービス定義ファイルの最上位の要素です。
以下の表に、ServiceDefinition
要素の属性を示します。
属性 | 内容 |
---|---|
name | 必須。 サービスの名前。 サービス アカウント内で一意となる名前を使用してください。 |
topologyChangeDiscovery | 省略可能。 トポロジの変更通知の種類を指定します。 次のいずれかの値になります。 - Blast - 更新プログラムをすべてのロール インスタンスにできるだけ早く送信します。 オプションを選択する場合、ロールでは、再起動せずにトポロジの更新プログラムを処理できる必要があります。- UpgradeDomainWalk – 前のロール インスタンスが更新プログラムを正常に受け入れた後に、更新プログラムを各インスタンスに順次送信します。 |
schemaVersion | 省略可能。 サービス定義スキーマのバージョンを指定します。 複数のバージョンの SDK が一緒にインストールされている場合、Visual Studio では、スキーマ バージョンにより、スキーマの検証に使用する適切な SDK ツールを選択できます。 |
upgradeDomainCount | 省略可能。 このサービスのロールが割り当てられるアップグレード ドメインの数を指定します。 そのサービスをデプロイすると、ロール インスタンスがアップグレード ドメインに割り当てられます。 詳細については、「クラウド サービス ロールまたはデプロイを更新する」、仮想マシンの可用性の管理に関する記事を参照してください。アップグレード ドメインを最大 20 まで指定できます。 指定しない場合、アップグレード ドメインの既定の数は 5 です。 |