XPath で環境変数としてロール構成設定を公開する

重要

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

クラウドサービス worker ロールまたは Web ロールのサービス定義ファイルで、ランタイム構成値を環境変数として公開できます。次の XPath 値がサポートされています (これは API 値に対応します)。

これらの XPath 値は、 Microsoft.WindowsAzure.ServiceRuntime ライブラリ経由でも使用できます。

エミュレーターで実行中のアプリ

アプリがエミュレーターで実行されていることを示します。

タイプ	例
XPath	xpath="/RoleEnvironment/Deployment/@emulated"
コード	var x = RoleEnvironment.IsEmulated;

デプロイメント ID

インスタンスのデプロイ ID を取得します。

タイプ	例
XPath	xpath="/RoleEnvironment/Deployment/@id"
コード	var deploymentId = RoleEnvironment.DeploymentId;

役割ID

インスタンスの現在のロール ID を取得します。

タイプ	例
XPath	xpath="/RoleEnvironment/CurrentInstance/@id"
コード	var id = RoleEnvironment.CurrentRoleInstance.Id;

ドメインの更新

インスタンスの更新ドメインを取得します。

タイプ	例
XPath	xpath="/RoleEnvironment/CurrentInstance/@updateDomain"
コード	var ud = RoleEnvironment.CurrentRoleInstance.UpdateDomain;

障害ドメイン

インスタンスの障害ドメインを取得します。

タイプ	例
XPath	xpath="/RoleEnvironment/CurrentInstance/@faultDomain"
コード	var fd = RoleEnvironment.CurrentRoleInstance.FaultDomain; // フォルトドメインの現在の役割インスタンスを取得します。

ロール名

インスタンスのロール名を取得します。

タイプ	例
XPath	xpath="/RoleEnvironment/CurrentInstance/@roleName"
コード	var rname = RoleEnvironment.CurrentRoleInstance.Role.Name;

構成設定

指定した構成設定の値を取得します。

タイプ	例
XPath	xpath="/RoleEnvironment/CurrentInstance/ConfigurationSettings/ConfigurationSetting[@name='Setting1']/@value"
コード	var setting = RoleEnvironment.GetConfigurationSettingValue("Setting1");

ローカルストレージパス

インスタンスのローカルストレージパスを取得します。

タイプ	例
XPath	xpath="/RoleEnvironment/CurrentInstance/LocalResources/LocalResource[@name='LocalStore1']/@path"
コード	var localResourcePath = RoleEnvironment.GetLocalResource("LocalStore1")。RootPath;

ローカルストレージサイズ

インスタンスのローカルストレージのサイズを取得します。

タイプ	例
XPath	xpath="/RoleEnvironment/CurrentInstance/LocalResources/LocalResource[@name='LocalStore1']/@sizeInMB"
コード	var localResourceSizeInMB = RoleEnvironment.GetLocalResource("LocalStore1").MaximumSizeInMegabytes;

エンドポイントプロトコル

インスタンスのエンドポイントプロトコルを取得します。

タイプ	例
XPath	xpath="/RoleEnvironment/CurrentInstance/Endpoints/Endpoint[@name='Endpoint1']/@protocol"
コード	```ja-JP // この変数は、"Endpoint1"のプロトコルを取得します var prot = RoleEnvironment.CurrentRoleInstance.InstanceEndpoints["Endpoint1"].Protocol; ```

エンドポイント IP

指定したエンドポイントの IP アドレスを取得します。

タイプ	例
XPath	xpath="/RoleEnvironment/CurrentInstance/Endpoints/Endpoint[@name='Endpoint1']/@address"
コード	```javascript // アドレスを取得するためのコード var address = RoleEnvironment.CurrentRoleInstance.InstanceEndpoints["Endpoint1"].IPEndpoint.Address ```

エンドポイントポート

インスタンスのエンドポイントポートを取得します。

タイプ	例
XPath	xpath="/RoleEnvironment/CurrentInstance/Endpoints/Endpoint[@name='Endpoint1']/@port"
コード	var port = RoleEnvironment.CurrentRoleInstance.InstanceEndpoints["Endpoint1"].IPEndpoint.Port;

例

TestIsEmulatedに設定されたという環境変数でスタートアップタスクを作成する worker ロールの例を次に示します。

<WorkerRole name="Role1">
    <ConfigurationSettings>
      <Setting name="Setting1" />
    </ConfigurationSettings>
    <LocalResources>
      <LocalStorage name="LocalStore1" sizeInMB="1024"/>
    </LocalResources>
    <Endpoints>
      <InternalEndpoint name="Endpoint1" protocol="tcp" />
    </Endpoints>
    <Startup>
      <Task commandLine="example.cmd inputParm">
        <Environment>
          <Variable name="TestConstant" value="Constant"/>
          <Variable name="TestEmptyValue" value=""/>
          <Variable name="TestIsEmulated">
            <RoleInstanceValue xpath="/RoleEnvironment/Deployment/@emulated"/>
          </Variable>
          ...
        </Environment>
      </Task>
    </Startup>
    <Runtime>
      <Environment>
        <Variable name="TestConstant" value="Constant"/>
        <Variable name="TestEmptyValue" value=""/>
        <Variable name="TestIsEmulated">
          <RoleInstanceValue xpath="/RoleEnvironment/Deployment/@emulated"/>
        </Variable>
        ...
      </Environment>
    </Runtime>
    ...
</WorkerRole>

次のステップ

ServiceConfiguration.cscfg ファイルの詳細を理解します。

ServicePackage.cspkg パッケージを作成します。

ロールのリモートデスクトップを有効にします。

Last updated on 2024-07-23