Azure Cloud Services (クラシック) 定義スキーマ (.csdef ファイル)

[アーティクル]
06/15/2023

重要

現在、Cloud Services (クラシック) は新しいお客様に対して非推奨となっており、2024 年 8 月 31 日に、すべてのお客様に対して廃止される予定です。新しいデプロイでは、新しい 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 です。

Azure Cloud Services (クラシック) 定義スキーマ (.csdef ファイル)

基本サービス定義スキーマ

スキーマ定義

ServiceDefinition 要素

その他のリソース