次の方法で共有

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

  • [アーティクル]

重要

2024 年 9 月 1 日に、すべてのお客様に対して Cloud Services (クラシック) は非推奨になりました。 既存の実行中のデプロイはすべて Microsoft によって停止およびシャットダウンされ、2024 年 10 月以降、データは永久的に失われます。 新しいデプロイでは、新しい Azure Resource Manager ベースのデプロイ モデル、 Azure Cloud Services (延長サポート) を使用してください。

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

サービス モデルに関する説明は、「クラウド サービス (クラシック) 定義スキーマ」にあります。

既定では、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 値を含めず、特定のゲスト オペレーティング システム バージョンについて osVersion 属性を設定していない場合、既定値 1 が使用されます。
osVersion 省略可能。 Cloud Services のロール インスタンスで実行されるゲスト OS のバージョンを指定します。 ゲスト OS のバージョンの詳細については、「Azure ゲスト OS リリースと SDK の互換性対応表」をご覧ください。

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

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

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

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