Azure Cloud Services (延長サポート) の定義: WebRole スキーマ

Azure Web ロールは、Web アプリケーションのプログラミング用として IIS 7 でサポートされるようにカスタマイズされたロールであり、ASP.NET、PHP、Windows Communication Foundation、FastCGI などがあります。

サービス定義ファイルの既定の拡張子は csdef です。

Web ロールの基本サービス定義スキーマ

Web ロールが含まれるサービス定義ファイルの基本形式は次のとおりです。

<ServiceDefinition …>  
  <WebRole name="<web-role-name>" vmsize="<web-role-size>" enableNativeCodeExecution="[true|false]">  
    <Certificates>  
      <Certificate name="<certificate-name>" storeLocation="<certificate-store>" storeName="<store-name>" />  
    </Certificates>      
    <ConfigurationSettings>  
      <Setting name="<setting-name>" />  
    </ConfigurationSettings>  
    <Imports>  
      <Import moduleName="<import-module>"/>  
    </Imports>  
    <Endpoints>  
      <InputEndpoint certificate="<certificate-name>" ignoreRoleInstanceStatus="[true|false]" name="<input-endpoint-name>" protocol="[http|https|tcp|udp]" localPort="<port-number>" port="<port-number>" loadBalancerProbe="<load-balancer-probe-name>" />  
      <InternalEndpoint name="<internal-endpoint-name>" protocol="[http|tcp|udp|any]" port="<port-number>">  
         <FixedPort port="<port-number>"/>  
         <FixedPortRange min="<minimum-port-number>" max="<maximum-port-number>"/>  
      </InternalEndpoint>  
     <InstanceInputEndpoint name="<instance-input-endpoint-name>" localPort="<port-number>" protocol="[udp|tcp]">  
         <AllocatePublicPortFrom>  
            <FixedPortRange min="<minimum-port-number>" max="<maximum-port-number>"/>  
         </AllocatePublicPortFrom>  
      </InstanceInputEndpoint>  
    </Endpoints>  
    <LocalResources>  
      <LocalStorage name="<local-store-name>" cleanOnRoleRecycle="[true|false]" sizeInMB="<size-in-megabytes>" />  
    </LocalResources>  
    <LocalStorage name="<local-store-name>" cleanOnRoleRecycle="[true|false]" sizeInMB="<size-in-megabytes>" />  
    <Runtime executionContext="[limited|elevated]">  
      <Environment>  
         <Variable name="<variable-name>" value="<variable-value>">  
            <RoleInstanceValue xpath="<xpath-to-role-environment-settings>"/>  
          </Variable>            
      </Environment>  
      <EntryPoint>  
         <NetFxEntryPoint assemblyName="<name-of-assembly-containing-entrypoint>" targetFrameworkVersion="<.net-framework-version>"/>  
      </EntryPoint>  
    </Runtime>  
    <Sites>  
      <Site name="<web-site-name>">  
        <VirtualApplication name="<application-name>" physicalDirectory="<directory-path>"/>  
        <VirtualDirectory name="<directory-path>" physicalDirectory="<directory-path>"/>  
        <Bindings>  
          <Binding name="<binding-name>" endpointName="<endpoint-name-bound-to>" hostHeader="<url-of-the-site>"/>  
        </Bindings>  
      </Site>  
    </Sites>  
    <Startup priority="<for-internal-use-only>">  
      <Task commandLine="<command-to=execute>" executionContext="[limited|elevated]" taskType="[simple|foreground|background]">  
        <Environment>  
         <Variable name="<variable-name>" value="<variable-value>">  
            <RoleInstanceValue xpath="<xpath-to-role-environment-settings>"/>  
          </Variable>            
        </Environment>  
      </Task>  
    </Startup>  
    <Contents>  
      <Content destination="<destination-folder-name>" >  
        <SourceDirectory path="<local-source-directory>" />  
      </Content>  
    </Contents>  
  </WebRole>  
</ServiceDefinition>  

スキーマ要素

サービス定義ファイルには、この記事の以降のセクションで詳しく説明する下の要素が含まれています。

WebRole

ConfigurationSettings

設定

LocalResources

LocalStorage

エンドポイント

InternalEndpoint

InstanceInputEndpoint

AllocatePublicPortFrom

FixedPort

