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

Artykuł
10/16/2024

Ważne

Usługi Cloud Services (wersja klasyczna) są teraz przestarzałe dla wszystkich klientów od 1 września 2024 r. Wszystkie istniejące uruchomione wdrożenia zostaną zatrzymane i zamknięte przez firmę Microsoft, a dane zostaną przypadkowo utracone od października 2024 r. Nowe wdrożenia powinny używać nowego modelu wdrażania opartego na usłudze Azure Resource Manager w usługach Azure Cloud Services (wsparcie dodatkowe).

W pliku definicji usługi w chmurze lub usługi roli sieci Web 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;

Deployment-id

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"). Ścieżka główna;

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.

Udostępnij za pośrednictwem