Sdílet prostřednictvím


Schéma Webovérole definice služby Azure Cloud Services (rozšířená podpora)

Webová role Azure je role, která je přizpůsobená pro programování webových aplikací podle podpory služby IIS 7, jako jsou ASP.NET, PHP, Windows Communication Foundation a FastCGI.

Výchozí přípona definičního souboru služby je csdef.

Základní schéma definice služby pro webovou roli

Základní formát definičního souboru služby obsahujícího webovou roli je následující.

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

Prvky schématu

Definiční soubor služby obsahuje tyto prvky, které jsou podrobně popsány v dalších částech tohoto tématu:

Webovárole

Konfigurace Nastavení

Nastavení

LocalResources

Localstorage

Koncové body

InternalEndpoint

InstanceInputEndpoint

AllocatePublicPortFrom

FixedPort

FixedPortRange

Certifikáty

Certifikát

Dovoz

Import

Modul runtime

Prostředí

Proměnné

RoleInstanceValue

NetFxEntryPoint

Stránky

Pracoviště

VirtualApplication

VirtualApplication

Vazby

Binding

Startup

Úkol

Obsah

Obsah

SourceDirectory

WebRole

Tento WebRole prvek popisuje roli, která je přizpůsobená pro programování webových aplikací, jak je podporováno službou IIS 7 a ASP.NET. Služba může obsahovat nulové nebo více webových rolí.

Následující tabulka popisuje atributy elementu WebRole .

Atribut Typ Popis
name řetězec Povinný: Název webové role. Název role musí být jedinečný.
enableNativeCodeExecution boolean Nepovinné. Výchozí hodnota je true: spuštění nativního kódu a úplný vztah důvěryhodnosti jsou ve výchozím nastavení povolené. Nastavte tento atribut tak, aby false se zakázalo spouštění nativního kódu pro webovou roli a místo toho použijte částečný vztah důvěryhodnosti Azure.
vmsize řetězec Nepovinné. Nastavte tuto hodnotu tak, aby se změnila velikost virtuálního počítače, který je přidělen roli. Výchozí hodnota je Small. Další informace najdete v tématu Velikosti virtuálních počítačů pro cloudové služby.

Konfigurace Nastavení

Tento ConfigurationSettings element popisuje kolekci nastavení konfigurace pro webovou roli. Tento prvek je nadřazený element.Setting

Nastavení

Element Setting popisuje dvojici názvů a hodnot, která určuje nastavení konfigurace pro instanci role.

Následující tabulka popisuje atributy elementu Setting .

Atribut Typ Popis
name řetězec Povinný: Jedinečný název nastavení konfigurace.

Nastavení konfigurace pro roli jsou páry názvů a hodnot deklarované v definičním souboru služby a nastavené v konfiguračním souboru služby.

LocalResources

Tento LocalResources element popisuje kolekci prostředků místního úložiště pro webovou roli. Tento prvek je nadřazený element.LocalStorage

Localstorage

Element LocalStorage identifikuje místní prostředek úložiště, který poskytuje systémové místo systému souborů pro službu za běhu. Role může definovat nula nebo více prostředků místního úložiště.

Poznámka:

Prvek LocalStorage se může zobrazit jako podřízený WebRole prvek, který podporuje kompatibilitu se staršími verzemi sady Azure SDK.

Následující tabulka popisuje atributy elementu LocalStorage .

Atribut Typ Popis
name řetězec Povinný: Jedinečný název místního úložiště.
cleanOnRoleRecycle boolean Nepovinné. Určuje, jestli má být místní úložiště při restartování role vyčištěno. Výchozí hodnota je true.
sizeInMb int Nepovinné. Požadované množství místa úložiště, které se má přidělit pro místní úložiště, v MB. Pokud není zadaný, výchozí přidělený prostor úložiště je 100 MB. Minimální velikost úložného prostoru, který může být přidělen, je 1 MB.