FixedPortRange

証明書

[MSSQLSERVER のプロトコルのプロパティ]

インポートする

[インポート]

Runtime

Environment

Variable

RoleInstanceValue

NetFxEntryPoint

サイト

サイト

VirtualApplication

VirtualApplication

バインド

Binding

Startup

タスク

Contents

コンテンツ

SourceDirectory

WebRole

WebRole 要素では、Web アプリケーションのプログラミング用として IIS 7 と ASP.NET でサポートされるようにカスタマイズされたロールを指定します。 サービスには、0 個以上の Web ロールを含めることができます。

以下の表に、WebRole 要素の属性を示します。

属性	Type	説明
name	string	必須。 Web ロールの名前です。 ロールの名前は一意である必要があります。
enableNativeCodeExecution	boolean	任意。 既定値は true であり、ネイティブ コード実行および完全な信頼は既定で有効になっています。 Web ロールでネイティブ コード実行を無効にし、代わりに Azure 部分信頼を使用するには、この属性を false に設定します。
vmsize	string	省略可能。 ロールに割り当てる仮想マシンのサイズを変更するには、この値を設定します。 既定値は Small です。 詳しくは、Microsoft Azure Cloud Services の仮想マシンのサイズに関するページをご覧ください。

ConfigurationSettings

ConfigurationSettings 要素では、Web ロールの構成設定のコレクションを指定します。 この要素は、Setting 要素の親です。

設定

Setting 要素では、ロールのインスタンスの構成設定を指定する名前と値のペアを指定します。

以下の表に、Setting 要素の属性を示します。

属性	Type	説明
name	string	必須。 構成設定の一意の名前です。

ロールの構成設定とは、サービス定義ファイルで宣言され、サービス構成ファイルで設定されている名前と値のペアのことです。

LocalResources

LocalResources 要素では、Web ロールのローカル ストレージ リソースのコレクションを指定します。 この要素は、LocalStorage 要素の親です。

LocalStorage

LocalStorage 要素では、実行時にサービス用のファイル システム領域を提供するローカル ストレージ リソースを指定します。 ロールでは、0 個以上のローカル ストレージ リソースを定義することができます。

Note

LocalStorage 要素は、以前のバージョンの Azure SDK との互換性をサポートするために、WebRole 要素の子として表示される場合があります。

以下の表に、LocalStorage 要素の属性を示します。

属性	Type	説明
name	string	必須。 ローカル ストアの一意名です。
cleanOnRoleRecycle	boolean	任意。 ロールの再起動時にローカル ストアをクリーンアップするかどうかを指定します。 既定値は true です。
sizeInMb	INT	省略可能。 ローカル ストアに割り当てるストレージ領域の容量 (MB 単位) です。 指定しない場合、既定の 100 MB のストレージ領域が割り当てられます。 割り当て可能なストレージ領域の最小量は 1 MB です。 ローカル リソースの最大サイズは、仮想マシンのサイズによって決まります。 詳しくは、Microsoft Azure Cloud Services の仮想マシンのサイズに関するページをご覧ください。

ローカル ストレージ リソースに割り当てられるディレクトリの名前は、name 属性で指定した値になります。

エンドポイント

Endpoints 要素では、ロールの入力 (外部) エンドポイント、内部エンドポイント、インスタンス入力エンドポイントのコレクションを指定します。 この要素は、InputEndpoint、InternalEndpoint、InstanceInputEndpoint の各要素の親です。

入力エンドポイントと内部エンドポイントは別々に割り当てられます。 サービスには入力エンドポイント、内部エンドポイント、インスタンス入力エンドポイントを合計で 25 個設定でき、それらのエンドポイントをサービス内で許可されている 25 個のロールに割り当てることができます。 たとえば、5 つのロールがある場合、1 ロールあたり 5 個の入力エンドポイントを割り当てたり、25 個の入力エンドポイントを 1 つのロールに割り当てたりすることができます。また、25 個のロールに入力エンドポイントを 1 つずつ割り当てることもできます。

Note

デプロイするロールには、それぞれ 1 つあたり 1 つのインスタンスが必要になります。 既定では、1 つのサブスクリプションでプロビジョニングできるコア数は 20 個に制限されているため、1 つのロールにプロビジョニングできるインスタンスの上限は 20 個になります。 既定のプロビジョニングで提供されるよりも多くのインスタンスが必要な場合、請求、サブスクリプション管理、クォータのサポートに関するページで、クォータの増加方法の詳細をご覧ください。

