Schemat procesu roboczego definicji usługi Azure Cloud Services (wersja klasyczna)

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

Rola procesu roboczego platformy Azure jest rolą przydatną do uogólnionego programowania i może wykonywać przetwarzanie w tle dla roli internetowej.

Domyślnym rozszerzeniem pliku definicji usługi jest .csdef.

Podstawowy schemat definicji usługi dla roli procesu roboczego.

Podstawowy format pliku definicji usługi zawierającego rolę procesu roboczego jest następujący.

<ServiceDefinition …>
  <WorkerRole name="<worker-role-name>" vmsize="<worker-role-size>" enableNativeCodeExecution="[true|false]">
    <Certificates>
      <Certificate name="<certificate-name>" storeLocation="[CurrentUser|LocalMachine]" storeName="[My|Root|CA|Trust|Disallow|TrustedPeople|TrustedPublisher|AuthRoot|AddressBook|<custom-store>" />
    </Certificates>
    <ConfigurationSettings>
      <Setting name="<setting-name>" />
    </ConfigurationSettings>
    <Endpoints>
      <InputEndpoint name="<input-endpoint-name>" protocol="[http|https|tcp|udp]" localPort="<local-port-number>" port="<port-number>" certificate="<certificate-name>" loadBalancerProbe="<load-balancer-probe-name>" />
      <InternalEndpoint name="<internal-endpoint-name" protocol="[http|tcp|udp|any]" port="<port-number>">
         <FixedPort port="<port-number>"/>
         <FixedPortRange min="<minimum-port-number>" max="<maximum-port-number>"/>
      </InternalEndpoint>
     <InstanceInputEndpoint name="<instance-input-endpoint-name>" localPort="<port-number>" protocol="[udp|tcp]">
         <AllocatePublicPortFrom>
            <FixedPortRange min="<minimum-port-number>" max="<maximum-port-number>"/>
         </AllocatePublicPortFrom>
      </InstanceInputEndpoint>
    </Endpoints>
    <Imports>
      <Import moduleName="[RemoteAccess|RemoteForwarder|Diagnostics]"/>
    </Imports>
    <LocalResources>
      <LocalStorage name="<local-store-name>" cleanOnRoleRecycle="[true|false]" sizeInMB="<size-in-megabytes>" />
    </LocalResources>
    <LocalStorage name="<local-store-name>" cleanOnRoleRecycle="[true|false]" sizeInMB="<size-in-megabytes>" />
    <Runtime executionContext="[limited|elevated]">
      <Environment>
         <Variable name="<variable-name>" value="<variable-value>">
            <RoleInstanceValue xpath="<xpath-to-role-environment-settings>"/>
          </Variable>
      </Environment>
      <EntryPoint>
         <NetFxEntryPoint assemblyName="<name-of-assembly-containing-entrypoint>" targetFrameworkVersion="<.net-framework-version>"/>
         <ProgramEntryPoint commandLine="<application>" setReadyOnProcessStart="[true|false]"/>
      </EntryPoint>
    </Runtime>
    <Startup priority="<for-internal-use-only>">
      <Task commandLine="" executionContext="[limited|elevated]" taskType="[simple|foreground|background]">
        <Environment>
         <Variable name="<variable-name>" value="<variable-value>">
            <RoleInstanceValue xpath="<xpath-to-role-environment-settings>"/>
          </Variable>
        </Environment>
      </Task>
    </Startup>
    <Contents>
      <Content destination="<destination-folder-name>" >
        <SourceDirectory path="<local-source-directory>" />
      </Content>
    </Contents>
  </WorkerRole>
</ServiceDefinition>

Elementy schematu

Plik definicji usługi zawiera te elementy, opisane szczegółowo w kolejnych sekcjach w tym artykule:

Rola procesu roboczego

ConfigurationSettings

Ustawienie

LocalResources

LocalStorage

Punkty końcowe

InputEndpoint

Wewnętrzny punkt końcowy

InstanceInputEndpoint

PrzydzielPublicPortFrom

FixedPort

FixedPortRange

Certyfikaty

Certyfikat

Przywozu

Importuj

Środowisko uruchomieniowe

Środowisko

Punkt wejścia

NetFxEntryPoint

ProgramEntryPoint

Zmienna

RoleInstanceValue

Startup

Zadanie podrzędne

Zawartość

Zawartość

SourceDirectory