Maximální velikost místních prostředků závisí na velikosti virtuálního počítače. Další informace najdete v tématu Velikosti virtuálních počítačů pro cloudové služby.

Název adresáře přiděleného prostředku místního úložiště odpovídá hodnotě zadané pro atribut name.

Koncové body

Tento Endpoints element popisuje kolekci vstupních (externích), interních a vstupních koncových bodů instance pro roli. Tento prvek je nadřazený objekt , InputEndpointInternalEndpointa InstanceInputEndpoint elementy.

Vstupní a interní koncové body se přidělují samostatně. Služba může mít celkem 25 vstupních, interních a instance vstupních koncových bodů, které je možné přidělit napříč 25 rolemi povolenými ve službě. Pokud máte například 5 rolí, můžete přidělit 5 vstupních koncových bodů pro každou roli nebo můžete přidělit 25 vstupních koncových bodů jedné roli nebo můžete přidělit 1 vstupní koncový bod každému 25 rolím.

Poznámka:

Každá nasazená role vyžaduje jednu instanci na roli. Výchozí zřizování pro předplatné je omezené na 20 jader, a proto je omezeno na 20 instancí role. Pokud vaše aplikace vyžaduje více instancí, než poskytuje výchozí zřizování, najdete v tématu Fakturace, Správa předplatného a Podpora kvót, kde najdete další informace o zvýšení kvóty.

InputEndpoint

Element InputEndpoint popisuje externí koncový bod pro webovou roli.

Můžete definovat více koncových bodů, které jsou kombinací koncových bodů HTTP, HTTPS, UDP a TCP. Můžete zadat libovolné číslo portu, které zvolíte pro vstupní koncový bod, ale čísla portů zadaná pro každou roli ve službě musí být jedinečná. Pokud například zadáte, že webová role používá port 80 pro HTTP a port 443 pro HTTPS, můžete určit, že druhá webová role používá port 8080 pro HTTP a port 8043 pro HTTPS.

Následující tabulka popisuje atributy elementu InputEndpoint .

Atribut Typ Popis
name řetězec Povinný: Jedinečný název externího koncového bodu
Protokol řetězec Povinný: Přenosový protokol pro externí koncový bod. Pro webovou roli mohou být HTTPmožné hodnoty , HTTPS, UDP, nebo TCP.
port int Povinný: Port pro externí koncový bod. Můžete zadat libovolné číslo portu, které zvolíte, ale čísla portů zadaná pro každou roli ve službě musí být jedinečná.

Možné hodnoty jsou v rozsahu od 1 do 65535 (včetně sady Azure SDK verze 1.7 nebo vyšší).
certifikát řetězec Vyžaduje se pro koncový bod HTTPS. Název certifikátu definovaného elementem Certificate .
localPort int Nepovinné. Určuje port používaný pro interní připojení v koncovém bodu. Atribut localPort mapuje externí port na koncový bod na interní port role. To je užitečné ve scénářích, kdy role musí komunikovat s interní komponentou na portu, který se liší od toho, který je vystaven externě.

Pokud není zadán, hodnota localPort je stejná jako port atribut. Nastavte hodnotu localPort na *, aby se automaticky přiřadil nepřidělený port, který je zjistitelný pomocí rozhraní API modulu runtime.

Možné hodnoty jsou v rozsahu od 1 do 65535 (včetně sady Azure SDK verze 1.7 nebo vyšší).

Atribut localPort je k dispozici pouze pomocí sady Azure SDK verze 1.3 nebo vyšší.
ignoreRoleInstanceStatus boolean Nepovinné. Pokud je hodnota tohoto atributu nastavena truena , stav služby bude ignorován a koncový bod nebude odebrán nástrojem pro vyrovnávání zatížení. Nastavení této hodnoty na true užitečné pro ladění zaneprázdněných instancí služby. Výchozí hodnota je false. Poznámka: Koncový bod může stále přijímat provoz, i když role není ve stavu Připraveno.
loadBalancerProbe řetězec Nepovinné. Název sondy nástroje pro vyrovnávání zatížení přidružené ke vstupnímu koncovému bodu. Další informace naleznete v tématu LoadBalancerProbe Schema.