InputEndpoint

InputEndpoint 要素では、Web ロールの外部エンドポイントを指定します。

HTTP、HTTPS、UDP、TCP の各エンドポイントを組み合わせて複数のエンドポイントを定義できます。 入力エンドポイントに対しては任意のポート番号を指定できますが、サービス内の各ロールに対して指定するポート番号は一意である必要があります。 たとえば、1 つの Web ロールで HTTP 用にポート 80、HTTPS 用にポート 443 を使用するように指定した場合、2 つ目の Web ロールでは HTTP 用にポート 8080、HTTPS 用にポート 8043 を使用するように指定します。

以下の表に、InputEndpoint 要素の属性を示します。

属性	Type	説明
name	string	必須。 外部エンドポイントの一意名です。
protocol	string	必須。 外部エンドポイントのトランスポート プロトコルです。 Web ロールで使用可能な値は、HTTP、HTTPS、UDP、および TCP です。
port	INT	必須。 外部エンドポイントのポートです。 任意のポート番号を指定できますが、サービス内の各ロールに対して指定するポート番号は一意である必要があります。 使用できる値の範囲は 1 以上 65535 以下です (Azure SDK バージョン 1.7 以上)。
証明書 (certificate)	string	HTTPS エンドポイントの場合は必須。 Certificate 要素で定義される証明書の名前です。
localPort	INT	省略可能。 エンドポイントでの内部接続に使用するポートを指定します。 localPort 属性では、エンドポイントの外部ポートをロールの内部ポートにマッピングします。 この属性は、外部に公開しているものとは異なるポート上にある内部コンポーネントとロールが通信する必要のあるシナリオで役立ちます。 指定しない場合、localPort の値は port 属性と同じになります。 検出可能な未割り当てポートをランタイム API で自動的に割り当てるには、localPort の値を "*" に設定します。 使用できる値の範囲は 1 以上 65535 以下です (Azure SDK バージョン 1.7 以上)。 localPort 属性は、Azure SDK バージョン 1.3 以上を使用している場合のみ利用可能です。
ignoreRoleInstanceStatus	boolean	省略可能。 この属性の値が true に設定されている場合、サービスの状態は無視され、エンドポイントはロード バランサーによって削除されません。 サービスのビジー状態のインスタンスをデバッグする場合、この値を true に設定すると便利です。 既定値は false です。 注: ロールが準備完了状態ではなくなっても、エンドポイントで引き続きトラフィックを受信できます。
loadBalancerProbe	string	省略可能。 入力エンドポイントに関連付けるロード バランサー プローブの名前です。 詳しくは、LoadBalancerProbe スキーマに関するページをご覧ください。

InternalEndpoint

InternalEndpoint 要素では、Web ロールの内部エンドポイントを指定します。 内部エンドポイントを使用できるのはサービス内で実行されている他のロール インスタンスのみであり、サービス外部のクライアントでは使用できません。 Sites 要素が含まれていない Web ロールでは、単一の HTTP、UDP、または TCP 内部エンドポイントのみを設定できます。

以下の表に、InternalEndpoint 要素の属性を示します。

属性	Type	説明
name	string	必須。 内部エンドポイントの一意名です。
protocol	string	必須。 内部エンドポイントのトランスポート プロトコルです。 指定できる値は、HTTP、TCP、UDP、および ANY です。 値を ANY にすると、あらゆるプロトコルおよびポートが許可されます。
port	INT	省略可能。 エンドポイントの内部負荷分散接続に使用されるポート。 負荷分散エンドポイントではポートを 2 つ使用します。 パブリック IP アドレス用のポートと、プライベート IP アドレス用のポートです。 通常、これらの値は同じものを設定しますが、別々のポートを使用することもできます。 使用できる値の範囲は 1 以上 65535 以下です (Azure SDK バージョン 1.7 以上)。 Port 属性は、Azure SDK バージョン 1.3 以上を使用している場合のみ利用可能です。

InstanceInputEndpoint