WorkerRole

Element WorkerRole opisuje rolę, która jest przydatna do uogólnionego programowania i może wykonywać przetwarzanie w tle dla roli internetowej. Usługa może zawierać zero lub więcej ról procesów roboczych.

W poniższej tabeli opisano atrybuty WorkerRole elementu.

Atrybut	Type	opis
nazwa	string	Wymagany. Nazwa roli procesu roboczego. Nazwa roli musi być unikatowa.
enableNativeCodeExecution	boolean	Opcjonalny. Wartość domyślna to true; wykonywanie kodu natywnego i pełne zaufanie są domyślnie włączone. Ustaw ten atrybut na wartość , aby false wyłączyć natywne wykonywanie kodu dla roli procesu roboczego i zamiast tego użyj częściowego zaufania platformy Azure.
vmsize	string	Opcjonalny. Ustaw tę wartość, aby zmienić rozmiar maszyny wirtualnej przydzielonej do tej roli. Domyślna wartość to Small. Aby uzyskać listę możliwych rozmiarów maszyn wirtualnych i ich atrybutów, zobacz Rozmiary maszyn wirtualnych dla usług Cloud Services.

ConfigurationSettings

Element ConfigurationSettings opisuje kolekcję ustawień konfiguracji dla roli procesu roboczego. Ten element jest elementem nadrzędnym Setting elementu.

Ustawienie

Element Setting opisuje parę nazw i wartości, która określa ustawienie konfiguracji dla wystąpienia roli.

W poniższej tabeli opisano atrybuty Setting elementu.

Atrybut	Type	opis
nazwa	string	Wymagany. Unikatowa nazwa ustawienia konfiguracji.

Ustawienia konfiguracji roli to pary nazw i wartości zadeklarowane w pliku definicji usługi i ustawione w pliku konfiguracji usługi.

LocalResources

Element LocalResources opisuje kolekcję zasobów magazynu lokalnego dla roli procesu roboczego. Ten element jest elementem nadrzędnym LocalStorage elementu.

LocalStorage

Element LocalStorage identyfikuje zasób magazynu lokalnego, który zapewnia miejsce systemu plików dla usługi w czasie wykonywania. Rola może definiować zero lub więcej zasobów magazynu lokalnego.

Uwaga

Element LocalStorage może być wyświetlany jako element podrzędny WorkerRole elementu w celu zapewnienia zgodności z wcześniejszymi wersjami zestawu Azure SDK.

W poniższej tabeli opisano atrybuty LocalStorage elementu.

Atrybut	Type	opis
nazwa	string	Wymagany. Unikatowa nazwa magazynu lokalnego.
cleanOnRoleRecycle	boolean	Opcjonalny. Wskazuje, czy magazyn lokalny powinien zostać oczyszczony po ponownym uruchomieniu roli. Wartość domyślna to true.
sizeInMb	int	Opcjonalny. Żądana ilość miejsca do przydzielenia dla magazynu lokalnego w MB. Jeśli nie zostanie określony, domyślne przydzielone miejsce do magazynowania wynosi 100 MB. Minimalna ilość miejsca do magazynowania, które można przydzielić, wynosi 1 MB. Maksymalny rozmiar zasobów lokalnych zależy od rozmiaru maszyny wirtualnej. Aby uzyskać więcej informacji, zobacz Virtual Machine sizes for Cloud Services (Rozmiary maszyn wirtualnych dla usług w chmurze).

Nazwa katalogu przydzielonego do zasobu magazynu lokalnego odpowiada wartości podanej dla atrybutu name.

Punkty końcowe

Element Endpoints opisuje kolekcję wejściowych (zewnętrznych), wewnętrznych i wejściowych punktów końcowych wystąpienia dla roli. Ten element jest elementem nadrzędnym InputEndpointelementów , InternalEndpointi InstanceInputEndpoint .

Punkty końcowe wejściowe i wewnętrzne są przydzielane oddzielnie. Usługa może mieć łącznie 25 punktów końcowych wejściowych, wewnętrznych i wejściowych wystąpień, które można przydzielić do 25 ról dozwolonych w usłudze. Jeśli na przykład masz pięć ról, możesz przydzielić pięć wejściowych punktów końcowych na rolę lub przydzielić 25 wejściowych punktów końcowych do jednej roli lub przydzielić jeden wejściowy punkt końcowy do 25 ról.

