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

Rola internetowa platformy Azure jest rolą dostosowaną do programowania aplikacji internetowych, która jest obsługiwana przez usługi IIS 7, takich jak ASP.NET, PHP, Windows Communication Foundation i FastCGI.

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

Podstawowy schemat definicji usługi dla roli sieci Web

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

<ServiceDefinition …>  
  <WebRole name="<web-role-name>" vmsize="<web-role-size>" enableNativeCodeExecution="[true|false]">  
    <Certificates>  
      <Certificate name="<certificate-name>" storeLocation="<certificate-store>" storeName="<store-name>" />  
    </Certificates>      
    <ConfigurationSettings>  
      <Setting name="<setting-name>" />  
    </ConfigurationSettings>  
    <Imports>  
      <Import moduleName="<import-module>"/>  
    </Imports>  
    <Endpoints>  
      <InputEndpoint certificate="<certificate-name>" ignoreRoleInstanceStatus="[true|false]" name="<input-endpoint-name>" protocol="[http|https|tcp|udp]" localPort="<port-number>" port="<port-number>" 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>  
    <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>"/>  
      </EntryPoint>  
    </Runtime>  
    <Sites>  
      <Site name="<web-site-name>">  
        <VirtualApplication name="<application-name>" physicalDirectory="<directory-path>"/>  
        <VirtualDirectory name="<directory-path>" physicalDirectory="<directory-path>"/>  
        <Bindings>  
          <Binding name="<binding-name>" endpointName="<endpoint-name-bound-to>" hostHeader="<url-of-the-site>"/>  
        </Bindings>  
      </Site>  
    </Sites>  
    <Startup priority="<for-internal-use-only>">  
      <Task commandLine="<command-to=execute>" 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>  
  </WebRole>  
</ServiceDefinition>  

Elementy schematu

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

WebRole

ConfigurationSettings

Ustawienie

LocalResources

LocalStorage

Punkty końcowe

Wewnętrzny punkt końcowy

InstanceInputEndpoint

PrzydzielPublicPortFrom

FixedPort

FixedPortRange

Certyfikaty

Certyfikat

Przywozu

Import

Środowisko uruchomieniowe

Środowisko

Zmienna

RoleInstanceValue

NetFxEntryPoint

Witryny

Miejsce

VirtualApplication

VirtualApplication

Powiązania

Wiążący

Startup

Zadanie

Treść

Zawartość

SourceDirectory

WebRole

Element WebRole opisuje rolę dostosowaną do programowania aplikacji internetowych, obsługiwaną przez usługi IIS 7 i ASP.NET. Usługa może zawierać zero lub więcej ról sieciowych.

W poniższej tabeli opisano atrybuty WebRole elementu.

Ustawienia Konfiguracji

Element ConfigurationSettings opisuje kolekcję ustawień konfiguracji dla roli sieci Web. 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.

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

Zasoby lokalne

Element LocalResources opisuje kolekcję zasobów pamięci lokalnej dla roli internetowej. Ten element jest elementem nadrzędnym LocalStorage elementu.

LocalStorage (lokalna pamięć)

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.

W poniższej tabeli opisano atrybuty LocalStorage elementu.

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 nadrzędnym dla elementów InputEndpoint, InternalEndpoint i 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 dla wejść instancji, 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.

Punkt wejściowy

Element InputEndpoint opisuje zewnętrzny punkt końcowy dla roli internetowej.

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 sieci Web używa portu 80 dla protokołu HTTP i portu 443 dla protokołu HTTPS, możesz określić, że druga rola sieci Web używa portu 8080 dla protokołu HTTP i portu 8043 dla protokołu HTTPS.

W poniższej tabeli opisano atrybuty InputEndpoint elementu.

Wewnętrzny punkt końcowy

Element InternalEndpoint opisuje wewnętrzny interfejs roli sieciowej. Wewnętrzny punkt końcowy jest dostępny tylko dla innych wystąpień ról uruchomionych w usłudze; nie jest dostępny dla klientów spoza usługi. Role sieci Web, które nie zawierają Sites elementu, mogą mieć tylko jeden wewnętrzny punkt końcowy HTTP, UDP lub TCP.

W poniższej tabeli opisano atrybuty InternalEndpoint elementu.

Punkt Wejściowy Instancji