InternalEndpoint

Tento InternalEndpoint element popisuje interní koncový bod pro webovou roli. Interní koncový bod je k dispozici pouze pro jiné instance rolí spuštěné v rámci služby; není k dispozici pro klienty mimo službu. Webové role, které Sites neobsahují prvek, můžou mít pouze jeden interní koncový bod HTTP, UDP nebo TCP.

Následující tabulka popisuje atributy elementu InternalEndpoint .

Atribut Typ Popis
name řetězec Povinný: Jedinečný název interního koncového bodu.
Protokol řetězec Povinný: Přenosový protokol pro interní koncový bod. Možné hodnoty jsou HTTP, , UDPTCPnebo ANY.

Hodnota ANY určuje, že jakýkoli protokol, jakýkoli port je povolený.
port int Nepovinné. Port používaný pro připojení s interním vyrovnáváním zatížení v koncovém bodu. Koncový bod s vyrovnáváním zatížení používá dva porty. Port použitý pro veřejnou IP adresu a port použitý na privátní IP adrese. Obvykle jsou tyto hodnoty nastavené na stejné, ale můžete zvolit použití různých portů.

Možné hodnoty jsou v rozsahu od 1 do 65535 (včetně sady Azure SDK verze 1.7 nebo vyšší).

Atribut Port je k dispozici pouze pomocí sady Azure SDK verze 1.3 nebo vyšší.

InstanceInputEndpoint

Element InstanceInputEndpoint popisuje vstupní koncový bod instance pro webovou roli. Vstupní koncový bod instance je přidružený ke konkrétní instanci role pomocí přesměrování portů v nástroji pro vyrovnávání zatížení. Každý vstupní koncový bod instance se mapuje na konkrétní port z rozsahu možných portů. Tento prvek je nadřazený element.AllocatePublicPortFrom

Tento InstanceInputEndpoint prvek je k dispozici pouze pomocí sady Azure SDK verze 1.7 nebo vyšší.

Následující tabulka popisuje atributy elementu InstanceInputEndpoint .

Atribut Typ Popis
name řetězec Povinný: Jedinečný název koncového bodu
localPort int Povinný: Určuje interní port, na který budou všechny instance rolí naslouchat, aby přijímaly příchozí provoz přesměrovaný z nástroje pro vyrovnávání zatížení. Možné hodnoty v rozsahu od 1 do 65535 včetně.
Protokol řetězec Povinný: Přenosový protokol pro interní koncový bod. Možné hodnoty jsou udp nebo tcp. Používá se tcp pro provoz založený na http/https.

AllocatePublicPortFrom

Tento AllocatePublicPortFrom prvek popisuje rozsah veřejného portu, který můžou externí zákazníci použít pro přístup ke vstupnímu koncovému bodu každé instance. Veřejné číslo portu (VIP) je přiděleno z tohoto rozsahu a přiřazeno každému koncovému bodu instance role během nasazování a aktualizace tenanta. Tento prvek je nadřazený element.FixedPortRange

Tento AllocatePublicPortFrom prvek je k dispozici pouze pomocí sady Azure SDK verze 1.7 nebo vyšší.

FixedPort

Element FixedPort určuje port pro interní koncový bod, který umožňuje připojení s vyrovnáváním zatížení v koncovém bodu.

Tento FixedPort prvek je k dispozici pouze pomocí sady Azure SDK verze 1.3 nebo vyšší.

Následující tabulka popisuje atributy elementu FixedPort .

Atribut Typ Popis
port int Povinný: Port pro interní koncový bod. To má stejný účinek jako nastavení minimálního a maximálního FixedPortRange počtu na stejný port.