Uwaga

Każda wdrożona rola wymaga jednego wystąpienia na rolę. Domyślna aprowizacja subskrypcji jest ograniczona do 20 rdzeni i w związku z tym jest ograniczona do 20 wystąpień roli. Jeśli aplikacja wymaga więcej wystąpień niż jest zapewniana przez domyślną aprowizację, zobacz Rozliczenia, Zarządzanie subskrypcjami i Obsługa limitów przydziału, aby uzyskać więcej informacji na temat zwiększania limitu przydziału.

InputEndpoint

Element InputEndpoint opisuje zewnętrzny punkt końcowy roli procesu roboczego.

Można zdefiniować wiele punktów końcowych, które są kombinacją punktów końcowych HTTP, HTTPS, UDP i TCP. Można określić dowolny numer portu wybrany dla wejściowego punktu końcowego, ale numery portów określone dla każdej roli w usłudze muszą być unikatowe. Jeśli na przykład określisz, że rola używa portu 80 dla protokołu HTTP i portu 443 dla protokołu HTTPS, możesz określić, że druga rola używa portu 8080 dla protokołu HTTP i portu 8043 dla protokołu HTTPS.

W poniższej tabeli opisano atrybuty InputEndpoint elementu.

Atrybut	Type	opis
nazwa	string	Wymagany. Unikatowa nazwa zewnętrznego punktu końcowego.
protokół	string	Wymagany. Protokół transportu dla zewnętrznego punktu końcowego. W przypadku roli procesu roboczego możliwe wartości to HTTP, HTTPS, UDPlub TCP.
port	int	Wymagany. Port zewnętrznego punktu końcowego. Można określić dowolny wybrany numer portu, ale numery portów określone dla każdej roli w usłudze muszą być unikatowe. Możliwy zakres wartości z zakresu od 1 do 65535 włącznie (zestaw Azure SDK w wersji 1.7 lub nowszej).
certyfikat	string	Wymagane dla punktu końcowego HTTPS. Nazwa certyfikatu zdefiniowanego Certificate przez element.
localPort	int	Opcjonalny. Określa port używany do połączeń wewnętrznych w punkcie końcowym. Atrybut localPort mapuje port zewnętrzny w punkcie końcowym na port wewnętrzny w roli. Ten atrybut jest przydatny w scenariuszach, w których rola musi komunikować się ze składnikiem wewnętrznym na porcie innym niż ten, który jest uwidoczniony zewnętrznie. Jeśli nie zostanie określona, wartość parametru localPort port jest taka sama jak atrybut. Ustaw wartość localPort "*", aby automatycznie przypisywać nieprzydzielony port, który można odnaleźć przy użyciu interfejsu API środowiska uruchomieniowego. Możliwy zakres wartości z zakresu od 1 do 65535 włącznie (zestaw Azure SDK w wersji 1.7 lub nowszej). Atrybut localPort jest dostępny tylko przy użyciu zestawu Azure SDK w wersji 1.3 lub nowszej.
ignoreRoleInstanceStatus	boolean	Opcjonalny. Gdy wartość tego atrybutu jest ustawiona na true, stan usługi jest ignorowany, a moduł równoważenia obciążenia nie usuwa punktu końcowego. Ustawienie tej wartości jako true przydatnej do debugowania zajętych wystąpień usługi. Domyślna wartość to false. Uwaga: punkt końcowy może nadal odbierać ruch nawet wtedy, gdy rola nie jest w stanie Gotowe.
loadBalancerProbe	string	Opcjonalny. Nazwa sondy modułu równoważenia obciążenia skojarzona z wejściowym punktem końcowym. Aby uzyskać więcej informacji, zobacz LoadBalancerProbe Schema (Schemat loadBalancerProbe).

Wewnętrzny punkt końcowy

Element InternalEndpoint opisuje wewnętrzny punkt końcowy roli procesu roboczego. Wewnętrzny punkt końcowy jest dostępny tylko dla innych wystąpień ról uruchomionych w usłudze; nie jest ona dostępna dla klientów spoza usługi. Rola procesu roboczego może mieć maksymalnie pięć wewnętrznych punktów końcowych HTTP, UDP lub TCP.

W poniższej tabeli opisano atrybuty InternalEndpoint elementu.