Element InstanceInputEndpoint opisuje punkt końcowy wejściowy wystąpienia do roli webowej. Punkt końcowy wejściowy instancji jest powiązany z określoną instancją roli za pomocą przekierowania portów w load balancerze. 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.

PrzydzielPublicznyPortOd

Element AllocatePublicPortFrom opisuje zakres portów publicznych, którego klienci zewnętrzni mogą używać do dostępu do każdego punktu końcowego instancji. Numer publicznego portu (VIP) jest przyznawany z tego zakresu i przypisywany do każdego punktu końcowego indywidualnego wystąpienia roli podczas wdrażania i aktualizacji 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.

Port stały

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.

FixedPortRange

Element FixedPortRange określa zakres portów przypisanych do wewnętrznego punktu końcowego lub wejściowego punktu końcowego instancji oraz ustala port używany do połączeń z równoważeniem obciążenia w punkcie końcowym.

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.

Certyfikaty

Element Certificates opisuje kolekcję certyfikatów dla roli sieci Web. Ten element jest elementem nadrzędnym Certificate elementu. Rola może mieć dowolną liczbę powiązanych 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ą sieci Web.

W poniższej tabeli opisano atrybuty Certificate elementu.

Operacje importu

Element Imports opisuje kolekcję modułów importu dla roli sieci Web, 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 importu.

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

Importowanie

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.

Środowisko uruchomieniowe

Element Runtime opisuje kolekcję ustawień zmiennych środowiskowych dla roli internetowej, 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:

Środowisko

Element Environment opisuje kolekcję ustawień zmiennych środowiskowych dla roli sieci Web. Ten element jest elementem nadrzędnym Variable elementu. Rola może mieć dowolną liczbę 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:

RoleInstanceValue

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

W poniższej tabeli opisano atrybuty RoleInstanceValue elementu.

Punkt wejścia

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, który ma być uruchomiony dla roli.

W poniższej tabeli opisano atrybuty NetFxEntryPoint elementu.

Witryny

Element Sites opisuje kolekcję witryn internetowych i aplikacji internetowych hostowanych w roli sieci Web. Ten element jest elementem nadrzędnym Site elementu. Jeśli nie określisz elementu Sites, twoja rola internetowa jest hostowana jako starsza rola, co oznacza, że możesz mieć tylko jedną witrynę internetową. Ten element jest opcjonalny i rola może mieć tylko jeden blok witryn.

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

Miejsce

Element Site określa witrynę internetową lub aplikację internetową, która jest częścią roli sieci Web.

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

W poniższej tabeli opisano atrybuty Site elementu.

VirtualApplication

Element VirtualApplication definiuje aplikację w usługach Internet Information Services (IIS) 7 to grupa plików, która dostarcza zawartość lub udostępnia usługi za pośrednictwem protokołów, takich jak HTTP. Podczas tworzenia aplikacji w usługach IIS 7 ścieżka aplikacji staje się częścią adresu URL witryny.

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

W poniższej tabeli opisano atrybuty VirtualApplication elementu.

VirtualDirectory

Element VirtualDirectory określa nazwę katalogu (nazywaną również ścieżką), którą określasz w IIS i mapujesz na katalog fizyczny na serwerze lokalnym lub zdalnym.

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

W poniższej tabeli opisano atrybuty VirtualDirectory elementu.

Powiązania

Element Bindings opisuje kolekcję powiązań dla witryny internetowej. Jest to element nadrzędny elementu Binding. Element jest wymagany dla każdego Site elementu. Aby uzyskać więcej informacji na temat konfigurowania punktów końcowych, zobacz Włączanie komunikacji dla wystąpień ról.

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

Wiążący

Element Binding określa informacje o konfiguracji wymagane do żądań komunikowania się z witryną internetową lub aplikacją internetową.

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

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 jedna rola może mieć tylko jeden blok startowy.

W poniższej tabeli opisano atrybut Startup elementu.

Zadanie

Element Task określa zadanie uruchamiania, które ma miejsce po uruchomieniu roli. Zadania uruchamiania mogą być używane do przygotowywania roli do takich zadań, jak instalacja składników oprogramowania lub uruchamianie 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.

Zawartość

Element Contents opisuje kolekcję zawartości dla roli webowej. 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.

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.

Zobacz też

Schemat definicji usługi w chmurze (klasyczny)