InstanceInputEndpoint 要素では、Web ロールのインスタンス入力エンドポイントを指定します。 インスタンス入力エンドポイントは、ロード バランサーでのポート フォワーディングにより特定のロール インスタンスに関連付けられます。 各インスタンス入力エンドポイントは、使用可能なポートの範囲で特定のポートにマッピングされます。 この要素は、AllocatePublicPortFrom 要素の親です。

InstanceInputEndpoint 要素は、Azure SDK バージョン 1.7 以上を使用している場合のみ利用可能です。

以下の表に、InstanceInputEndpoint 要素の属性を示します。

属性	Type	説明
name	string	必須。 エンドポイントの一意名です。
localPort	INT	必須。 ロード バランサーから転送された受信トラフィックを受信するために、すべてのロール インスタンスがリッスンする内部ポートを指定します。 指定できる値は 1 以上 65535 以下です。
protocol	string	必須。 内部エンドポイントのトランスポート プロトコルです。 指定できる値は udp または tcp です。 HTTP/HTTPS ベースのトラフィックの場合は tcp を使用します。

AllocatePublicPortFrom

AllocatePublicPortFrom 要素は、各インスタンス入力エンドポイントにアクセスするために外部の顧客が使用できるパブリック ポートの範囲を示します。 パブリック (VIP) ポート番号の割り当ては指定した範囲で行われ、テナントのデプロイおよび更新時に個々のロール インスタンス エンドポイントに割り当てられます。 この要素は、FixedPortRange 要素の親です。

AllocatePublicPortFrom 要素は、Azure SDK バージョン 1.7 以上を使用している場合のみ利用可能です。

FixedPort

FixedPort 要素では、内部エンドポイントで負荷分散接続を有効にする、エンドポイントのポートを指定します。

FixedPort 要素は、Azure SDK バージョン 1.3 以上を使用している場合のみ利用可能です。

以下の表に、FixedPort 要素の属性を示します。

属性	Type	説明
port	INT	必須。 内部エンドポイントのポートです。 この属性の効果は、FixedPortRange の min と max を同じポートに設定した場合と同じです。 使用できる値の範囲は 1 以上 65535 以下です (Azure SDK バージョン 1.7 以上)。

FixedPortRange

FixedPortRange 要素では、内部エンドポイントまたはインスタンス入力エンドポイントに割り当てるポートの範囲を指定し、それらのエンドポイントの負荷分散接続に使用するポートを設定します。

Note

FixedPortRange 要素の動作は、この要素を含む要素によって異なります。 FixedPortRange 要素が InternalEndpoint 要素内に含まれる場合、ロールが実行される仮想マシンすべてに対して、ロード バランサー上にある min 属性から max 属性までの範囲のすべてのポートが開かれます。 FixedPortRange 要素が InstanceInputEndpoint 要素内に含まれる場合、ロールが実行される各仮想マシン上で、min 属性から max 属性までの範囲に含まれるポートが 1 つだけ開かれます。

FixedPortRange 要素は、Azure SDK バージョン 1.3 以上を使用している場合のみ利用可能です。

以下の表に、FixedPortRange 要素の属性を示します。

属性	Type	説明
分	INT	必須。 範囲の最小ポートです。 使用できる値の範囲は 1 以上 65535 以下です (Azure SDK バージョン 1.7 以上)。
最大	string	必須。 範囲の最大ポートです。 使用できる値の範囲は 1 以上 65535 以下です (Azure SDK バージョン 1.7 以上)。

証明書

Certificates 要素では、Web ロールの証明書のコレクションを指定します。 この要素は、Certificate 要素の親です。 ロールには、任意の数の証明書を関連付けることができます。 Certificates 要素の使用方法について詳しくは、証明書を使用したサービス定義ファイルの変更に関するページをご覧ください。

Certificate

Certificate 要素では、Web ロールに関連付ける証明書を指定します。

以下の表に、Certificate 要素の属性を示します。