Atrybut	Type	opis
nazwa	string	Wymagany. Unikatowa nazwa wewnętrznego punktu końcowego.
protokół	string	Wymagany. Protokół transportu dla wewnętrznego punktu końcowego. Możliwe wartości to HTTP, TCP, UDPlub ANY. Wartość ANY określa, że dowolny protokół, dowolny port jest dozwolony.
port	int	Opcjonalny. Port używany na potrzeby wewnętrznych połączeń ze zrównoważonym obciążeniem w punkcie końcowym. Punkt końcowy ze zrównoważonym obciążeniem używa dwóch portów. Port używany dla publicznego adresu IP i port używany na prywatnym adresie IP. Zazwyczaj te wartości są ustawione na takie same, ale można użyć różnych portów. Możliwy zakres wartości z zakresu od 1 do 65535 włącznie (zestaw Azure SDK w wersji 1.7 lub nowszej). Atrybut Port jest dostępny tylko przy użyciu zestawu Azure SDK w wersji 1.3 lub nowszej.

InstanceInputEndpoint

Element InstanceInputEndpoint opisuje wejściowy punkt końcowy wystąpienia do roli procesu roboczego. Punkt końcowy wejściowy wystąpienia jest skojarzony z określonym wystąpieniem roli przy użyciu przekazywania portów w module równoważenia obciążenia. Każdy wejściowy punkt końcowy wystąpienia jest mapowany na określony port z zakresu możliwych portów. Ten element jest elementem nadrzędnym AllocatePublicPortFrom elementu.

Element InstanceInputEndpoint jest dostępny tylko przy użyciu zestawu Azure SDK w wersji 1.7 lub nowszej.

W poniższej tabeli opisano atrybuty InstanceInputEndpoint elementu.

Atrybut	Type	opis
nazwa	string	Wymagany. Unikatowa nazwa punktu końcowego.
localPort	int	Wymagany. Określa port wewnętrzny, do którego nasłuchują wszystkie wystąpienia ról w celu odbierania ruchu przychodzącego przekazywanego z modułu równoważenia obciążenia. Możliwy zakres wartości z zakresu od 1 do 65535 włącznie.
protokół	string	Wymagany. Protokół transportu dla wewnętrznego punktu końcowego. Możliwe wartości to udp lub tcp. Użyj dla tcp ruchu opartego na protokole http/https.

PrzydzielPublicPortFrom

Element AllocatePublicPortFrom opisuje zakres portów publicznych, którego klienci zewnętrzni mogą używać do uzyskiwania dostępu do każdego wejściowego punktu końcowego wystąpienia. Numer portu publicznego (VIP) jest przydzielany z tego zakresu i przypisywany do każdego punktu końcowego wystąpienia roli podczas wdrażania i aktualizowania dzierżawy. Ten element jest elementem nadrzędnym FixedPortRange elementu.

Element AllocatePublicPortFrom jest dostępny tylko przy użyciu zestawu Azure SDK w wersji 1.7 lub nowszej.

FixedPort

Element FixedPort określa port wewnętrznego punktu końcowego, który umożliwia połączenia ze zrównoważonym obciążeniem w punkcie końcowym.

Element FixedPort jest dostępny tylko przy użyciu zestawu Azure SDK w wersji 1.3 lub nowszej.

W poniższej tabeli opisano atrybuty FixedPort elementu.

Atrybut	Type	Opis
port	int	Wymagany. Port wewnętrznego punktu końcowego. Ten atrybut ma taki sam efekt, jak ustawienie wartości minimalnych FixedPortRange i maksymalnych na ten sam port. Możliwy zakres wartości z zakresu od 1 do 65535 włącznie (zestaw Azure SDK w wersji 1.7 lub nowszej).

FixedPortRange

Element FixedPortRange określa zakres portów przypisanych do wewnętrznego punktu końcowego lub wejściowego punktu końcowego wystąpienia oraz ustawia port używany do połączeń ze zrównoważonym obciążeniem w punkcie końcowym.

Uwaga

Element FixedPortRange działa inaczej w zależności od elementu, w którym się znajduje. FixedPortRange Gdy element znajduje się w InternalEndpoint elemecie, otwiera wszystkie porty modułu równoważenia obciążenia w zakresie minimalnych i maksymalnych atrybutów dla wszystkich maszyn wirtualnych, na których jest uruchomiona rola. FixedPortRange Gdy element znajduje się w elemecieInstanceInputEndpoint, otwiera tylko jeden port w zakresie minimalnych i maksymalnych atrybutów na każdej maszynie wirtualnej z uruchomioną rolą.

