Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Ważne
Od 31 marca 2025 r. usługi w chmurze (wsparcie dodatkowe) są przestarzałe i zostaną w pełni wycofane 31 marca 2027 r. Dowiedz się więcej o tej deprecjacji i migracji.
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
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 webowych.
W poniższej tabeli opisano atrybuty WebRole elementu.
| Atrybut | Typ | Opis |
|---|---|---|
| nazwa | sznurek | To jest wymagane. Nazwa roli internetowej. Nazwa roli musi być unikatowa. |
| włącz wykonywanie kodu natywnego | typ logiczny (boolowski) | Opcjonalny. Wartość domyślna to true; wykonywanie kodu natywnego i pełne zaufanie są domyślnie włączone. Ustaw ten atrybut na wartość false, aby wyłączyć natywne wykonywanie kodu dla web role i zamiast tego użyj zaufania częściowego w Azure. |
| vmsize | sznurek | Opcjonalny. Ustaw tę wartość, aby zmienić rozmiar maszyny wirtualnej przydzielonej do roli. Domyślna wartość to Small. Aby uzyskać więcej informacji, zobacz Virtual Machine sizes for Cloud Services (Rozmiary maszyn wirtualnych dla usług w chmurze). |
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.
| Atrybut | Typ | Opis |
|---|---|---|
| nazwa | sznurek | To jest 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.
Zasoby lokalne
Element LocalResources opisuje kolekcję zasobów pamięci lokalnej dla roli sieci Web. Ten element jest elementem nadrzędnym LocalStorage elementu.
Pamięć lokalna
Element LocalStorage identyfikuje zasób magazynu lokalnego, który zapewnia miejsce systemu plików dla usługi w czasie wykonywania. Rola może określać zero lub więcej lokalnych zasobów pamięci.
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 |
|---|---|---|
| nazwa | sznurek | To jest wymagane. Unikalna nazwa dla lokalnego sklepu. |
| wyczyśćPrzyPonownymUżyciuRoli | typ logiczny (boolowski) | Opcjonalny. Wskazuje, czy magazyn lokalny powinien zostać oczyszczony po ponownym uruchomieniu roli. Wartość domyślna to true. |
| rozmiarWMb | int (integer) | 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 zbiór końcowych punktów wejściowych (zewnętrznych), wewnętrznych oraz punktów wejściowych instancji 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.
Uwaga
Każda wdrożona rola wymaga jednego wystąpienia dla każdej roli. Domyślny przydział subskrypcji jest ograniczony do 20 rdzeni i w związku z tym jest ograniczony do 20 wystąpień roli. Jeśli aplikacja wymaga więcej wystąpień niż zapewnia domyślne dostępne zasoby, zobacz Fakturowanie, Zarządzanie subskrypcjami i Wsparcie limitów przydziału, aby uzyskać więcej informacji na temat zwiększania limitu przydziału.
Punkt Wejściowy (InputEndpoint)
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.
| Atrybut | Typ | Opis |
|---|---|---|
| nazwa | sznurek | To jest wymagane. Unikatowa nazwa zewnętrznego punktu końcowego. |
| protokół | sznurek | To jest wymagane. Protokół transportu dla zewnętrznego punktu końcowego. W przypadku roli sieci Web możliwe wartości to HTTP, HTTPS, UDPlub TCP. |
| port | int (integer) | To jest wymagane. Port dla 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 | sznurek | Wymagane dla punktu końcowego HTTPS. Nazwa certyfikatu określonego przez element Certificate. |
| lokalny port | int (integer) | Opcjonalny. Określa port używany do połączeń wewnętrznych w punkcie końcowym. Atrybut localPort przypisuje port zewnętrzny na punkcie końcowym do portu wewnętrznego dla danej 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 localPortport jest taka sama jak atrybut. Ustaw wartość localPort na "*", aby automatycznie przypisać niezarezerwowany 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 | typ logiczny (boolowski) | Opcjonalny. Gdy wartość tego atrybutu jest ustawiona na true, stan usługi jest ignorowany, a moduł równoważenia obciążenia nie usunie punktu końcowego. Ustawienie tej wartości na true jest przydatne do debugowania zajętych instancji usługi. Domyślna wartość to false.
Uwaga: punkt końcowy może nadal odbierać ruch nawet wtedy, gdy rola nie ma statusu „Gotowe”. |
| Sonda równoważenia obciążenia | sznurek | Opcjonalny. Nazwa sondy równoważenia obciążenia skojarzona z punktem wejściowym. Aby uzyskać więcej informacji, zobacz LoadBalancerProbe Schema. |
WewnętrznyPunktKońcowy
Element InternalEndpoint opisuje wewnętrzny punkt końcowy roli internetowej. Wewnętrzny punkt końcowy jest dostępny tylko dla innych wystąpień ról uruchomionych w ramach usługi; nie jest on 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.
| Atrybut | Typ | Opis |
|---|---|---|
| nazwa | sznurek | To jest wymagane. Unikatowa nazwa wewnętrznego punktu końcowego. |
| protokół | sznurek | To jest wymagane. 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 (integer) | Opcjonalny. Port używany do wewnętrznych połączeń z równoważeniem obciążenia 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. |
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 punkt końcowy wejściowy wystąpienia jest przypisany do określonego portu z dostępnego zakresu 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 |
|---|---|---|
| nazwa | sznurek | To jest wymagane. Unikatowa nazwa punktu końcowego. |
| lokalny port | int (integer) | To jest wymagane. Określa port wewnętrzny, na który nasłuchują wszystkie instancje ról, aby odbierać ruch przychodzący przekazywany z load balancera. Możliwy zakres wartości z zakresu od 1 do 65535 włącznie. |
| protokół | sznurek | To jest wymagane. Protokół transportu dla wewnętrznego punktu końcowego. Możliwe wartości to udp lub tcp. Użyj tcp dla ruchu opartego na protokole http/https. |
PrzydzielPortPublicznyOd
Element AllocatePublicPortFrom opisuje zakres portów publicznych, którego klienci zewnętrzni mogą używać do uzyskiwania dostępu do każdego punktu końcowego wejścia instancji. Numer portu publicznego (VIP) jest przydzielany z tego zakresu i przypisywany do każdego indywidualnego punktu końcowego instancji roli podczas wdrażania i aktualizacji instancji dzierżawcy. 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.
Stały Port
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 (integer) | To jest wymagane. Port dla 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 instancji oraz ustala port używany do połączeń z równoważeniem obciążenia w punkcie końcowym.
Uwaga
Element FixedPortRange działa inaczej w zależności od elementu, w którym się znajduje. Gdy element FixedPortRange znajduje się w elemencie InternalEndpoint, otwiera wszystkie porty modułu równoważenia obciążenia w zakresie atrybutów min i max dla wszystkich maszyn wirtualnych, na których działa dana rola. Gdy element FixedPortRange znajduje się w elemencie InstanceInputEndpoint, otwiera tylko jeden port w zakresie określonym przez minimalne i maksymalne atrybuty 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 (integer) | To jest wymagane. 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). |
| maks | sznurek | To jest wymagane. Najwyższy port w przedziale. 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 internetowej. 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.
| Atrybut | Typ | Opis |
|---|---|---|
| nazwa | sznurek | To jest wymagane. Nazwa tego certyfikatu, która jest używana do odwoływania się do niego, gdy jest skojarzona z elementem HTTPS InputEndpoint . |
| lokalizacja sklepu | sznurek | To jest wymagane. Lokalizacja magazynu certyfikatów, w którym można znaleźć ten certyfikat na komputerze lokalnym. Możliwe wartości to CurrentUser i LocalMachine. |
| Nazwa sklepu | sznurek | To jest 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, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook lub dowolną niestandardową nazwę sklepu. Jeśli zostanie określona niestandardowa nazwa magazynu, magazyn zostanie utworzony automatycznie. |
| poziom uprawnień | sznurek | 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 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 importów.
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 |
|---|---|---|
| nazwa modułu | sznurek | To jest wymagane. Nazwa modułu do zaimportowania. Prawidłowe moduły importu to: - RemoteAccess - RemoteForwarder -Diagnostyka Moduły RemoteAccess i RemoteForwarder umożliwiają konfigurację instancji roli dla połączeń pulpitu zdalnego. Aby uzyskać więcej informacji, zobacz Rozszerzenia. Moduł Diagnostyka umożliwia zbieranie danych diagnostycznych dla instancji 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 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 | Typ | Opis |
|---|---|---|
| kontekst wykonania | sznurek | Opcjonalny. Określa kontekst, w którym proces roli jest uruchamiany. 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 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:
| Atrybut | Typ | Opis |
|---|---|---|
| nazwa | sznurek | To jest wymagane. Nazwa zmiennej środowiskowej do ustawienia. |
| wartość | sznurek | Opcjonalny. Wartość ustawiona dla zmiennej środowiskowej. Musisz dołączyć atrybut wartości lub element RoleInstanceValue. |
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 | Typ | Opis |
|---|---|---|
| xpath | sznurek | Opcjonalny. Ścieżka dostępu do ustawień wdrożenia dla instancji. Aby uzyskać więcej informacji, zobacz Zmienne konfiguracji za pomocą programu XPath. Musisz dołączyć atrybut wartości lub element RoleInstanceValue. |
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.
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 |
|---|---|---|
| nazwaZgromadzenia | sznurek | To jest wymagane. Ścieżka i nazwa pliku zestawu zawierającego punkt wejścia. Ścieżka jest względna względem folderu \%ROLEROOT%\Approot (nie określaj \%ROLEROOT%\Approot w wierszu poleceń; przyjmuje się, że jest określony domyślnie).
%ROLEROOT% jest zmienną środowiskową, która reprezentuje lokalizację folderu głównego roli i jest przechowywana przez platformę Azure. Folder \%ROLEROOT%\Approot reprezentuje folder aplikacji dla twojej roli. W przypadku ról HWC ścieżka jest zawsze względna względem folderu \%ROLEROOT%\Approot\bin . W przypadku pełnych ról sieci Web dla IIS i IIS Express, jeśli nie można odnaleźć zestawu w folderze \%ROLEROOT%\Approot, przeszukiwany jest folder \%ROLEROOT%\Approot\bin. To zachowanie awaryjne dla pełnej wersji IIS nie jest zalecane jako najlepsza praktyka i może zostać usunięte w przyszłych wersjach. |
| wersja docelowa platformy | sznurek | To jest wymagane. Wersja platformy .NET Framework, na której został skompilowany zestaw. Na przykład targetFrameworkVersion="v4.0". |
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.
Witryna internetowa
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 |
|---|---|---|
| nazwa | sznurek | To jest wymagane. Nazwa witryny internetowej lub aplikacji. |
| fizyczny katalog | sznurek | Lokalizacja katalogu zawartości dla folderu głównego witryny. Lokalizację można określić jako ścieżkę bezwzględną lub jako ścieżkę względną 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 |
|---|---|---|
| nazwa | sznurek | To jest wymagane. Określa nazwę identyfikującą aplikację wirtualną. |
| fizyczny katalog | sznurek | To jest wymagane. Określa ścieżkę na maszynie dewelopera zawierającej aplikację wirtualną. W emulatorze obliczeniowym usługi IIS są skonfigurowane do pobierania zawartości z tej lokalizacji. Po wdrożeniu na platformie Azure zawartość katalogu fizycznego jest spakowana wraz z resztą usługi. Po wdrożeniu pakietu usługi na platformie Azure program IIS jest skonfigurowany z lokalizacją rozpakowanej zawartości. |
VirtualDirectory
Element VirtualDirectory wskazuje nazwę katalogu (zwaną również ścieżką), którą określasz w IIS, i mapuje ją 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 |
|---|---|---|
| nazwa | sznurek | To jest wymagane. Określa nazwę identyfikującą katalog wirtualny. |
| wartość | fizyczny katalog | To jest wymagane. Określa ścieżkę na maszynie dewelopera zawierającej zawartość witryny internetowej lub katalogu wirtualnego. W emulatorze obliczeniowym usługi IIS są skonfigurowane do pobierania zawartości z tej lokalizacji. Po wdrożeniu na platformie Azure zawartość katalogu fizycznego jest spakowana wraz z resztą usługi. Po wdrożeniu pakietu usługi na platformie Azure program IIS jest skonfigurowany z lokalizacją rozpakowanej zawartości. |
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, zapoznaj się z tematem Włączanie komunikacji dla instancji 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.
| Atrybut | Typ | Opis |
|---|---|---|
| nazwa | sznurek | To jest wymagane. Określa nazwę identyfikującą powiązanie. |
| nazwaPunktuKońcowego | sznurek | To jest wymagane. Określa nazwę punktu końcowego, z który ma być powiązany. |
| hostHeader | sznurek | Opcjonalny. Określa nazwę hosta, która umożliwia hostowanie wielu witryn, z różnymi nazwami hostów, w jednej kombinacji adresu IP/numeru portu. |
Firma startupowa
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, a rola może mieć tylko jeden blok startowy.
W poniższej tabeli opisano atrybut Startup elementu.
| Atrybut | Typ | Opis |
|---|---|---|
| priorytet | int (integer) | 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 działania, takich jak instalowanie komponentó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.
| Atrybut | Typ | Opis |
|---|---|---|
| commandLine | sznurek | To jest 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 procesów plików niepoprawnie. |
| kontekst wykonania | sznurek | Określa kontekst, w którym jest uruchamiany skrypt. - limited [Ustawienie domyślne] — Uruchom z takimi samymi uprawnieniami, jakie ma rola hostująca proces.- elevated — Uruchom z uprawnieniami administratora. |
| typ zadania | sznurek | 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, że rola nie jest ponownie uruchamiana, dopóki wszystkie zadania pierwszego planu nie zostaną zakończone. |
Zawartość
Element Contents opisuje zbiór 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.
| Atrybut | Typ | Opis |
|---|---|---|
| cel podróży | sznurek | To jest wymagane. Lokalizacja na maszynie wirtualnej platformy Azure, do której umieszczana jest 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 |
|---|---|---|
| ścieżka | sznurek | To jest wymagane. Ścieżka względna lub absolutna lokalnego katalogu, którego zawartość jest kopiowana do maszyny wirtualnej Azure. Rozszerzenie zmiennych środowiskowych w ścieżce katalogu jest obsługiwane. |
Następne kroki
Schemat definicji usługi w chmurze (wsparcie dodatkowe).