属性	Type	説明
name	string	必須。 この証明書の名前です。証明書を HTTPS InputEndpoint 要素に関連付けた場合に、その証明書を参照するために使用します。
storeLocation	string	必須。 この証明書を見つけることのできるローカル マシン上の証明書ストアの場所です。 設定可能な値は CurrentUser および LocalMachine です。
storeName	string	必須。 この証明書が存在するローカル マシン上の証明書ストアの名前です。 使用できる値は、組み込みのストア名 My、Root、CA、Trust、Disallowed、TrustedPeople、TrustedPublisher、AuthRoot、AddressBook、および任意のカスタム ストア名です。 カスタム ストア名を指定した場合、そのストアが自動で作成されます。
permissionLevel	string	省略可能。 ロール プロセスに付与するアクセス許可を指定します。 管理者特権プロセスのみが秘密キーへアクセスできるようにするには、elevated 権限を指定します。 limitedOrElevated 権限では、すべてのロール プロセスが秘密キーにアクセスできます。 指定できる値は limitedOrElevated または elevated です。 既定値は limitedOrElevated です。

インポートする

Imports 要素では、ゲスト オペレーティング システムにコンポーネントを追加する Web ロールのインポート モジュールのコレクションを指定します。 この要素は、Import 要素の親です。 この要素は省略可能であり、ロールに設定できる Imports ブロックは 1 つのみです。

Imports 要素は、Azure SDK バージョン 1.3 以上を使用している場合のみ利用可能です。

インポート

Import 要素では、ゲスト オペレーティング システムに追加するモジュールを指定します。

Import 要素は、Azure SDK バージョン 1.3 以上を使用している場合のみ利用可能です。

以下の表に、Import 要素の属性を示します。

属性	Type	説明
moduleName	string	必須。 インポートするモジュールの名前です。 有効なインポート モジュールは次のとおりです。 - RemoteAccess - RemoteForwarder - Diagnostics RemoteAccess モジュールと RemoteForwarder モジュールを使用すると、ロール インスタンスをリモート デスクトップ接続用に構成できます。 詳細については、「拡張機能」を参照してください。 Diagnostics モジュールを使用すると、ロール インスタンスの診断データを収集できます。

ランタイム

Runtime 要素では、Azure ホスト プロセスのランタイム環境を制御する、Web ロールの環境変数設定のコレクションを指定します。 この要素は、Environment 要素の親です。 この要素は省略可能であり、ロールに設定できる Runtime ブロックは 1 つのみです。

Runtime 要素は、Azure SDK バージョン 1.3 以上を使用している場合のみ利用可能です。

以下の表に、Runtime 要素の属性を示します。

属性	Type	[説明]
executionContext	string	省略可能。 ロール プロセスを起動するコンテキストを指定します。 既定のコンテキストは limited です。 - limited – プロセスは管理者権限を使用せずに起動されます。 - elevated – プロセスは管理者権限を使用して起動されます。

環境

Environment 要素では、Web ロールの環境変数設定のコレクションを指定します。 この要素は、Variable 要素の親です。 ロールには、任意の数の環境変数セットを設定できます。

変数

Variable 要素では、ゲスト オペレーティングに設定する環境変数を指定します。

Variable 要素は、Azure SDK バージョン 1.3 以上を使用している場合のみ利用可能です。

以下の表に、Variable 要素の属性を示します。

属性	Type	説明
name	string	必須。 設定する環境変数の名前です。
value	string	省略可能。 環境変数に対して設定する値です。 value 属性か RoleInstanceValue 要素のいずれかを指定する必要があります。

RoleInstanceValue

RoleInstanceValue 要素では、変数の値の取得先となる xPath を指定します。

以下の表に、RoleInstanceValue 要素の属性を示します。

属性	Type	[説明]
xpath	string	省略可能。 インスタンスのデプロイ設定の保存先のパスです。 詳しくは、XPath を使用した構成変数に関するページをご覧ください。 value 属性か RoleInstanceValue 要素のいずれかを指定する必要があります。

EntryPoint

EntryPoint 要素では、ロールのエントリ ポイントを指定します。 この要素は、NetFxEntryPoint 要素の親です。 これらの要素により、既定の WaWorkerHost.exe 以外のアプリケーションをロールのエントリ ポイントとして機能させるように指定できます。

EntryPoint 要素は、Azure SDK バージョン 1.5 以上を使用している場合のみ利用可能です。

NetFxEntryPoint

NetFxEntryPoint 要素では、ロールで実行するプログラムを指定します。

Note

NetFxEntryPoint 要素は、Azure SDK バージョン 1.5 以上を使用している場合のみ利用可能です。

以下の表に、NetFxEntryPoint 要素の属性を示します。