Možné hodnoty jsou v rozsahu od 1 do 65535 (včetně sady Azure SDK verze 1.7 nebo vyšší).

FixedPortRange

Element FixedPortRange určuje rozsah portů, které jsou přiřazeny k internímu koncovému bodu nebo vstupnímu koncovému bodu instance, a nastaví port použitý pro připojení s vyrovnáváním zatížení v koncovém bodu.

Poznámka:

Prvek FixedPortRange funguje odlišně v závislosti na prvku, ve kterém se nachází. FixedPortRange Když je prvek v elementuInternalEndpoint, otevře všechny porty v nástroji pro vyrovnávání zatížení v rozsahu minimálních a maximálních atributů pro všechny virtuální počítače, na kterých se role spouští. FixedPortRange Když je prvek v elementuInstanceInputEndpoint, otevře pouze jeden port v rozsahu minimálních a maximálních atributů na každém virtuálním počítači, na kterém běží role.

Tento FixedPortRange prvek je k dispozici pouze pomocí sady Azure SDK verze 1.3 nebo vyšší.

Následující tabulka popisuje atributy elementu FixedPortRange .

Atribut Typ Popis
min int Povinný: Minimální port v rozsahu. Možné hodnoty jsou v rozsahu od 1 do 65535 (včetně sady Azure SDK verze 1.7 nebo vyšší).
max řetězec Povinný: Maximální port v rozsahu. Možné hodnoty jsou v rozsahu od 1 do 65535 (včetně sady Azure SDK verze 1.7 nebo vyšší).

Certifikáty

Tento Certificates element popisuje kolekci certifikátů pro webovou roli. Tento prvek je nadřazený element.Certificate Role může mít libovolný počet přidružených certifikátů. Další informace o použití elementu certifikátů naleznete v tématu Úprava souboru definice služby pomocí certifikátu.

Certifikát

Tento Certificate element popisuje certifikát přidružený k webové roli.

Následující tabulka popisuje atributy elementu Certificate .

Atribut Typ Popis
name řetězec Povinný: Název tohoto certifikátu, který se používá k odkazování na tento certifikát, když je přidružený k elementu HTTPS InputEndpoint .
Storelocation řetězec Povinný: Umístění úložiště certifikátů, kde se tento certifikát nachází na místním počítači. Možné hodnoty jsou CurrentUser a LocalMachine.
Storename řetězec Povinný: Název úložiště certifikátů, kde se tento certifikát nachází na místním počítači. Možné hodnoty zahrnují předdefinované názvy Myobchodů , Root, , TrustCA, Disallowed, TrustedPeople, , TrustedPublisher, AuthRoot, AddressBooknebo jakýkoli vlastní název úložiště. Pokud je zadán název vlastního úložiště, úložiště se automaticky vytvoří.
permissionLevel řetězec Nepovinné. Určuje přístupová oprávnění udělená procesům role. Pokud chcete, aby přístup k privátnímu klíči měly jenom procesy se zvýšenými oprávněními, zadejte elevated oprávnění. limitedOrElevated oprávnění umožňuje všem procesům rolí přístup k privátnímu klíči. Možné hodnoty jsou limitedOrElevated nebo elevated. Výchozí hodnota je limitedOrElevated.

Importy

Tento Imports element popisuje kolekci modulů importu pro webovou roli, která přidává komponenty do hostovaného operačního systému. Tento prvek je nadřazený element.Import Tento prvek je volitelný a role může mít pouze jeden blok importu.

Tento Imports prvek je k dispozici pouze pomocí sady Azure SDK verze 1.3 nebo vyšší.

Importovat

Element Import určuje modul, který se má přidat do hostovaného operačního systému.

Tento Import prvek je k dispozici pouze pomocí sady Azure SDK verze 1.3 nebo vyšší.

Následující tabulka popisuje atributy elementu Import .

Atribut Typ Popis
moduleName řetězec Povinný: Název modulu, který se má importovat. Platné moduly importu jsou:

– RemoteAccess
- RemoteForwarder
-Diagnostika

Moduly RemoteAccess a RemoteForwarder umožňují nakonfigurovat instanci role pro připojení ke vzdálené ploše. Další informace naleznete v tématu Rozšíření.

Modul Diagnostika umožňuje shromažďovat diagnostická data pro instanci role.

Šablona běhového prostředí

Tento Runtime element popisuje kolekci nastavení proměnných prostředí pro webovou roli, která řídí běhové prostředí hostitelského procesu Azure. Tento prvek je nadřazený element.Environment Tento prvek je volitelný a role může mít pouze jeden blok modulu runtime.

Tento Runtime prvek je k dispozici pouze pomocí sady Azure SDK verze 1.3 nebo vyšší.

Následující tabulka popisuje atributy elementu Runtime :

Atribut Typ Popis
Executioncontext řetězec Nepovinné. Určuje kontext, ve kterém je spuštěn proces role. Výchozí kontext je limited.

- limited– Proces se spustí bez oprávnění Správa istratoru.
- elevated– Proces se spustí s oprávněními Správa istratoru.

Prostředí

Element Environment popisuje kolekci nastavení proměnných prostředí pro webovou roli. Tento prvek je nadřazený element.Variable Role může mít libovolný počet nastavených proměnných prostředí.

Proměnná

Element Variable určuje proměnnou prostředí, která se má nastavit v hostovaném operačním systému.

Tento Variable prvek je k dispozici pouze pomocí sady Azure SDK verze 1.3 nebo vyšší.

Následující tabulka popisuje atributy elementu Variable :

Atribut Typ Popis
name řetězec Povinný: Název proměnné prostředí, která se má nastavit.
hodnota řetězec Nepovinné. Hodnota, která se má nastavit pro proměnnou prostředí. Musíte zahrnout atribut hodnoty nebo RoleInstanceValue prvek.

RoleInstanceValue

Element RoleInstanceValue určuje xPath, ze kterého se má načíst hodnota proměnné.

Následující tabulka popisuje atributy elementu RoleInstanceValue .

Atribut Typ Popis
Xpath řetězec Nepovinné. Cesta k umístění nastavení nasazení pro instanci Další informace naleznete v tématu Konfigurační proměnné pomocí XPath.

Musíte zahrnout atribut hodnoty nebo RoleInstanceValue prvek.

EntryPoint

Prvek EntryPoint určuje vstupní bod pro roli. Tento prvek je nadřazený element.NetFxEntryPoint Tyto prvky umožňují určit aplikaci jinou než výchozí WaWorkerHost.exe, která bude fungovat jako vstupní bod role.

Tento EntryPoint prvek je k dispozici pouze pomocí sady Azure SDK verze 1.5 nebo vyšší.

NetFxEntryPoint

Element NetFxEntryPoint určuje program, který se má spustit pro roli.

Poznámka:

Tento NetFxEntryPoint prvek je k dispozici pouze pomocí sady Azure SDK verze 1.5 nebo vyšší.

Následující tabulka popisuje atributy elementu NetFxEntryPoint .

Atribut Typ Popis
Assemblyname řetězec Povinný: Cesta a název souboru sestavení obsahujícího vstupní bod. Cesta je relativní ke složce \%ROLEROOT%\Approot (nezadávejte \%ROLEROOT%\Approot in commandLine, předpokládá se). %ROLEROOT% je proměnná prostředí udržovaná v Azure a představuje umístění kořenové složky pro vaši roli. Složka \%ROLEROOT%\Approot představuje složku aplikace pro vaši roli.

Pro role HWC je cesta vždy relativní vzhledem ke složce \%ROLEROOT%\Approot\bin .

Pro úplné webové role služby IIS a IIS Express, pokud sestavení nelze najít vzhledem ke složce \%ROLEROOT%\Approot , prohledá se složka \%ROLEROOT%\Approot\bin .

