Schemat webrole definicji usługi Azure Cloud Services (wersja klasyczna)
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)."
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, szczegółowo opisane w kolejnych sekcjach w tym temacie:
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 sieci Web.
W poniższej tabeli opisano atrybuty WebRole
elementu.
Atrybut | Typ | Opis |
---|---|---|
name | ciąg | Wymagane. Nazwa roli sieci Web. 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ć wykonywanie kodu natywnego dla roli internetowej, a zamiast tego użyj częściowego zaufania platformy Azure. |
vmsize | ciąg | Opcjonalny. Ustaw tę wartość, aby zmienić rozmiar maszyny wirtualnej przydzielonej do roli. Wartość domyślna to Small . Aby uzyskać więcej informacji, zobacz Rozmiary maszyn wirtualnych dla Cloud Services. |
Configurationsettings
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.
Atrybut | Typ | Opis |
---|---|---|
name | ciąg | Wymagane. 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 sieci Web. Ten element jest elementem nadrzędnym LocalStorage
elementu.
Localstorage
Element LocalStorage
identyfikuje lokalny zasób magazynu, który zapewnia miejsce w systemie 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 WebRole
elementu w celu zapewnienia zgodności z wcześniejszymi wersjami zestawu Azure SDK.
W poniższej tabeli opisano atrybuty LocalStorage
elementu.
Atrybut | Typ | Opis |
---|---|---|
name | ciąg | Wymagane. Unikatowa nazwa magazynu lokalnego. |
cleanOnRoleRecycle | boolean | Opcjonalny. Wskazuje, czy magazyn lokalny powinien być czyszczony 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ślnie przydzielone miejsce do magazynowania wynosi 100 MB. Minimalna ilość miejsca do magazynowania, którą można przydzielić, wynosi 1 MB. Maksymalny rozmiar zasobów lokalnych zależy od rozmiaru maszyny wirtualnej. Aby uzyskać więcej informacji, zobacz Rozmiary maszyn wirtualnych dla Cloud Services. |
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 InputEndpoint
elementów , InternalEndpoint
i InstanceInputEndpoint
.
Wejściowe i wewnętrzne punkty końcowe są przydzielane oddzielnie. Usługa może mieć łącznie 25 wejściowych, wewnętrznych i wejściowych punktów końcowych wystąpienia, które można przydzielić do 25 ról dozwolonych w usłudze. Jeśli na przykład masz 5 ról, możesz przydzielić 5 wejściowych punktów końcowych na rolę lub przydzielić 25 wejściowych punktów końcowych do jednej roli lub przydzielić 1 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 dla roli sieci Web.
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.
Atrybut | Typ | Opis |
---|---|---|
name | ciąg | Wymagane. Unikatowa nazwa zewnętrznego punktu końcowego. |
Protokół | ciąg | Wymagane. Protokół transportu dla zewnętrznego punktu końcowego. W przypadku roli sieci Web możliwe wartości to HTTP , HTTPS , UDP lub TCP . |
port | int | Wymagane. Port zewnętrznego punktu końcowego. Możesz określić dowolny wybrany numer portu, ale numery portów określone dla każdej roli w usłudze muszą być unikatowe. Możliwe wartości mieszczą się w zakresie od 1 do 65535 włącznie (zestaw Azure SDK w wersji 1.7 lub nowszej). |
certyfikat | ciąg | Wymagane dla punktu końcowego HTTPS. Nazwa certyfikatu zdefiniowanego Certificate przez element. |
Port_lokalny | int | Opcjonalny. Określa port używany dla połączeń wewnętrznych w punkcie końcowym. Atrybut localPort mapuje port zewnętrzny w punkcie końcowym na port wewnętrzny w roli. Jest to przydatne 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ślony, wartość localPort jest taka sama jak port atrybut. Ustaw wartość localPort "*", aby automatycznie przypisać nieprzydzielony port, który można odnaleźć przy użyciu interfejsu API środowiska uruchomieniowego.Możliwe wartości mieszczą się w zakresie 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 punkt końcowy nie zostanie usunięty przez moduł równoważenia obciążenia. Ustawienie tej wartości na true wartość przydatną do debugowania zajętych wystąpień usługi. Wartość domyślna to false . Uwaga: Punkt końcowy nadal może odbierać ruch nawet wtedy, gdy rola nie jest w stanie Gotowe. |
loadBalancerProbe | ciąg | Opcjonalny. Nazwa sondy modułu równoważenia obciążenia skojarzonego 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 sieci Web. Wewnętrzny punkt końcowy jest dostępny tylko dla innych wystąpień roli uruchomionych w usłudze; nie jest ona dostępna 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.
Atrybut | Typ | Opis |
---|---|---|
name | ciąg | Wymagane. Unikatowa nazwa wewnętrznego punktu końcowego. |
Protokół | ciąg | Wymagane. Protokół transportu dla wewnętrznego punktu końcowego. Możliwe wartości to HTTP , TCP , UDP lub ANY .Wartość określa ANY , ż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 o zrównoważonym obciążeniu używa dwóch portów. Port używany dla publicznego adresu IP i port używany na prywatnym adresie IP. Zazwyczaj są one ustawione na to samo, ale można użyć różnych portów. Możliwe wartości mieszczą się w zakresie 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 w roli sieci Web. 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 punkt końcowy wejściowy 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 | Typ | Opis |
---|---|---|
name | ciąg | Wymagane. Unikatowa nazwa punktu końcowego. |
Port_lokalny | int | Wymagane. Określa port wewnętrzny, do którego będą nasłuchiwane 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ół | ciąg | Wymagane. Protokół transportu dla wewnętrznego punktu końcowego. Możliwe wartości to udp lub tcp . Służy tcp do obsługi ruchu opartego na protokole http/https. |
PrzydzielpublicPortFrom
Element AllocatePublicPortFrom
opisuje zakres portów publicznych, który może być używany przez klientów zewnętrznych do uzyskiwania dostępu do każdego punktu końcowego wejściowego 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 | Typ | Opis |
---|---|---|
port | int | Wymagane. Port wewnętrznego punktu końcowego. Ma to taki sam efekt, jak ustawienie FixedPortRange wartości min i maksymalnej na ten sam port.Możliwe wartości wahają się 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 punktu końcowego wejściowego 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. Gdy FixedPortRange
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 działa rola. Gdy FixedPortRange
element znajduje się w InstanceInputEndpoint
elemecie, 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 | Typ | Opis |
---|---|---|
min | int | Wymagane. Minimalny port w zakresie. Możliwe wartości wahają się od 1 do 65535 włącznie (zestaw Azure SDK w wersji 1.7 lub nowszej). |
max | ciąg | Wymagane. Maksymalny port w zakresie. Możliwe wartości wahają się od 1 do 65535 włącznie (zestaw Azure SDK w wersji 1.7 lub nowszej). |
Certyfikaty
Element Certificates
opisuje zbieranie certyfikatów dla roli sieci Web. 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 certyfikatów, 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.
Atrybut | Typ | Opis |
---|---|---|
name | ciąg | Wymagane. Nazwa tego certyfikatu, która jest używana do odwoływania się do niego, gdy jest skojarzona z elementem HTTPS InputEndpoint . |
Storelocation | ciąg | Wymagane. Lokalizacja magazynu certyfikatów, w którym można znaleźć ten certyfikat na komputerze lokalnym. Możliwe wartości to CurrentUser i LocalMachine . |
Storename | ciąg | Wymagane. Nazwa magazynu certyfikatów, w którym znajduje się ten certyfikat na komputerze lokalnym. Możliwe wartości obejmują wbudowane nazwy sklepów My , , Root , TrustedPeople CA Disallowed TrustedPublisher Trust AuthRoot , AddressBook lub dowolną niestandardową nazwę magazynu. Jeśli zostanie określona niestandardowa nazwa magazynu, magazyn zostanie utworzony automatycznie. |
permissionLevel | ciąg | Opcjonalny. Określa uprawnienia dostępu przyznane 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 . Wartość domyślna to limitedOrElevated . |
Przywozu
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, a 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.
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 | Typ | Opis |
---|---|---|
moduleName | ciąg | Wymagane. 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 internetowej, która kontroluje środowisko uruchomieniowe procesu hosta platformy Azure. Ten element jest elementem nadrzędnym Environment
elementu. Ten element jest opcjonalny, a 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 | Typ | Opis |
---|---|---|
Executioncontext | ciąg | Opcjonalny. Określa kontekst, w którym jest uruchamiany proces roli. Domyślny kontekst to 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 internetowej. 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 | Typ | Opis |
---|---|---|
name | ciąg | Wymagane. Nazwa zmiennej środowiskowej do ustawienia. |
wartość | ciąg | Opcjonalny. Wartość ustawiana dla zmiennej środowiskowej. Musisz dołączyć atrybut wartości lub RoleInstanceValue element. |
RoleInstanceValue
Element RoleInstanceValue
określa xPath, z którego ma pobrać wartość zmiennej.
W poniższej tabeli opisano atrybuty RoleInstanceValue
elementu.
Atrybut | Typ | Opis |
---|---|---|
Xpath | ciąg | 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 umożliwiają określenie aplikacji inną niż domyślna WaWorkerHost.exe do działania 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 | Typ | Opis |
---|---|---|
Assemblyname | ciąg | Wymagane. Ścieżka i nazwa pliku zestawu zawierającego punkt wejścia. Ścieżka jest względna względem folderu \%ROLEROOT%\Approot (nie należy określać folderu \%ROLEROOT%\Approot w commandLine folderze , zakłada się). %ROLEROOT% to zmienna środowiskowa utrzymywana przez platformę Azure i reprezentuje lokalizację folderu głównego roli. Folder \%ROLEROOT%\Approot reprezentuje folder aplikacji dla roli.W przypadku ról HWC ścieżka jest zawsze względna względem folderu \%ROLEROOT%\Approot\bin . W przypadku pełnych ról usług IIS i IIS Express sieci Web, jeśli nie można odnaleźć zestawu względem folderu \%ROLEROOT%\Approot, przeszukiwany jest folder \%ROLEROOT%\Approot\bin. To zachowanie rezerwowe dla pełnych usług IIS nie jest zalecanym najlepszym rozwiązaniem i może zostać usunięte w przyszłych wersjach. |
Targetframeworkversion | ciąg | Wymagane. Wersja platformy .NET Framework, na której utworzono zestaw. Na przykład targetFrameworkVersion="v4.0" . |
Witryny
Element Sites
opisuje kolekcję witryn internetowych i aplikacji internetowych hostowanych w roli internetowej. Ten element jest elementem nadrzędnym Site
elementu. Jeśli nie określisz Sites
elementu, rola sieci Web jest hostowana jako starsza rola sieci Web i możesz mieć tylko jedną witrynę internetową hostowaną w roli sieci Web. Ten element jest opcjonalny i rola może mieć tylko jeden blok lokacji.
Element Sites
jest dostępny tylko przy użyciu zestawu Azure SDK w wersji 1.3 lub nowszej.
Witryna
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.
Atrybut | Typ | Opis |
---|---|---|
name | ciąg | Wymagane. Nazwa witryny internetowej lub aplikacji. |
physicalDirectory | ciąg | Lokalizacja katalogu zawartości dla katalogu głównego witryny. Lokalizację można określić jako ścieżkę bezwzględną lub względem lokalizacji csdef. |
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.
Atrybut | Typ | Opis |
---|---|---|
name | ciąg | Wymagane. Określa nazwę identyfikującą aplikację wirtualną. |
physicalDirectory | ciąg | Wymagane. Określa ścieżkę na maszynie programistycznej zawierającej aplikację wirtualną. W emulatorze obliczeniowym usługi IIS są skonfigurowane do pobierania zawartości z tej lokalizacji. Podczas wdrażania na platformie Azure zawartość katalogu fizycznego jest pakowana wraz z resztą usługi. Gdy pakiet usługi zostanie wdrożony na platformie Azure, usługi IIS są skonfigurowane z lokalizacją rozpakowanej zawartości. |
Virtualdirectory
Element VirtualDirectory
określa nazwę katalogu (nazywaną również ścieżką), która jest określana w usługach IIS i mapuje 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.
Atrybut | Typ | Opis |
---|---|---|
name | ciąg | Wymagane. Określa nazwę identyfikującą katalog wirtualny. |
wartość | physicalDirectory | Wymagane. Określa ścieżkę na maszynie programistycznej zawierającej zawartość witryny internetowej lub katalogu wirtualnego. W emulatorze obliczeniowym usługi IIS są skonfigurowane do pobierania zawartości z tej lokalizacji. Podczas wdrażania na platformie Azure zawartość katalogu fizycznego jest pakowana wraz z resztą usługi. Gdy pakiet usługi zostanie wdrożony na platformie Azure, usługi IIS są skonfigurowane z lokalizacją rozpakowanej zawartości. |
Powiązania
Element Bindings
opisuje kolekcję powiązań dla witryny internetowej. Jest to element Binding
nadrzędny elementu. 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ązanie
Element Binding
określa informacje o konfiguracji wymagane do komunikacji żądań z witryną internetową lub aplikacją internetową.
Element Binding
jest dostępny tylko przy użyciu zestawu Azure SDK w wersji 1.3 lub nowszej.
Atrybut | Typ | Opis |
---|---|---|
name | ciąg | Wymagane. Określa nazwę identyfikującą powiązanie. |
endpointName | ciąg | Wymagane. Określa nazwę punktu końcowego do powiązania. |
hostHeader | ciąg | Opcjonalny. Określa nazwę hosta, która umożliwia hostowanie wielu lokacji z różnymi nazwami hostów w jednej kombinacji adresu IP/numeru portu. |
Uruchamianie
Element Startup
opisuje kolekcję zadań uruchamianych 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, a rola może mieć tylko jeden blok uruchamiania.
W poniższej Startup
tabeli opisano atrybut elementu.
Atrybut | Typ | 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 | Typ | Opis |
---|---|---|
Commandline | ciąg | Wymagane. 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 pliku, nie będą prawidłowo przetwarzane. |
Executioncontext | ciąg | 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 | ciąg | 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 uruchamiana ponownie do momentu zakończenia wszystkich zadań pierwszego planu. |
Zawartość
Element Contents
opisuje kolekcję zawartości dla roli sieci Web. 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 na maszynę wirtualną platformy Azure i ścieżkę docelową, do której jest kopiowany.
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 | Typ | Opis |
---|---|---|
destination | ciąg | Wymagane. Lokalizacja na maszynie wirtualnej platformy Azure, do której jest umieszczana 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 | Typ | Opis |
---|---|---|
path | ciąg | Wymagane. Względna lub bezwzględna ścieżka katalogu lokalnego, którego zawartość zostanie skopiowana do maszyny wirtualnej platformy Azure. Obsługiwane jest rozszerzanie zmiennych środowiskowych w ścieżce katalogu. |