Szerepkörkonfigurációs beállítások elérhetővé tétele környezeti változóként az XPath használatával

Fontos

Cloud Services (klasszikus) mostantól elavult az új ügyfelek számára, és 2024. augusztus 31-én megszűnik minden ügyfél számára. Az új üzemelő példányoknak az új Azure Resource Manager-alapú Azure Cloud Services (kiterjesztett támogatás) üzemi modellt kell használniuk.

A felhőszolgáltatás-feldolgozó vagy a webes szerepkör-szolgáltatás definíciós fájljában környezeti változókként teheti közzé a futtatókörnyezet konfigurációs értékeit. A következő XPath-értékek támogatottak (amelyek az API-értékeknek felelnek meg).

Ezek az XPath-értékek a Microsoft.WindowsAzure.ServiceRuntime kódtáron keresztül is elérhetők.

Az emulátorban futó alkalmazás

Azt jelzi, hogy az alkalmazás az emulátorban fut.

Típus Példa
Xpath xpath="/RoleEnvironment/Deployment/@emulated"
Code var x = RoleEnvironment.IsEmulated;

Üzembehelyezési azonosító

Lekéri a példány üzembehelyezési azonosítóját.

Típus Példa
Xpath xpath="/RoleEnvironment/Deployment/@id"
Code var deploymentId = RoleEnvironment.DeploymentId;

Szerepkör azonosítója

Lekéri a példány aktuális szerepkör-azonosítóját.

Típus Példa
Xpath xpath="/RoleEnvironment/CurrentInstance/@id"
Code var id = RoleEnvironment.CurrentRoleInstance.Id;

Frissítési tartomány

Lekéri a példány frissítési tartományát.

Típus Példa
Xpath xpath="/RoleEnvironment/CurrentInstance/@updateDomain"
Code var ud = RoleEnvironment.CurrentRoleInstance.UpdateDomain;

Tartalék tartomány

Lekéri a példány tartalék tartományát.

Típus Példa
Xpath xpath="/RoleEnvironment/CurrentInstance/@faultDomain"
Code var fd = RoleEnvironment.CurrentRoleInstance.FaultDomain;

Szerepkörnév

Lekéri a példányok szerepkörnevét.

Típus Példa
Xpath xpath="/RoleEnvironment/CurrentInstance/@roleName"
Code var rname = RoleEnvironment.CurrentRoleInstance.Role.Name;

Konfigurációs beállítás

Lekéri a megadott konfigurációs beállítás értékét.

Típus Példa
Xpath xpath="/RoleEnvironment/CurrentInstance/ConfigurationSettings/ConfigurationSetting[@name='Setting1']/@value"
Code var setting = RoleEnvironment.GetConfigurationSettingValue("Setting1");

Helyi tároló elérési útja

Lekéri a példány helyi tárolási útvonalát.

Típus Példa
Xpath xpath="/RoleEnvironment/CurrentInstance/LocalResources/LocalResource[@name='LocalStore1']/@path"
Code var localResourcePath = RoleEnvironment.GetLocalResource("LocalStore1"). RootPath;

Helyi tároló mérete

Lekéri a példány helyi tárolójának méretét.

Típus Példa
Xpath xpath="/RoleEnvironment/CurrentInstance/LocalResources/LocalResource[@name='LocalStore1']/@sizeInMB"
Code var localResourceSizeInMB = RoleEnvironment.GetLocalResource("LocalStore1"). MaximumSizeInMegabytes;

Végpontprotokoll

Lekéri a példány végpontprotokollját.

Típus Példa
Xpath xpath="/RoleEnvironment/CurrentInstance/Endpoints/Endpoint[@name='Endpoint1']/@protocol"
Code var prot = RoleEnvironment.CurrentRoleInstance.InstanceEndpoints["Endpoint1"]. Protokoll;

Végpont IP-címe

Lekéri a megadott végpont IP-címét.

Típus Példa
Xpath xpath="/RoleEnvironment/CurrentInstance/Endpoints/Endpoint[@name='Endpoint1']/@address"
Code var address = RoleEnvironment.CurrentRoleInstance.InstanceEndpoints["Endpoint1"]. IPEndpoint.Address

Végpont portja

Lekéri a példány végpontportját.

Típus Példa
Xpath xpath="/RoleEnvironment/CurrentInstance/Endpoints/Endpoint[@name='Endpoint1']/@port"
Code var port = RoleEnvironment.CurrentRoleInstance.InstanceEndpoints["Endpoint1"]. IPEndpoint.Port;

Példa

Íme egy példa egy feldolgozói szerepkörre, amely létrehoz egy indítási feladatot egy nevű környezeti változóval TestIsEmulated , amely @emulated xpath értékre van állítva.

<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>

Következő lépések

További információ a ServiceConfiguration.cscfg fájlról.

Hozzon létre egy ServicePackage.cspkg csomagot.

Távoli asztal engedélyezése szerepkörhöz.