Zveřejnění nastavení konfigurace role jako proměnné prostředí pomocí XPathu

Článek
10/14/2024

Důležité

Od 1. září 2024 je služba Cloud Services (Classic) pro všechny zákazníky zastaralá. Microsoft zastaví a vypne všechna stávající spuštěná nasazení a data se od října 2024 trvale ztratí. Nová nasazení by měla používat nový model nasazení založený na Azure Resource Manageru na Azure Cloud Services (rozšířená podpora).

V definičním souboru služby cloudové služby nebo webové role můžete vystavit hodnoty konfigurace modulu runtime jako proměnné prostředí. Podporují se následující hodnoty XPath (které odpovídají hodnotám rozhraní API).

Tyto hodnoty XPath jsou k dispozici také prostřednictvím knihovny Microsoft.WindowsAzure.ServiceRuntime .

Aplikace spuštěná v emulátoru

Označuje, že aplikace běží v emulátoru.

Typ	Příklad
XPath	xpath="/RoleEnvironment/Deployment/@emulated"
Kód	var x = RoleEnvironment.IsEm emulace;

ID nasazení

Načte ID nasazení instance.

Typ	Příklad
XPath	xpath="/RoleEnvironment/Deployment/@id"
Kód	var deploymentId = RoleEnvironment.DeploymentId;

Role ID

Načte aktuální ID role instance.

Typ	Příklad
XPath	xpath="/RoleEnvironment/CurrentInstance/@id"
Kód	var ID = RoleEnvironment.CurrentRoleInstance.Id;

Aktualizace domény

Načte aktualizační doménu instance.

Typ	Příklad
XPath	xpath="/RoleEnvironment/CurrentInstance/@updateDomain"
Kód	var ud = RoleEnvironment.CurrentRoleInstance.UpdateDomain;

Doména selhání

Načte doménu selhání instance.

Typ	Příklad
XPath	xpath="/RoleEnvironment/CurrentInstance/@faultDomain"
Kód	var fd = RoleEnvironment.CurrentRoleInstance.FaultDomain;

Název role

Načte název role instancí.

Typ	Příklad
XPath	xpath="/RoleEnvironment/CurrentInstance/@roleName"
Kód	var rname = RoleEnvironment.CurrentRoleInstance.Role.Name;

Nastavení konfigurace

Načte hodnotu zadaného nastavení konfigurace.

Typ	Příklad
XPath	xpath="/RoleEnvironment/CurrentInstance/ConfigurationSettings/ConfigurationSettings[@name='Setting1']/@value"
Kód	var setting = RoleEnvironment.GetConfigurationSettingValue("Setting1");

Cesta k místnímu úložišti

Načte cestu k místnímu úložišti pro instanci.

Typ	Příklad
XPath	xpath="/RoleEnvironment/CurrentInstance/LocalResources/LocalResource[@name='LocalStore1']/@path"
Kód	var localResourcePath = RoleEnvironment.GetLocalResource("LocalStore1"). Kořenová cesta;

Velikost místního úložiště

Načte velikost místního úložiště instance.

Typ	Příklad
XPath	xpath="/RoleEnvironment/CurrentInstance/LocalResources/LocalResource[@name='LocalStore1']/@sizeInMB"
Kód	var localResourceSizeInMB = RoleEnvironment.GetLocalResource("LocalStore1"). MaximumSizeInMegabytes;

Protokol koncového bodu

Načte protokol koncového bodu instance.

Typ	Příklad
XPath	xpath="/RoleEnvironment/CurrentInstance/Endpoints/Endpoint[@name='Endpoint1']/@protocol"
Kód	var prot = RoleEnvironment.CurrentRoleInstance.InstanceEndpoints["Endpoint1"]. Protokol;

IP adresa koncového bodu

Získá IP adresu zadaného koncového bodu.

Typ	Příklad
XPath	xpath="/RoleEnvironment/CurrentInstance/Endpoints/Endpoint[@name='Endpoint1']/@address"
Kód	var address = RoleEnvironment.CurrentRoleInstance.InstanceEndpoints["Endpoint1"]. IPEndpoint.Address

Port koncového bodu

Načte port koncového bodu instance.

Typ	Příklad
XPath	xpath="/RoleEnvironment/CurrentInstance/Endpoints/Endpoint[@name='Endpoint1']/@port"
Kód	var port = RoleEnvironment.CurrentRoleInstance.InstanceEndpoints["Endpoint1"]. IPEndpoint.Port;

Příklad

Tady je příklad role pracovního procesu, která vytvoří spouštěcí úlohu s proměnnou prostředí s názvem TestIsEmulated nastavenou na hodnotu @emulated xpath.

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

Další kroky

Přečtěte si další informace o souboru ServiceConfiguration.cscfg .

Vytvořte balíček ServicePackage.cspkg .

Povolte vzdálenou plochu pro roli.

Sdílet prostřednictvím