Toto záložní chování pro úplnou službu IIS není doporučeným postupem a možná je v budoucích verzích odebráno.
targetFrameworkVersion řetězec Povinný: Verze rozhraní .NET Framework, na které bylo sestavení vytvořeno. Například, targetFrameworkVersion="v4.0".

Weby

Tento Sites prvek popisuje kolekci webů a webových aplikací hostovaných ve webové roli. Tento prvek je nadřazený element.Site Pokud nezadáte Sites prvek, vaše webová role se hostuje jako starší webová role a ve webové roli můžete hostovat jenom jeden web. Tento prvek je volitelný a role může mít pouze jeden blok lokalit.

Tento Sites prvek je k dispozici pouze pomocí sady Azure SDK verze 1.3 nebo vyšší.

Lokalita

Prvek Site určuje web nebo webovou aplikaci, která je součástí webové role.

Tento Site prvek je k dispozici pouze pomocí sady Azure SDK verze 1.3 nebo vyšší.

Následující tabulka popisuje atributy elementu Site .

Atribut Typ Popis
name řetězec Povinný: Název webu nebo aplikace.
physicalDirectory řetězec Umístění adresáře obsahu pro kořen webu. Umístění lze zadat jako absolutní cestu nebo relativní k umístění csdef.

VirtualApplication

Element VirtualApplication definuje aplikaci v Internetová informační služba (IIS) 7 je seskupení souborů, které doručují obsah nebo poskytují služby přes protokoly, jako je HTTP. Při vytváření aplikace ve službě IIS 7 se cesta aplikace stane součástí adresy URL webu.

Tento VirtualApplication prvek je k dispozici pouze pomocí sady Azure SDK verze 1.3 nebo vyšší.

Následující tabulka popisuje atributy elementu VirtualApplication .

Atribut Typ Popis
name řetězec Povinný: Určuje název pro identifikaci virtuální aplikace.
physicalDirectory řetězec Povinný: Určuje cestu na vývojovém počítači, který obsahuje virtuální aplikaci. V emulátoru výpočetních prostředků je služba IIS nakonfigurovaná tak, aby načítala obsah z tohoto umístění. Při nasazování do Azure se obsah fyzického adresáře zabalí spolu se zbytkem služby. Po nasazení balíčku služby do Azure se služba IIS nakonfiguruje s umístěním rozbaleného obsahu.

Virtualdirectory

Element VirtualDirectory určuje název adresáře (označovaný také jako cesta), který zadáte ve službě IIS, a mapuje se na fyzický adresář na místním nebo vzdáleném serveru.

Tento VirtualDirectory prvek je k dispozici pouze pomocí sady Azure SDK verze 1.3 nebo vyšší.

Následující tabulka popisuje atributy elementu VirtualDirectory .

Atribut Typ Popis
name řetězec Povinný: Určuje název pro identifikaci virtuálního adresáře.
hodnota physicalDirectory Povinný: Určuje cestu na vývojovém počítači, který obsahuje obsah webu nebo virtuálního adresáře. V emulátoru výpočetních prostředků je služba IIS nakonfigurovaná tak, aby načítala obsah z tohoto umístění. Při nasazování do Azure se obsah fyzického adresáře zabalí spolu se zbytkem služby. Po nasazení balíčku služby do Azure se služba IIS nakonfiguruje s umístěním rozbaleného obsahu.

Vazby

Element Bindings popisuje kolekci vazeb pro web. Je to nadřazený prvek elementu Binding . Prvek je vyžadován pro každý Site prvek. Další informace o konfiguraci koncových bodů najdete v tématu Povolení komunikace pro instance rolí.

Tento Bindings prvek je k dispozici pouze pomocí sady Azure SDK verze 1.3 nebo vyšší.

Vytváření vazby

Element Binding určuje informace o konfiguraci vyžadované pro žádosti o komunikaci s webem nebo webovou aplikací.

