Udostępnij przez

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

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ą trwale 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;

Identyfikator wdrożenia

Pobiera identyfikator wdrożenia systemu dla instancji.

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/ConfigurationSetting[@name='Setting1']/@value"
Kod var setting = RoleEnvironment.GetConfigurationSettingValue("Setting1");

Ścieżka lokalnego przechowywania

Pobiera ścieżkę lokalnej pamięci dla wystąpienia.

Typ Przykład
XPath xpath="/RoleEnvironment/CurrentInstance/LocalResources/LocalResource[@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/LocalResource[@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 pracownika, która tworzy zadanie startowe 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>

Dalsze kroki

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

Utwórz pakiet ServicePackage.cspkg.

Włącz pulpit zdalny dla roli.

  • Last updated on