Azure Cloud Services (klasszikus) definíció – WebRole-séma
Fontos
Cloud Services (klasszikus) mostantól elavult az új ügyfelek számára, és 2024. augusztus 31-én minden ügyfél számára megszűnik. Az új üzemelő példányoknak az új Azure Resource Manager-alapú Azure Cloud Services (kiterjesztett támogatás) üzembehelyezési modellt kell használniuk.
Az Azure webes szerepkör olyan szerepkör, amely az IIS 7 által támogatott webalkalmazás-programozáshoz van testre szabva, például ASP.NET, PHP, Windows Communication Foundation és FastCGI.
A szolgáltatásdefiníciós fájl alapértelmezett bővítménye a .csdef.
Alapszintű szolgáltatásdefiníciós séma webes szerepkörhöz
A webes szerepkört tartalmazó szolgáltatásdefiníciós fájl alapformátuma a következő.
<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>
Sémaelemek
A szolgáltatásdefiníciós fájl tartalmazza ezeket az elemeket, amelyek részletes leírását a jelen témakör következő szakaszaiban találja:
WebRole
Az WebRole elem egy webalkalmazás-programozáshoz testre szabott szerepkört ír le, amelyet az IIS 7 és a ASP.NET támogat. A szolgáltatások nulla vagy több webes szerepkört tartalmazhatnak.
Az alábbi táblázat az elem attribútumait WebRole ismerteti.
| Attribútum | Típus | Description |
|---|---|---|
| name | sztring | Kötelező. A webes szerepkör neve. A szerepkör nevének egyedinek kell lennie. |
| enableNativeCodeExecution | boolean | Választható. Az alapértelmezett érték a true; natív kódvégrehajtás és a teljes megbízhatóság alapértelmezés szerint engedélyezve van. Állítsa be ezt az attribútumot úgy, hogy false letiltsa a webes szerepkör natív kódvégrehajtását, és használja helyette az Azure részleges megbízhatóságát. |
| vmsize | sztring | Választható. Állítsa be ezt az értéket a szerepkörre kiosztott virtuális gép méretének módosításához. Az alapértelmezett érték Small. További információ: Virtuálisgép-méretek Cloud Services. |
ConfigurationSettings
Az ConfigurationSettings elem egy webes szerepkör konfigurációs beállításainak gyűjteményét ismerteti. Ez az elem az elem szülője Setting .
Beállítás
Az Setting elem egy név- és értékpárt ír le, amely egy szerepkörpéldány konfigurációs beállítását adja meg.
Az alábbi táblázat az elem attribútumait Setting ismerteti.
| Attribútum | Típus | Description |
|---|---|---|
| name | sztring | Kötelező. A konfigurációs beállítás egyedi neve. |
A szerepkörök konfigurációs beállításai a szolgáltatásdefiníciós fájlban deklarált és a szolgáltatáskonfigurációs fájlban beállított név- és értékpárok.
LocalResources
Az LocalResources elem egy webes szerepkörhöz tartozó helyi tárolási erőforrások gyűjteményét ismerteti. Ez az elem az elem szülője LocalStorage .
Localstorage
Az LocalStorage elem egy helyi tárolási erőforrást azonosít, amely fájlrendszer-helyet biztosít a szolgáltatás számára futásidőben. A szerepkörök nulla vagy több helyi tárolási erőforrást definiálhatnak.
Megjegyzés
Az LocalStorage elem az elem gyermekeként jelenhet meg, WebRole hogy támogassa az Azure SDK korábbi verzióival való kompatibilitást.
Az alábbi táblázat az elem attribútumait LocalStorage ismerteti.
| Attribútum | Típus | Description |
|---|---|---|
| name | sztring | Kötelező. A helyi áruház egyedi neve. |
| cleanOnRoleRecycle | boolean | Választható. Azt jelzi, hogy a helyi tárolót meg kell-e tisztítani a szerepkör újraindításakor. Az alapértelmezett érték true. |
| sizeInMb | int | Választható. A helyi tároló számára lefoglalt tárterület kívánt mennyisége MB-ban. Ha nincs megadva, a lefoglalt alapértelmezett tárterület 100 MB. A lefoglalható minimális tárterület 1 MB. A helyi erőforrások maximális mérete a virtuális gép méretétől függ. További információ: Virtuálisgép-méretek Cloud Services. |
A helyi tárolási erőforráshoz lefoglalt könyvtár neve megfelel a névattribútumhoz megadott értéknek.
Végpontok
Az Endpoints elem egy szerepkör bemeneti (külső), belső és példánybemeneti végpontjainak gyűjteményét ismerteti. Ez az elem a , InternalEndpointés InstanceInputEndpoint elem szülőjeInputEndpoint.
A bemeneti és a belső végpontok külön vannak lefoglalva. Egy szolgáltatás összesen 25 bemeneti, belső és példánybemeneti végponttal rendelkezhet, amelyek a szolgáltatásban engedélyezett 25 szerepkör között foglalhatók le. Ha például 5 szerepkörrel rendelkezik, szerepkörenként 5 bemeneti végpontot foglalhat le, vagy 25 bemeneti végpontot foglalhat le egyetlen szerepkörhöz, vagy 1 bemeneti végpontot lefoglalhat 25 szerepkörhöz.
Megjegyzés
Minden üzembe helyezett szerepkörhöz szerepkörenként egy példány szükséges. Az előfizetés alapértelmezett kiépítése 20 magra korlátozódik, így egy szerepkör 20 példányára korlátozódik. Ha az alkalmazásnak több példányra van szüksége, mint amennyit az alapértelmezett kiépítés biztosít, tekintse meg a számlázással, az előfizetés-kezeléssel és a kvótatámogatással kapcsolatos további információkat a kvóta növeléséről.
InputEndpoint
Az InputEndpoint elem egy webes szerepkör külső végpontjának leírását írja le.
Több végpontot is meghatározhat, amelyek a HTTP, a HTTPS, az UDP és a TCP-végpontok kombinációját képezik. A bemeneti végponthoz tetszőleges portszámot megadhat, de a szolgáltatásban az egyes szerepkörökhöz megadott portszámoknak egyedinek kell lenniük. Ha például azt adja meg, hogy egy webes szerepkör a HTTP-hez a 80-at, a HTTPS-hez pedig a 443-at használja, akkor megadhatja, hogy egy második webes szerepkör a HTTP-hez a 8080-at, a HTTPS-hez pedig a 8043-at használja.
Az alábbi táblázat az elem attribútumait InputEndpoint ismerteti.
| Attribútum | Típus | Description |
|---|---|---|
| name | sztring | Kötelező. A külső végpont egyedi neve. |
| Protokoll | sztring | Kötelező. A külső végpont átviteli protokollja. Webes szerepkör esetén a lehetséges értékek a következők HTTP: , HTTPS, UDP, vagy TCP. |
| port | int | Kötelező. A külső végpont portja. Tetszőleges portszámot megadhat, de a szolgáltatásban az egyes szerepkörökhöz megadott portszámoknak egyedinek kell lenniük. A lehetséges értékek 1 és 65535 között mozognak, beleértve az (Azure SDK 1.7-es vagy újabb verzióját). |
| tanúsítvány | sztring | HTTPS-végponthoz szükséges. Egy elem által Certificate definiált tanúsítvány neve. |
| localPort | int | Választható. A végponton belüli belső kapcsolatokhoz használt portot adja meg. Az localPort attribútum leképli a végponton lévő külső portot egy szerepkör belső portjára. Ez olyan esetekben hasznos, amikor egy szerepkörnek a külsőleg közzétett porton lévő belső összetevővel kell kommunikálnia.Ha nincs megadva, az értéke localPort megegyezik az port attribútummal. Állítsa a "*" értékre localPort , hogy automatikusan hozzárendeljen egy nem áthelyezett portot, amely a futtatókörnyezeti API-val felderíthető.A lehetséges értékek 1 és 65535 között mozognak, beleértve az (Azure SDK 1.7-es vagy újabb verzióját). Az localPort attribútum csak az Azure SDK 1.3-os vagy újabb verziójával érhető el. |
| ignoreRoleInstanceStatus | boolean | Választható. Ha az attribútum értéke értékre truevan állítva, a rendszer figyelmen kívül hagyja egy szolgáltatás állapotát, és a terheléselosztó nem távolítja el a végpontot. Ha ezt az értéket hasznosra true állítja egy szolgáltatás foglalt példányainak hibakereséséhez. Az alapértelmezett érték false. Megjegyzés: A végpontok akkor is fogadhatják a forgalmat, ha a szerepkör nincs Kész állapotban. |
| loadBalancerProbe | sztring | Választható. A bemeneti végponthoz társított terheléselosztó-mintavétel neve. További információ: LoadBalancerProbe séma. |
InternalEndpoint
Az InternalEndpoint elem egy webes szerepkör belső végpontjának leírását írja le. A belső végpont csak a szolgáltatáson belül futó más szerepkörpéldányok számára érhető el; nem érhető el a szolgáltatáson kívüli ügyfelek számára. Az elemet nem tartalmazó Sites webes szerepkörök csak egyetlen HTTP-, UDP- vagy TCP-belső végpontot tartalmazhatnak.
Az alábbi táblázat az elem attribútumait InternalEndpoint ismerteti.
| Attribútum | Típus | Description |
|---|---|---|
| name | sztring | Kötelező. A belső végpont egyedi neve. |
| Protokoll | sztring | Kötelező. A belső végpont átviteli protokollja. Lehetséges értékek: HTTP, TCP, UDPvagy ANY.A érték ANY azt határozza meg, hogy bármely protokoll, port engedélyezett legyen. |
| port | int | Választható. A végponton a belső terheléselosztású kapcsolatokhoz használt port. A elosztott terhelésű végpontok két portot használnak. A nyilvános IP-címhez használt port és a magánhálózati IP-címhez használt port. Ezek általában azonosak, de különböző portokat is használhat. A lehetséges értékek 1 és 65535 között mozognak, beleértve az (Azure SDK 1.7-es vagy újabb verzióját). Az Port attribútum csak az Azure SDK 1.3-os vagy újabb verziójával érhető el. |
InstanceInputEndpoint
Az InstanceInputEndpoint elem egy webes szerepkörhöz való példánybemeneti végpontot ír le. Egy példány bemeneti végpontja egy adott szerepkörpéldányhoz van társítva a terheléselosztó porttovábbításával. Minden egyes példány bemeneti végpontja egy adott portra van leképezve egy lehetséges porttartományból. Ez az elem az elem szülője AllocatePublicPortFrom .
Az InstanceInputEndpoint elem csak az Azure SDK 1.7-es vagy újabb verziójával érhető el.
Az alábbi táblázat az elem attribútumait InstanceInputEndpoint ismerteti.
| Attribútum | Típus | Description |
|---|---|---|
| name | sztring | Kötelező. A végpont egyedi neve. |
| localPort | int | Kötelező. Megadja azt a belső portot, amelyre az összes szerepkörpéldány figyelni fog, hogy fogadhassa a terheléselosztótól továbbított bejövő forgalmat. A lehetséges értékek 1 és 65535 között mozognak, beleértve a értéket is. |
| Protokoll | sztring | Kötelező. A belső végpont átviteli protokollja. A lehetséges értékek: udp és tcp. Http/https-alapú forgalomhoz használható tcp . |
AllocatePublicPortFrom
Az AllocatePublicPortFrom elem azt a nyilvános porttartományt írja le, amelyet a külső ügyfelek az egyes példányok bemeneti végpontjaihoz való hozzáféréshez használhatnak. A nyilvános (VIP)-port száma ebből a tartományból van lefoglalva, és minden egyes szerepkörpéldány-végponthoz hozzá lesz rendelve a bérlő üzembe helyezése és frissítése során. Ez az elem az elem szülője FixedPortRange .
Az AllocatePublicPortFrom elem csak az Azure SDK 1.7-es vagy újabb verziójával érhető el.
Rögzítettport
Az FixedPort elem megadja a belső végpont portját, amely lehetővé teszi a végpont elosztott terhelésű kapcsolatait.
Az FixedPort elem csak az Azure SDK 1.3-s vagy újabb verziójával érhető el.
Az alábbi táblázat az elem attribútumait FixedPort ismerteti.
| Attribútum | Típus | Description |
|---|---|---|
| port | int | Kötelező. A belső végpont portja. Ez ugyanazzal a hatással jár, mint a min és a FixedPortRange max beállítása ugyanarra a portra.A lehetséges értékek 1 és 65535 között mozognak, beleértve az (Azure SDK 1.7-es vagy újabb verzióját). |
FixPortRange
Az FixedPortRange elem megadja a belső végponthoz vagy a példány bemeneti végpontjához rendelt porttartományt, és beállítja a végpont elosztott terhelésű kapcsolataihoz használt portot.
Megjegyzés
Az FixedPortRange elem attól függően működik, hogy melyik elemben található. Amikor az FixedPortRange elem szerepel az InternalEndpoint elemben, megnyitja a terheléselosztó összes portját azon virtuális gépek minimális és maximális attribútumainak tartományán belül, amelyeken a szerepkör fut. Ha az FixedPortRange elem az InstanceInputEndpoint elemben van, csak egy portot nyit meg a szerepkört futtató virtuális gépek minimális és maximális attribútumainak tartományán belül.
Az FixedPortRange elem csak az Azure SDK 1.3-s vagy újabb verziójával érhető el.
Az alábbi táblázat az elem attribútumait FixedPortRange ismerteti.
| Attribútum | Típus | Description |
|---|---|---|
| p | int | Kötelező. A tartomány minimális portja. A lehetséges értékek 1 és 65535 között mozognak, beleértve az (Azure SDK 1.7-es vagy újabb verzióját). |
| max. | sztring | Kötelező. A tartomány maximális portja. A lehetséges értékek 1 és 65535 között mozognak, beleértve az (Azure SDK 1.7-es vagy újabb verzióját). |
Tanúsítványok
Az Certificates elem egy webes szerepkör tanúsítványainak gyűjtését ismerteti. Ez az elem az elem szülője Certificate . A szerepkörökhöz tetszőleges számú társított tanúsítvány tartozhat. További információ a tanúsítványok elem használatáról: A szolgáltatásdefiníciós fájl módosítása tanúsítvánnyal.
Tanúsítvány
Az Certificate elem egy webes szerepkörhöz társított tanúsítványt ír le.
Az alábbi táblázat az elem attribútumait Certificate ismerteti.
| Attribútum | Típus | Description |
|---|---|---|
| name | sztring | Kötelező. A tanúsítvány neve, amely a HTTPS-elemhez InputEndpoint való társításkor hivatkozik rá. |
| storeLocation | sztring | Kötelező. Annak a tanúsítványtárolónak a helye, ahol ez a tanúsítvány megtalálható a helyi gépen. A lehetséges értékek a következők: CurrentUser és LocalMachine. |
| storeName | sztring | Kötelező. Annak a tanúsítványtárolónak a neve, ahol ez a tanúsítvány található a helyi gépen. A lehetséges értékek közé tartoznak a beépített tárolónevek My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, , AuthRootAddressBookvagy bármely egyéni tárolónév. Ha egyéni tárolónevet ad meg, a rendszer automatikusan létrehozza az áruházat. |
| permissionLevel | sztring | Választható. Megadja a szerepkörfolyamatoknak adott hozzáférési engedélyeket. Ha azt szeretné, hogy csak emelt szintű folyamatok férhessenek hozzá a titkos kulcshoz, adja meg elevated az engedélyt. limitedOrElevated engedély lehetővé teszi, hogy az összes szerepkörfolyamat hozzáférjen a titkos kulcshoz. A lehetséges értékek: limitedOrElevated és elevated. Az alapértelmezett érték limitedOrElevated. |
Behozatal
Az Imports elem egy olyan webes szerepkör importálási moduljainak gyűjteményét ismerteti, amelyek összetevőket adnak hozzá a vendég operációs rendszerhez. Ez az elem az elem szülője Import . Ez az elem nem kötelező, és egy szerepkörnek csak egy importálási blokkja lehet.
Az Imports elem csak az Azure SDK 1.3-s vagy újabb verziójával érhető el.
Importálás
Az Import elem megadja a vendég operációs rendszerhez hozzáadandó modult.
Az Import elem csak az Azure SDK 1.3-s vagy újabb verziójával érhető el.
Az alábbi táblázat az elem attribútumait Import ismerteti.
| Attribútum | Típus | Description |
|---|---|---|
| moduleName | sztring | Kötelező. Az importálandó modul neve. Az érvényes importálási modulok a következők: -Remoteaccess - RemoteForwarder -Diagnosztika A RemoteAccess és a RemoteForwarder modul lehetővé teszi a szerepkörpéldány távoli asztali kapcsolatokhoz való konfigurálását. További információ: Távoli asztali kapcsolat engedélyezése. A Diagnosztika modul lehetővé teszi egy szerepkörpéldány diagnosztikai adatainak gyűjtését. |
Futtatókörnyezet
Az Runtime elem egy olyan webes szerepkör környezeti változóbeállításainak gyűjteményét írja le, amelyek az Azure-gazdafolyamat futtatókörnyezetét szabályozzák. Ez az elem az elem szülője Environment . Ez az elem nem kötelező, és egy szerepkörnek csak egy futtatókörnyezeti blokkja lehet.
Az Runtime elem csak az Azure SDK 1.3-s vagy újabb verziójával érhető el.
Az alábbi táblázat az elem attribútumait Runtime ismerteti:
| Attribútum | Típus | Description |
|---|---|---|
| executionContext | sztring | Választható. Meghatározza azt a környezetet, amelyben a szerepkör-folyamat elindul. Az alapértelmezett környezet a következő: limited.- limited – A folyamat rendszergazdai jogosultságok nélkül indul el.- elevated – A folyamat rendszergazdai jogosultságokkal indul el. |
Környezet
Az Environment elem egy webes szerepkör környezeti változóbeállításainak gyűjteményét írja le. Ez az elem az elem szülője Variable . A szerepkörök tetszőleges számú környezeti változóval rendelkezhetnek.
Változó
Az Variable elem egy környezeti változót határoz meg, amely a vendég operációs rendszerében állítható be.
Az Variable elem csak az Azure SDK 1.3-s vagy újabb verziójával érhető el.
Az alábbi táblázat az elem attribútumait Variable ismerteti:
| Attribútum | Típus | Description |
|---|---|---|
| name | sztring | Kötelező. A beállítandó környezeti változó neve. |
| érték | sztring | Választható. A környezeti változóhoz beállítandó érték. Értékattribútumot vagy RoleInstanceValue elemet kell tartalmaznia. |
RoleInstanceValue
Az RoleInstanceValue elem határozza meg azt az xPath-t, amelyből lekéri a változó értékét.
Az alábbi táblázat az elem attribútumait RoleInstanceValue ismerteti.
| Attribútum | Típus | Description |
|---|---|---|
| Xpath | sztring | Választható. A példány üzembehelyezési beállításainak elérési útja. További információ: Konfigurációs változók az XPath használatával. Értékattribútumot vagy RoleInstanceValue elemet kell tartalmaznia. |
EntryPoint
Az EntryPoint elem egy szerepkör belépési pontját adja meg. Ez az elem az elemek szülője NetFxEntryPoint . Ezek az elemek lehetővé teszik, hogy az alapértelmezett WaWorkerHost.exe helyett egy olyan alkalmazást adjon meg, amely szerepkör-belépési pontként szolgál.
Az EntryPoint elem csak az Azure SDK 1.5-ös vagy újabb verziójával érhető el.
NetFxEntryPoint
Az NetFxEntryPoint elem határozza meg a szerepkörhöz futtatandó programot.
Megjegyzés
Az NetFxEntryPoint elem csak az Azure SDK 1.5-ös vagy újabb verziójával érhető el.
Az alábbi táblázat az elem attribútumait NetFxEntryPoint ismerteti.
| Attribútum | Típus | Description |
|---|---|---|
| assemblyName | sztring | Kötelező. A belépési pontot tartalmazó szerelvény elérési útja és fájlneve. Az elérési út a (z) \%ROLEROOT%\Approot mappához van viszonyítva (ne adja meg a \%ROLEROOT%\Approot értéket a mappában commandLine, mert feltételezzük). A %ROLEROOT% az Azure által karbantartott környezeti változó, amely a szerepkör gyökérmappájának helyét jelöli. A \%ROLEROOT%\Approot mappa a szerepkör alkalmazásmappáját jelöli.HWC-szerepkörök esetén az elérési út mindig a \%ROLEROOT%\Approot\bin mappához van viszonyítva. Teljes IIS- és IIS Express webes szerepkörök esetén, ha a szerelvény nem található a(z) \%ROLEROOT%\Approot mappához viszonyítva, a rendszer a \%ROLEROOT%\Approot\bin mappában keres. Ez a visszaeső viselkedés a teljes IIS esetében nem ajánlott eljárás, és a jövőbeli verziókban esetleg eltávolítható. |
| targetFrameworkVersion | sztring | Kötelező. Annak a .NET-keretrendszernek a verziója, amelyre a szerelvény készült. Például: targetFrameworkVersion="v4.0". |
Webhelyek
Az Sites elem egy webes szerepkörben üzemeltetett webhelyek és webalkalmazások gyűjteményét ismerteti. Ez az elem az elem szülője Site . Ha nem ad meg Sites elemet, a webes szerepkör örökölt webes szerepkörként lesz üzemeltetve, és csak egy webhely üzemeltethető a webes szerepkörben. Ez az elem nem kötelező, és egy szerepkörnek csak egy webhelyblokkja lehet.
Az Sites elem csak az Azure SDK 1.3-os vagy újabb verziójával érhető el.
Hely
Az Site elem a webes szerepkör részét képező webhelyet vagy webalkalmazást adja meg.
Az Site elem csak az Azure SDK 1.3-os vagy újabb verziójával érhető el.
Az alábbi táblázat az elem attribútumait Site ismerteti.
| Attribútum | Típus | Description |
|---|---|---|
| name | sztring | Kötelező. A webhely vagy alkalmazás neve. |
| physicalDirectory | sztring | A webhelygyökér tartalomkönyvtárának helye. A hely megadható abszolút elérési útként vagy a .csdef helyhez viszonyítva. |
VirtualApplication
Az VirtualApplication elem definiál egy alkalmazást az Internet Information Services (IIS) 7-ben, amely olyan fájlok csoportosítása, amelyek tartalmat szolgáltatnak, vagy protokollokon keresztül nyújtanak szolgáltatásokat, például HTTP-t. Amikor létrehoz egy alkalmazást az IIS 7-ben, az alkalmazás elérési útja a webhely URL-címének részévé válik.
Az VirtualApplication elem csak az Azure SDK 1.3-os vagy újabb verziójával érhető el.
Az alábbi táblázat az elem attribútumait VirtualApplication ismerteti.
| Attribútum | Típus | Description |
|---|---|---|
| name | sztring | Kötelező. A virtuális alkalmazás azonosítására szolgáló nevet ad meg. |
| physicalDirectory | sztring | Kötelező. Megadja a virtuális alkalmazást tartalmazó fejlesztőgép elérési útját. A számítási emulátorban az IIS úgy van konfigurálva, hogy erről a helyről lekérje a tartalmat. Az Azure-ban való üzembe helyezéskor a fizikai könyvtár tartalma a szolgáltatás többi részével együtt lesz csomagolva. Amikor a szolgáltatáscsomagot üzembe helyezi az Azure-ban, az IIS a kicsomagolt tartalom helyével van konfigurálva. |
VirtualDirectory
Az VirtualDirectory elem megadja az IIS-ben megadott könyvtárnevet (más néven elérési utat), és leképezi egy helyi vagy távoli kiszolgálón lévő fizikai könyvtárra.
Az VirtualDirectory elem csak az Azure SDK 1.3-os vagy újabb verziójával érhető el.
Az alábbi táblázat az elem attribútumait VirtualDirectory ismerteti.
| Attribútum | Típus | Description |
|---|---|---|
| name | sztring | Kötelező. A virtuális könyvtár azonosítására szolgáló nevet ad meg. |
| érték | physicalDirectory | Kötelező. Megadja a webhelyet vagy a virtuális könyvtár tartalmát tartalmazó fejlesztési gép elérési útját. A számítási emulátorban az IIS úgy van konfigurálva, hogy erről a helyről lekérje a tartalmat. Az Azure-ban való üzembe helyezéskor a fizikai könyvtár tartalma a szolgáltatás többi részével együtt lesz csomagolva. Amikor a szolgáltatáscsomagot üzembe helyezi az Azure-ban, az IIS a kicsomagolt tartalom helyével van konfigurálva. |
Kötések
Az Bindings elem egy webhely kötéseinek gyűjteményét írja le. Ez az elem szülőeleme Binding . Az elem minden Site elemhez szükséges. A végpontok konfigurálásával kapcsolatos további információkért lásd: Kommunikáció engedélyezése szerepkörpéldányokhoz.
Az Bindings elem csak az Azure SDK 1.3-os vagy újabb verziójával érhető el.
Kötés
Az Binding elem megadja a webhelyekkel vagy webalkalmazásokkal való kommunikációhoz szükséges konfigurációs információkat.
Az Binding elem csak az Azure SDK 1.3-os vagy újabb verziójával érhető el.
| Attribútum | Típus | Description |
|---|---|---|
| name | sztring | Kötelező. A kötés azonosítására szolgáló nevet ad meg. |
| endpointName | sztring | Kötelező. Megadja a végpont nevét, amelyhez kötést szeretne kötni. |
| hostHeader | sztring | Választható. Olyan gazdagépnevet ad meg, amely lehetővé teszi több, különböző gazdagépnevekkel rendelkező webhely egyetlen IP-cím/portszám kombináción történő üzemeltetését. |
Indítás
Az Startup elem a szerepkör indításakor futtatott feladatok gyűjteményét ismerteti. Ez az elem lehet az Variable elem szülője. A szerepkör indítási feladatainak használatáról további információt az Indítási feladatok konfigurálása című témakörben talál. Ez az elem nem kötelező, és egy szerepkörnek csak egy indítási blokkja lehet.
Az alábbi táblázat az elem attribútumát Startup ismerteti.
| Attribútum | Típus | Description |
|---|---|---|
| Prioritás | int | Csak belső használatra. |
Feladat
Az Task elem megadja a szerepkör indításakor lezajlott indítási feladatot. Az indítási feladatok olyan feladatok végrehajtására használhatók, amelyek előkészítik a szerepkört az ilyen szoftverösszetevők futtatására vagy más alkalmazások futtatására. A feladatok abban a sorrendben futnak, amelyben megjelennek az Startup elemblokkban.
Az Task elem csak az Azure SDK 1.3-os vagy újabb verziójával érhető el.
Az alábbi táblázat az elem attribútumait Task ismerteti.
| Attribútum | Típus | Description |
|---|---|---|
| Commandline | sztring | Kötelező. Egy szkript, például egy CMD-fájl, amely a futtatandó parancsokat tartalmazza. Az indítási parancsokat és a kötegelt fájlokat ANSI formátumban kell menteni. Azok a fájlformátumok, amelyek a fájl elején bájtsorrend-jelölőt állítottak be, nem fognak megfelelően működni. |
| executionContext | sztring | Meghatározza azt a környezetet, amelyben a szkript fut. - limited [Alapértelmezett] – A futtatás ugyanazokkal a jogosultságokkal történik, mint a folyamatot üzemeltető szerepkör.- elevated – Futtatás rendszergazdai jogosultságokkal. |
| taskType | sztring | A parancs végrehajtási viselkedését határozza meg. - simple [Alapértelmezett] – A rendszer megvárja, amíg a tevékenység kilép a többi tevékenység elindítása előtt.- background – A rendszer nem várja meg, hogy a feladat kilépjen.- foreground – A háttérhez hasonlóan a szerepkör nem indul újra, amíg az összes előtér-feladat ki nem lép. |
Tartalom
Az Contents elem egy webes szerepkör tartalomgyűjteményét írja le. Ez az elem az elem szülője Content .
Az Contents elem csak az Azure SDK 1.5-ös vagy újabb verziójával érhető el.
Tartalom
Az Content elem határozza meg a másolandó tartalom forráshelyét az Azure-beli virtuális gépre, valamint azt a célelérési útvonalat, amelyre a másolás történik.
Az Content elem csak az Azure SDK 1.5-ös vagy újabb verziójával érhető el.
Az alábbi táblázat az elem attribútumait Content ismerteti.
| Attribútum | Típus | Description |
|---|---|---|
| destination | sztring | Kötelező. Annak az Azure-beli virtuális gépnek a helye, amelyre a tartalmat elhelyezték. Ez a hely a %ROLEROOT%\Approot mappához viszonyítva található. |
Ez az elem az elem szülőeleme SourceDirectory .
SourceDirectory
Az SourceDirectory elem határozza meg azt a helyi könyvtárat, amelyből a tartalom másolása történik. Ezzel az elemet használva megadhatja az Azure-beli virtuális gépre másolandó helyi tartalmakat.
Az SourceDirectory elem csak az Azure SDK 1.5-ös vagy újabb verziójával érhető el.
Az alábbi táblázat az elem attribútumait SourceDirectory ismerteti.
| Attribútum | Típus | Description |
|---|---|---|
| path | sztring | Kötelező. Egy olyan helyi könyvtár relatív vagy abszolút elérési útja, amelynek tartalma az Azure-beli virtuális gépre lesz másolva. A környezeti változók könyvtárelérési útvonalon való bővítése támogatott. |