属性	Type	[説明]
assemblyName	string	必須。 エントリ ポイントが含まれるアセンブリのパスとファイル名です。 パスは、フォルダー \%ROLEROOT%\Approot に対して相対的になります (コマンド ラインでは \%ROLEROOT%\Approot は指定しないでください。これは想定されています)。 %ROLEROOT% は Azure で保持される環境変数であり、ロールのルート フォルダーの場所を表します。 \%ROLEROOT%\Approot フォルダーは、ロールのアプリケーション フォルダーを表します。 HWC ロールの場合、パスは \%ROLEROOT%\Approot\bin フォルダーに対して常に相対的です。 フル IIS および IIS Express の各 Web ロールについては、\%ROLEROOT%\Approot フォルダーへの相対パスでアセンブリが見つからない場合、\%ROLEROOT%\Approot\bin が検索されます。 フル IIS 向けのこのフォールバック動作は推奨されるベスト プラクティスではないため、今後のバージョンで削除される可能性があります。
targetFrameworkVersion	string	必須。 アセンブリがビルドされた .NET Framework のバージョンです。 たとえば、「 targetFrameworkVersion="v4.0" 」のように入力します。

サイト

Sites 要素では、Web ロールでホストする Web サイトおよび Web アプリケーションのコレクションを指定します。 この要素は、Site 要素の親です。 Sites 要素を指定しない場合、Web ロールは従来の Web ロールとしてホストされ、Web ロールでホストできる Web サイトは 1 つのみになります。 この要素は省略可能であり、ロールに設定できる Sites ブロックは 1 つのみです。

Sites 要素は、Azure SDK バージョン 1.3 以上を使用している場合のみ利用可能です。

サイト

Site 要素では、Web ロールに含まれる Web サイトまたは Web アプリケーションを指定します。

Site 要素は、Azure SDK バージョン 1.3 以上を使用している場合のみ利用可能です。

以下の表に、Site 要素の属性を示します。

属性	Type	説明
name	string	必須。 Web サイトまたはアプリケーションの名前です。
physicalDirectory	string	サイト ルートのコンテンツ ディレクトリの場所です。 場所は、csdef に対する絶対パスまたは相対パスを指定できます。

VirtualApplication

VirtualApplication 要素では、インターネット インフォメーション サービス (IIS) 7 のアプリケーションが、HTTP などのプロトコル経由でコンテンツを配信するかまたはサービスを提供するファイルのグループであると定義します。 IIS 7 でアプリケーションを作成すると、そのアプリケーションのパスがサイトの URL に含まれます。

VirtualApplication 要素は、Azure SDK バージョン 1.3 以上を使用している場合のみ利用可能です。

以下の表に、VirtualApplication 要素の属性を示します。

属性	Type	説明
name	string	必須。 仮想アプリケーションを識別する名前を指定します。
physicalDirectory	string	必須。 仮想アプリケーションが含まれる開発用コンピューター上のパスを指定します。 コンピューティング エミュレーターでは、IIS はこの場所からコンテンツを取得するように構成されています。 物理ディレクトリのコンテンツを Azure にデプロイするときに、コンテンツはサービスの他のコンテンツと共にパッケージ化されます。 サービス パッケージを Azure にデプロイすると、IIS にはアンパックされたコンテンツの場所が設定されます。

VirtualDirectory

VirtualDirectory 要素では、IIS で指定しローカル サーバーまたはリモート サーバー上の物理ディレクトリにマッピングするディレクトリの名前 (パスとも呼ばれます) を指定します。

VirtualDirectory 要素は、Azure SDK バージョン 1.3 以上を使用している場合のみ利用可能です。

以下の表に、VirtualDirectory 要素の属性を示します。

属性	Type	説明
name	string	必須。 仮想ディレクトリを識別する名前を指定します。
value	physicalDirectory	必須。 Web サイトまたは仮想ディレクトリのコンテンツが含まれる開発用コンピューター上のパスを指定します。 コンピューティング エミュレーターでは、IIS はこの場所からコンテンツを取得するように構成されています。 物理ディレクトリのコンテンツを Azure にデプロイするときに、コンテンツはサービスの他のコンテンツと共にパッケージ化されます。 サービス パッケージを Azure にデプロイすると、IIS にはアンパックされたコンテンツの場所が設定されます。