Element FixedPortRange jest dostępny tylko przy użyciu zestawu Azure SDK w wersji 1.3 lub nowszej.

W poniższej tabeli opisano atrybuty FixedPortRange elementu.

Atrybut	Type	Opis
min	int	Wymagany. Minimalny port w zakresie. Możliwy zakres wartości z zakresu od 1 do 65535 włącznie (zestaw Azure SDK w wersji 1.7 lub nowszej).
max	string	Wymagany. Maksymalny port w zakresie. Możliwy zakres wartości z zakresu od 1 do 65535 włącznie (zestaw Azure SDK w wersji 1.7 lub nowszej).

Certyfikaty

Element Certificates opisuje kolekcję certyfikatów dla roli procesu roboczego. Ten element jest elementem nadrzędnym Certificate elementu. Rola może mieć dowolną liczbę skojarzonych certyfikatów. Aby uzyskać więcej informacji na temat używania elementu certificates, zobacz Modyfikowanie pliku definicji usługi przy użyciu certyfikatu.

Certyfikat

Element Certificate opisuje certyfikat skojarzony z rolą procesu roboczego.

W poniższej tabeli opisano atrybuty Certificate elementu.

Atrybut	Type	opis
nazwa	string	Wymagany. Nazwa tego certyfikatu, która jest używana do odwoływania się do niego, gdy jest skojarzona z elementem HTTPS InputEndpoint .
storeLocation	string	Wymagany. Lokalizacja magazynu certyfikatów, w którym można znaleźć ten certyfikat na komputerze lokalnym. Możliwe wartości to CurrentUser i LocalMachine.
storeName	string	Wymagany. Nazwa magazynu certyfikatów, w którym znajduje się ten certyfikat na komputerze lokalnym. Możliwe wartości obejmują wbudowane nazwy sklepów My, , DisallowedRootTrustAddressBookCATrustedPeopleTrustedPublisherAuthRootlub dowolną niestandardową nazwę magazynu. Jeśli zostanie określona niestandardowa nazwa magazynu, magazyn zostanie utworzony automatycznie.
permissionLevel	string	Opcjonalny. Określa uprawnienia dostępu przydzielone procesom roli. Jeśli chcesz, aby tylko procesy z podwyższonym poziomem uprawnień mogły uzyskiwać dostęp do klucza prywatnego, określ elevated uprawnienie. limitedOrElevated uprawnienie zezwala wszystkim procesom ról na dostęp do klucza prywatnego. Możliwe wartości to limitedOrElevated lub elevated. Domyślna wartość to limitedOrElevated.

Operacje importu

Element Imports opisuje kolekcję modułów importu dla roli procesu roboczego, która dodaje składniki do systemu operacyjnego gościa. Ten element jest elementem nadrzędnym Import elementu. Ten element jest opcjonalny i rola może mieć tylko jeden blok środowiska uruchomieniowego.

Element Imports jest dostępny tylko przy użyciu zestawu Azure SDK w wersji 1.3 lub nowszej.

Importuj

Element Import określa moduł, który ma zostać dodany do systemu operacyjnego gościa.

Element Import jest dostępny tylko przy użyciu zestawu Azure SDK w wersji 1.3 lub nowszej.

W poniższej tabeli opisano atrybuty Import elementu.

Atrybut	Type	Opis
moduleName	string	Wymagany. Nazwa modułu do zaimportowania. Prawidłowe moduły importu to: - RemoteAccess - RemoteForwarder -Diagnostyka Moduły RemoteAccess i RemoteForwarder umożliwiają skonfigurowanie wystąpienia roli dla połączeń pulpitu zdalnego. Aby uzyskać więcej informacji, zobacz Włączanie połączenia pulpitu zdalnego. Moduł Diagnostyka umożliwia zbieranie danych diagnostycznych dla wystąpienia roli

Środowisko uruchomieniowe

Element Runtime opisuje kolekcję ustawień zmiennych środowiskowych dla roli procesu roboczego, która kontroluje środowisko uruchomieniowe procesu hosta platformy Azure. Ten element jest elementem nadrzędnym Environment elementu. Ten element jest opcjonalny i rola może mieć tylko jeden blok środowiska uruchomieniowego.

