Azure Cloud Services (クラシック) 定義スキーマ (.csdef ファイル)
重要
2024 年 9 月 1 日に、すべてのお客様に対して Cloud Services (クラシック) は非推奨になりました。 既存の実行中のデプロイはすべて Microsoft によって停止およびシャットダウンされ、2024 年 10 月以降、データは永久的に失われます。 新しいデプロイでは、新しい Azure Resource Manager ベースのデプロイ モデル、 Azure 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 です。 |