バインド

Bindings 要素では、Web サイトのバインドのコレクションを指定します。 これは、Binding 要素の親要素です。 この要素は、すべての Site 要素で必須です。 エンドポイントの構成の詳細については、ロール インスタンスの通信の有効化に関するページをご覧ください。

Bindings 要素は、Azure SDK バージョン 1.3 以上を使用している場合のみ利用可能です。

バインド

Binding 要素では、Web サイトまたは Web アプリケーションとの通信要求に必要な構成情報を指定します。

Binding 要素は、Azure SDK バージョン 1.3 以上を使用している場合のみ利用可能です。

属性	Type	説明
name	string	必須。 バインドを識別する名前を指定します。
endpointName	string	必須。 バインド先のエンドポイント名を指定します。
hostHeader	string	省略可能。 単一の IP アドレスとポート番号の組み合わせでホスト名が異なる複数のサイトをホストできるようにする、ホスト名を指定します。

スタートアップ

Startup 要素では、ロールの起動時に実行されるタスクのコレクションを指定します。 この要素は、Variable 要素の親にすることができます。 ロール スタートアップ タスクの使用について詳しくは、スタートアップ タスクの構成方法に関するページをご覧ください。 この要素は省略可能であり、ロールに設定できる Startup ブロックは 1 つのみです。

以下の表に、Startup 要素の属性を示します。

属性	Type	[説明]
priority	INT	内部使用専用です。

タスク

Task 要素では、ロールの起動時に実行されるスタートアップ タスクを指定します。 スタートアップ タスクを使用することで、ソフトウェア コンポーネントのインストールや他のアプリケーションの実行など、ロールの実行準備を整えるタスクを実行できます。 タスクは、Startup 要素ブロック内に記載された順番で実行されます。

Task 要素は、Azure SDK バージョン 1.3 以上を使用している場合のみ利用可能です。

以下の表に、Task 要素の属性を示します。

属性	Type	[説明]
commandLine	string	必須。 CMD ファイルなど、実行するコマンドが含まれるスクリプトです。 スタートアップ コマンドとバッチ ファイルは ANSI 形式で保存する必要があります。 ファイルの先頭にバイト順マーカーが設定されているファイル形式は、正常に処理されません。
executionContext	string	スクリプトが実行されるコンテキストを指定します。 - limited (既定) – プロセスをホストするロールと同じ権限で実行します。 - elevated – 管理者特権で実行します。
taskType	string	コマンドの実行動作を指定します。 - simple (既定) – システムは、他のタスクが起動されるまでこのタスクの終了を待機します。 - background – システムはタスクの終了を待機しません。 - foreground – すべてのフォアグラウンド タスクが終了するまでロールが再起動されない点を除き、background と同様です。

内容

Contents 要素では、Web ロールのコンテンツのコレクションを指定します。 この要素は、Content 要素の親です。

Contents 要素は、Azure SDK バージョン 1.5 以上を使用している場合のみ利用可能です。

コンテンツ

Content 要素では、Azure 仮想マシンにコピーするコンテンツのソースの場所、およびそのコンテンツのコピー先のパスを定義します。

Content 要素は、Azure SDK バージョン 1.5 以上を使用している場合のみ利用可能です。

以下の表に、Content 要素の属性を示します。

属性	Type	[説明]
destination	string	必須。 コンテンツを配置する Azure 仮想マシン上の場所です。 この場所は、フォルダー %ROLEROOT%\Approot に対して相対的です。

この要素は、SourceDirectory 要素の親要素です。

SourceDirectory

SourceDirectory 要素では、コンテンツのコピー元となるローカル ディレクトリを定義します。 この要素を使用して、Azure 仮想マシンにコピーするローカルのコンテンツを指定します。

SourceDirectory 要素は、Azure SDK バージョン 1.5 以上を使用している場合のみ利用可能です。

以下の表に、SourceDirectory 要素の属性を示します。

属性	Type	説明
path	string	必須。 Azure 仮想マシンにコピーするコンテンツが含まれるローカル ディレクトリの相対パスまたは絶対パス。 ディレクトリ パスでは環境変数の展開がサポートされます。

次のステップ

Cloud Services (延長サポート) 定義スキーマ。