Tento Binding prvek je k dispozici pouze pomocí sady Azure SDK verze 1.3 nebo vyšší.

Atribut Typ Popis
name řetězec Povinný: Určuje název pro identifikaci vazby.
endpointName řetězec Povinný: Určuje název koncového bodu, ke které se má vytvořit vazba.
hostHeader řetězec Nepovinné. Určuje název hostitele, který umožňuje hostovat více lokalit s různými názvy hostitelů v jedné kombinaci IP adresy nebo portu.

Spuštění

Element Startup popisuje kolekci úloh, které se spouští při spuštění role. Tento prvek může být nadřazený Variable element. Další informace o používání úloh po spuštění role naleznete v tématu Konfigurace úloh po spuštění. Tento prvek je volitelný a role může mít pouze jeden spouštěcí blok.

Následující tabulka popisuje atribut elementu Startup .

Atribut Typ Popis
Prioritou int Pouze pro vnitřní potřebu

Úkol

Element Task určuje spouštěcí úlohu, která probíhá při spuštění role. Úlohy po spuštění je možné použít k provádění úloh, které připraví roli ke spuštění takových softwarových komponent nebo spouštění jiných aplikací. Úkoly se provádějí v pořadí, ve kterém se zobrazují v bloku elementu Startup .

Tento Task prvek je k dispozici pouze pomocí sady Azure SDK verze 1.3 nebo vyšší.

Následující tabulka popisuje atributy elementu Task .

Atribut Typ Popis
Commandline řetězec Povinný: Skript, například soubor CMD, který obsahuje příkazy ke spuštění. Spouštěcí příkaz a dávkové soubory musí být uloženy ve formátu ANSI. Formáty souborů, které na začátku souboru nastavují značku pořadí bajtů, nebudou správně zpracovávat.
Executioncontext řetězec Určuje kontext, ve kterém se skript spouští.

- limited [Výchozí] – Spusťte se stejnými oprávněními jako role hostující proces.
- elevated – Spusťte s oprávněními správce.
taskType řetězec Určuje chování spuštění příkazu.

- simple [Výchozí] – Systém čeká na ukončení úkolu před spuštěním jiných úkolů.
- background – Systém nečeká na ukončení úlohy.
- foreground – Podobně jako na pozadí, s výjimkou role se nerestartuje, dokud všechny úkoly na popředí neodejde.

Obsah

Element Contents popisuje kolekci obsahu pro webovou roli. Tento prvek je nadřazený element.Content

Tento Contents prvek je k dispozici pouze pomocí sady Azure SDK verze 1.5 nebo vyšší.

Obsah

Element Content definuje zdrojové umístění obsahu, které se má zkopírovat do virtuálního počítače Azure, a cílovou cestu, do které se zkopíruje.

Tento Content prvek je k dispozici pouze pomocí sady Azure SDK verze 1.5 nebo vyšší.

Následující tabulka popisuje atributy elementu Content .

Atribut Typ Popis
destination řetězec Povinný: Umístění na virtuálním počítači Azure, do kterého se obsah umístí. Toto umístění je relativní vzhledem ke složce %ROLEROOT%\Approot.

Tento element je nadřazený prvek elementu SourceDirectory .

SourceDirectory

Element SourceDirectory definuje místní adresář, ze kterého se obsah zkopíruje. Tento element použijte k určení místního obsahu, který se má zkopírovat do virtuálního počítače Azure.

Tento SourceDirectory prvek je k dispozici pouze pomocí sady Azure SDK verze 1.5 nebo vyšší.

Následující tabulka popisuje atributy elementu SourceDirectory .

Atribut Typ Popis
path řetězec Povinný: Relativní nebo absolutní cesta místního adresáře, jehož obsah se zkopíruje do virtuálního počítače Azure. Rozšíření proměnných prostředí v cestě k adresáři je podporováno.

Viz také

Schéma definice cloudové služby (rozšířená podpora)