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.