Element Runtime jest dostępny tylko przy użyciu zestawu Azure SDK w wersji 1.3 lub nowszej.

W poniższej tabeli opisano atrybuty Runtime elementu:

Atrybut	Type	Opis
executionContext	string	Opcjonalny. Określa kontekst, w którym jest uruchamiany proces roli. Domyślnym kontekstem jest limited. - limited — Proces jest uruchamiany bez uprawnień administratora. - elevated — Proces jest uruchamiany z uprawnieniami administratora.

Środowisko

Element Environment opisuje kolekcję ustawień zmiennych środowiskowych dla roli procesu roboczego. Ten element jest elementem nadrzędnym Variable elementu. Rola może mieć dowolną liczbę zestawów zmiennych środowiskowych.

Zmienna

Element Variable określa zmienną środowiskową do ustawienia w systemie operacyjnym gościa.

Element Variable jest dostępny tylko przy użyciu zestawu Azure SDK w wersji 1.3 lub nowszej.

W poniższej tabeli opisano atrybuty Variable elementu:

Atrybut	Type	opis
nazwa	string	Wymagany. Nazwa zmiennej środowiskowej do ustawienia.
wartość	string	Opcjonalny. Wartość ustawiona dla zmiennej środowiskowej. Musisz dołączyć atrybut wartości lub RoleInstanceValue element.

RoleInstanceValue

Element RoleInstanceValue określa ścieżkę xPath, z której ma być pobierana wartość zmiennej.

W poniższej tabeli opisano atrybuty RoleInstanceValue elementu.

Atrybut	Type	Opis
xpath	string	Opcjonalny. Ścieżka lokalizacji ustawień wdrożenia dla wystąpienia. Aby uzyskać więcej informacji, zobacz Zmienne konfiguracji za pomocą programu XPath. Musisz dołączyć atrybut wartości lub RoleInstanceValue element.

EntryPoint

Element EntryPoint określa punkt wejścia roli. Ten element jest elementem nadrzędnym NetFxEntryPoint elementów. Te elementy pozwalają określić aplikację inną niż domyślna WaWorkerHost.exe, która będzie działać jako punkt wejścia roli.

Element EntryPoint jest dostępny tylko przy użyciu zestawu Azure SDK w wersji 1.5 lub nowszej.

NetFxEntryPoint

Element NetFxEntryPoint określa program do uruchomienia dla roli.

Uwaga

Element NetFxEntryPoint jest dostępny tylko przy użyciu zestawu Azure SDK w wersji 1.5 lub nowszej.

W poniższej tabeli opisano atrybuty NetFxEntryPoint elementu.

Atrybut	Type	Opis
assemblyName	string	Wymagany. Ścieżka i nazwa pliku zestawu zawierającego punkt wejścia. Ścieżka jest względna do folderu \%ROLEROOT%\Approot (nie należy określać folderu \%ROLEROOT%\Approot w wierszu polecenia; zakłada się, że). %ROLEROOT% jest zmienną środowiskową przechowywaną przez platformę Azure i reprezentuje lokalizację folderu głównego roli. Folder \%ROLEROOT%\Approot reprezentuje folder aplikacji dla twojej roli.
targetFrameworkVersion	string	Wymagany. Wersja platformy .NET Framework, na której został skompilowany zestaw. Na przykład targetFrameworkVersion="v4.0".

ProgramEntryPoint

Element ProgramEntryPoint określa program do uruchomienia dla roli. Element ProgramEntryPoint umożliwia określenie punktu wejścia programu, który nie jest oparty na zestawie .NET.

Uwaga

Element ProgramEntryPoint jest dostępny tylko przy użyciu zestawu Azure SDK w wersji 1.5 lub nowszej.

W poniższej tabeli opisano atrybuty ProgramEntryPoint elementu.

Atrybut	Type	Opis
commandLine	string	Wymagany. Ścieżka, nazwa pliku i wszystkie argumenty wiersza polecenia programu do wykonania. Ścieżka jest względna względem folderu %ROLEROOT%\Approot (nie określaj folderu %ROLEROOT%\Approot w wierszu polecenia; zakłada się, że). %ROLEROOT% jest zmienną środowiskową przechowywaną przez platformę Azure i reprezentuje lokalizację folderu głównego roli. Folder %ROLEROOT%\Approot reprezentuje folder aplikacji dla twojej roli. Jeśli program zakończy się, rola jest odzyskiwana, więc ogólnie ustaw program, aby kontynuować uruchamianie, zamiast być programem, który po prostu uruchamia się i uruchamia skończone zadanie.
setReadyOnProcessStart	boolean	Wymagany. Określa, czy wystąpienie roli czeka na program wiersza polecenia, aby zasygnalizować po uruchomieniu. Ta wartość musi być ustawiona true na wartość w tej chwili. Ustawienie wartości na false wartość jest zarezerwowane do użycia w przyszłości.

