Azure Cloud Services (クラシック) 構成スキーマ (.cscfg ファイル)

  • [アーティクル]

重要

現在、Cloud Services (クラシック) は新しいお客様に対して非推奨となっており、2024 年 8 月 31 日に、すべてのお客様に対して廃止される予定です。 新しいデプロイでは、新しい Azure Resource Manager ベースのデプロイ モデル、 Azure Cloud Services (延長サポート) を使用してください。

サービス構成ファイルは、サービスのロールごとに配置するロール インスタンスの数、すべての構成設定の値、ロールに関連付けられているすべての証明書のサムプリントを指定します。 サービスが仮想ネットワークの一部である場合は、仮想ネットワーク構成ファイルだけでなく、サービス構成ファイルでネットワークの構成情報を指定してください。 サービス構成ファイルの既定の拡張子は .cscfg です。

サービス モデルは、Cloud Service (クラシック) 定義スキーマに関するページで説明されています。

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

サービスでのロール構成の詳細については、クラウド サービス モデルとは何かに関するページをご覧ください。

基本的なサービス構成スキーマ

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

<ServiceConfiguration serviceName="<service-name>" osFamily="<osfamily-number>" osVersion="<os-version>" schemaVersion="<schema-version>">

  <Role …>
    …
  </Role>

  <NetworkConfiguration>
    …
  </NetworkConfiguration>

</ServiceConfiguration>

スキーマ定義

次のトピックでは、ServiceConfiguration 要素のスキーマについて説明します。

サービス構成名前空間

サービス構成ファイルの XML 名前空間は、次のとおりです。http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceConfiguration

ServiceConfiguration 要素

ServiceConfiguration 要素は、サービス構成ファイルの最上位の要素です。

以下の表に、ServiceConfiguration 要素の属性を示します。 すべての属性値は、文字列型です。

属性 説明
serviceName 必須。 クラウド サービスの名前。 ここで与えられた名前は、サービス定義ファイルで指定された名前と一致する必要があります。
osFamily 省略可能。 クラウド サービスのロール インスタンスで実行されるゲスト OS を指定します。 サポートされるゲスト OS のリリース版については、「Azure ゲスト OS リリースと SDK の互換性対応表」をご覧ください。

osFamily 値を含めず、特定のゲスト OS バージョンについて osVersion 属性を設定していない場合、既定値 1 が使用されます。
osVersion 省略可能。 クラウド サービスのロール インスタンスで実行されるゲスト OS のバージョンを指定します。 ゲスト OS のバージョンの詳細については、「Azure ゲスト OS リリースと SDK の互換性対応表」をご覧ください。

ゲスト OS が自動的に最新バージョンにアップグレードされるように指定することができます。 これを行うには、osVersion 属性の値を * に設定します。 * に設定されると、指定された OS ファミリのゲスト OS の最新バージョンを使用してロール インスタンスがデプロイされ、ゲスト OS の新しいバージョンがリリースされたときに自動的にアップグレードします。

特定のバージョンを手動で指定するには、「Azure ゲスト OS リリースと SDK の互換性対応表」の今後、現在、移行中のゲスト OS バージョンに関するセクションにある表から Configuration String を使用します。

osVersion 属性の既定値は * です。
schemaVersion 省略可能。 サービス構成スキーマのバージョンを指定します。 複数のバージョンの SDK が一緒にインストールされている場合、Visual Studio では、スキーマ バージョンにより、スキーマの検証に使用する適切な SDK ツールを選択できます。 スキーマとバージョンの互換性の詳細については、「Azure ゲスト OS リリースと SDK の互換性対応表」をご覧ください。

サービス構成ファイルには、ServiceConfiguration 要素を 1 つ含める必要があります。 ServiceConfiguration 要素は、任意の数の Role 要素と、0 または 1 つの NetworkConfiguration 要素を含む場合があります。