Uwidacznianie ustawień konfiguracji roli jako zmiennej środowiskowej za pomocą programu XPath

  • Artykuł

Ważne

Cloud Services (wersja klasyczna) jest teraz przestarzała dla nowych klientów i zostanie wycofana 31 sierpnia 2024 r. dla wszystkich klientów. Nowe wdrożenia powinny korzystać z nowego modelu wdrażania opartego na usłudze Azure Resource Manager Azure Cloud Services (rozszerzona obsługa)."

W pliku definicji usługi w chmurze lub pliku definicji usługi roli internetowej można uwidocznić wartości konfiguracji środowiska uruchomieniowego jako zmienne środowiskowe. Obsługiwane są następujące wartości XPath (które odpowiadają wartościom interfejsu API).

Te wartości XPath są również dostępne za pośrednictwem biblioteki Microsoft.WindowsAzure.ServiceRuntime .

Aplikacja uruchomiona w emulatorze

Wskazuje, że aplikacja jest uruchomiona w emulatorze.

Typ Przykład
XPath xpath="/RoleEnvironment/Deployment/@emulated"
Kod var x = RoleEnvironment.IsEmulated;

Identyfikator wdrożenia

Pobiera identyfikator wdrożenia dla wystąpienia.

Typ Przykład
XPath xpath="/RoleEnvironment/Deployment/@id"
Kod var deploymentId = RoleEnvironment.DeploymentId;

Identyfikator roli

Pobiera bieżący identyfikator roli dla wystąpienia.

Typ Przykład
XPath xpath="/RoleEnvironment/CurrentInstance/@id"
Kod var id = RoleEnvironment.CurrentRoleInstance.Id;

Aktualizowanie domeny

Pobiera domenę aktualizacji wystąpienia.

Typ Przykład
XPath xpath="/RoleEnvironment/CurrentInstance/@updateDomain"
Kod var ud = RoleEnvironment.CurrentRoleInstance.UpdateDomain;

Domena błędów

Pobiera domenę błędów wystąpienia.

Typ Przykład
XPath xpath="/RoleEnvironment/CurrentInstance/@faultDomain"
Kod var fd = RoleEnvironment.CurrentRoleInstance.FaultDomain;

Nazwa roli

Pobiera nazwę roli wystąpień.

Typ Przykład
XPath xpath="/RoleEnvironment/CurrentInstance/@roleName"
Kod var rname = RoleEnvironment.CurrentRoleInstance.Role.Name;

Ustawienie konfiguracji

Pobiera wartość określonego ustawienia konfiguracji.

Typ Przykład
XPath xpath="/RoleEnvironment/CurrentInstance/ConfigurationSettings/ConfigurationSettings[@name='Setting1']/@value"
Kod var setting = RoleEnvironment.GetConfigurationSettingValue("Setting1");

Ścieżka magazynu lokalnego

Pobiera lokalną ścieżkę magazynu dla wystąpienia.

Typ Przykład
XPath xpath="/RoleEnvironment/CurrentInstance/LocalResources/LocalResources[@name='LocalStore1']/@path"
Kod var localResourcePath = RoleEnvironment.GetLocalResource("LocalStore1"). RootPath;

Rozmiar magazynu lokalnego

Pobiera rozmiar magazynu lokalnego dla wystąpienia.

Typ Przykład
XPath xpath="/RoleEnvironment/CurrentInstance/LocalResources/LocalResources[@name='LocalStore1']/@sizeInMB"
Kod var localResourceSizeInMB = RoleEnvironment.GetLocalResource("LocalStore1"). MaximumSizeInMegabytes;

Protokół punktu końcowego

Pobiera protokół punktu końcowego dla wystąpienia.

Typ Przykład
XPath xpath="/RoleEnvironment/CurrentInstance/Endpoints/Endpoints[@name='Endpoint1']/@protocol"
Kod var prot = RoleEnvironment.CurrentRoleInstance.InstanceEndpoints["Endpoint1"]. Protokół;

Adres IP punktu końcowego

Pobiera adres IP określonego punktu końcowego.

Typ Przykład
XPath xpath="/RoleEnvironment/CurrentInstance/Endpoints/Endpoints[@name='Endpoint1']/@address"
Kod var address = RoleEnvironment.CurrentRoleInstance.InstanceEndpoints["Endpoint1"]. IPEndpoint.Address

Port punktu końcowego

Pobiera port punktu końcowego dla wystąpienia.

Typ Przykład
XPath xpath="/RoleEnvironment/CurrentInstance/Endpoints/Endpoints[@name='Endpoint1']/@port"
Kod var port = RoleEnvironment.CurrentRoleInstance.InstanceEndpoints["Endpoint1"]. IPEndpoint.Port;

Przykład

Oto przykład roli procesu roboczego, która tworzy zadanie uruchamiania ze zmienną środowiskową o nazwie TestIsEmulated ustawioną na wartość @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>

Następne kroki

Dowiedz się więcej o pliku ServiceConfiguration.cscfg .

Utwórz pakiet ServicePackage.cspkg .

Włącz pulpit zdalny dla roli.