Uruchamianie

Element Startup opisuje kolekcję zadań, które są uruchamiane po uruchomieniu roli. Ten element może być elementem nadrzędnym Variable elementu. Aby uzyskać więcej informacji na temat korzystania z zadań uruchamiania roli, zobacz Jak skonfigurować zadania uruchamiania. Ten element jest opcjonalny i rola może mieć tylko jeden blok uruchamiania.

W poniższej tabeli opisano atrybut Startup elementu.

Atrybut	Type	Opis
priority	int	Tylko do użytku wewnętrznego.

Zadanie

Element Task określa zadanie uruchamiania, które ma miejsce po uruchomieniu roli. Zadania uruchamiania mogą służyć do wykonywania zadań, które przygotowują rolę do uruchamiania takich składników oprogramowania lub uruchamiania innych aplikacji. Zadania są wykonywane w kolejności, w której są wyświetlane w Startup bloku elementu.

Element Task jest dostępny tylko przy użyciu zestawu Azure SDK w wersji 1.3 lub nowszej.

W poniższej tabeli opisano atrybuty Task elementu.

Atrybut	Type	Opis
commandLine	string	Wymagany. Skrypt, taki jak plik CMD, zawierający polecenia do uruchomienia. Polecenie uruchamiania i pliki wsadowe muszą być zapisane w formacie ANSI. Formaty plików, które ustawiają znacznik kolejności bajtów na początku procesów plików niepoprawnie.
executionContext	string	Określa kontekst, w którym jest uruchamiany skrypt. - limited [Ustawienie domyślne] — uruchom polecenie z tymi samymi uprawnieniami co rola hostująca proces. - elevated — Uruchom polecenie z uprawnieniami administratora.
taskType	string	Określa zachowanie wykonywania polecenia. - simple [Ustawienie domyślne] — system czeka na zakończenie zadania przed uruchomieniem innych zadań. - background — System nie czeka na zakończenie zadania. - foreground — Podobnie jak w tle, z wyjątkiem roli nie jest ponownie uruchamiana do momentu zakończenia wszystkich zadań pierwszego planu.

Zawartość

Element Contents opisuje kolekcję zawartości dla roli procesu roboczego. Ten element jest elementem nadrzędnym Content elementu.

Element Contents jest dostępny tylko przy użyciu zestawu Azure SDK w wersji 1.5 lub nowszej.

Zawartość

Element Content definiuje lokalizację źródłową zawartości do skopiowania do maszyny wirtualnej platformy Azure i ścieżkę docelową, do której kopiuje.

Element Content jest dostępny tylko przy użyciu zestawu Azure SDK w wersji 1.5 lub nowszej.

W poniższej tabeli opisano atrybuty Content elementu.

Atrybut	Type	Opis
destination	string	Wymagany. Lokalizacja na maszynie wirtualnej platformy Azure, do której jest umieszczona zawartość. Ta lokalizacja jest względna względem folderu %ROLEROOT%\Approot.

Ten element jest elementem nadrzędnym SourceDirectory elementu .

SourceDirectory

Element SourceDirectory definiuje katalog lokalny, z którego jest kopiowana zawartość. Użyj tego elementu, aby określić zawartość lokalną do skopiowania na maszynę wirtualną platformy Azure.

Element SourceDirectory jest dostępny tylko przy użyciu zestawu Azure SDK w wersji 1.5 lub nowszej.

W poniższej tabeli opisano atrybuty SourceDirectory elementu.

Atrybut	Type	Opis
path	string	Wymagany. Względna lub bezwzględna ścieżka katalogu lokalnego, którego zawartość jest kopiowana na maszynę wirtualną platformy Azure. Rozszerzenie zmiennych środowiskowych w ścieżce katalogu jest obsługiwane.

Zobacz też

Schemat definicji usługi w chmurze (klasyczny)