WebRole-schema för Azure Cloud Services-definition (utökad support)

Artikel
07/25/2024

Azure-webbrollen är en roll som är anpassad för programmering av webbprogram som stöds av IIS 7, till exempel ASP.NET, PHP, Windows Communication Foundation och FastCGI.

Standardtillägget för tjänstdefinitionsfilen är csdef.

Grundläggande tjänstdefinitionsschema för en webbroll

Det grundläggande formatet för en tjänstdefinitionsfil som innehåller en webbroll är följande.

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

Schemaelement

Tjänstdefinitionsfilen innehåller dessa element, som beskrivs i detalj i efterföljande avsnitt i den här artikeln:

WebRole

ConfigurationSettings

InstanceInputEndpoint

AllokeraPublicPortFrom

WebRole

Elementet WebRole beskriver en roll som är anpassad för programmering av webbprogram, som stöds av IIS 7 och ASP.NET. En tjänst kan innehålla noll eller fler webbroller.

I följande tabell beskrivs elementets WebRole attribut.

Attribut	Typ	Beskrivning
name	sträng	Obligatoriskt. Namnet på webbrollen. Rollens namn måste vara unikt.
enableNativeCodeExecution	boolean	Valfritt. Standardvärdet är `true`; intern kodkörning och fullständigt förtroende är aktiverat som standard. Ange det här attributet till `false` för att inaktivera intern kodkörning för webbrollen och använd delvis förtroende för Azure i stället.
vmsize	sträng	Valfritt. Ange det här värdet om du vill ändra storleken på den virtuella dator som tilldelas rollen. Standardvärdet är `Small`. Mer information finns i Storlekar på virtuella datorer för Cloud Services.

ConfigurationSettings

Elementet ConfigurationSettings beskriver samlingen med konfigurationsinställningar för en webbroll. Det här elementet är överordnat för elementet Setting .

Inställning

Elementet Setting beskriver ett namn- och värdepar som anger en konfigurationsinställning för en instans av en roll.

I följande tabell beskrivs elementets Setting attribut.

Attribut	Typ	Beskrivning
name	sträng	Obligatoriskt. Ett unikt namn för konfigurationsinställningen.

Konfigurationsinställningarna för en roll är namn- och värdepar som deklareras i tjänstdefinitionsfilen och anges i tjänstkonfigurationsfilen.

LocalResources

Elementet LocalResources beskriver samlingen med lokala lagringsresurser för en webbroll. Det här elementet är överordnat för elementet LocalStorage .

LocalStorage

Elementet LocalStorage identifierar en lokal lagringsresurs som tillhandahåller filsystemutrymme för tjänsten vid körning. En roll kan definiera noll eller fler lokala lagringsresurser.

Kommentar

Elementet LocalStorage kan visas som underordnat elementet WebRole för att stödja kompatibilitet med tidigare versioner av Azure SDK.

I följande tabell beskrivs elementets LocalStorage attribut.

Attribut	Typ	Beskrivning
name	sträng	Obligatoriskt. Ett unikt namn för det lokala arkivet.
cleanOnRoleRecycle	boolean	Valfritt. Anger om det lokala arkivet ska rensas när rollen startas om. Standardvärdet är `true`.
sizeInMb	heltal	Valfritt. Önskad mängd lagringsutrymme som ska allokeras för det lokala arkivet i MB. Om inget anges är det allokerade standardutrymmet 100 MB. Den minsta mängden lagringsutrymme som kan allokeras är 1 MB. Den maximala storleken på de lokala resurserna beror på storleken på den virtuella datorn. Mer information finns i Storlekar på virtuella datorer för Cloud Services.

Namnet på den katalog som allokerats till den lokala lagringsresursen motsvarar det värde som anges för namnattributet.

Slutpunkter

Elementet Endpoints beskriver samlingen med indata (externa), interna och instansindataslutpunkter för en roll. Det här elementet är överordnat till elementen InputEndpoint, InternalEndpointoch InstanceInputEndpoint .

Indata och interna slutpunkter allokeras separat. En tjänst kan ha totalt 25 indataslutpunkter, interna och instansindataslutpunkter, som kan allokeras mellan de 25 roller som tillåts i en tjänst. Om du till exempel har fem roller kan du allokera fem indataslutpunkter per roll, eller så kan du allokera 25 indataslutpunkter till en enda roll eller så kan du allokera en indataslutpunkt vardera till 25 roller.

Kommentar

Varje roll som distribueras kräver en instans per roll. Standardetablering för en prenumeration är begränsad till 20 kärnor och är därför begränsad till 20 instanser av en roll. Om ditt program kräver fler instanser än vad som tillhandahålls av standardetablering kan du läsa Fakturering, Prenumerationshantering och Kvotsupport för mer information om hur du ökar din kvot.

InputEndpoint

Elementet InputEndpoint beskriver en extern slutpunkt för en webbroll.

Du kan definiera flera slutpunkter som är en kombination av HTTP-, HTTPS-, UDP- och TCP-slutpunkter. Du kan ange valfritt portnummer som du väljer för en indataslutpunkt, men portnumren som anges för varje roll i tjänsten måste vara unika. Om du till exempel anger att en webbroll använder port 80 för HTTP och port 443 för HTTPS kan du ange att en andra webbroll använder port 8080 för HTTP och port 8043 för HTTPS.

I följande tabell beskrivs elementets InputEndpoint attribut.

Attribut	Typ	Beskrivning
name	sträng	Obligatoriskt. Ett unikt namn för den externa slutpunkten.
protokoll	sträng	Obligatoriskt. Transportprotokollet för den externa slutpunkten. För en webbroll är `HTTP`möjliga värden , `HTTPS`, `UDP`eller `TCP`.
port	heltal	Obligatoriskt. Porten för den externa slutpunkten. Du kan ange valfritt portnummer som du väljer, men portnumren som anges för varje roll i tjänsten måste vara unika. Möjliga värden mellan 1 och 65535, inklusive (Azure SDK version 1.7 eller senare).
certifikat	sträng	Krävs för en HTTPS-slutpunkt. Namnet på ett certifikat som definierats av ett `Certificate` element.
localPort	heltal	Valfritt. Anger en port som används för interna anslutningar på slutpunkten. Attributet `localPort` mappar den externa porten på slutpunkten till en intern port för en roll. Det här attributet är användbart i scenarier där en roll måste kommunicera med en intern komponent på en port som skiljer sig från den som exponeras externt. Om det inte anges är värdet `localPort` för samma som attributet `port` . Ange värdet för till "*" för att automatiskt tilldela en oallokerad port som kan identifieras med hjälp av `localPort` körnings-API:et. Möjliga värden mellan 1 och 65535, inklusive (Azure SDK version 1.7 eller senare). Attributet `localPort` är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.
ignoreRoleInstanceStatus	boolean	Valfritt. När värdet för det här attributet är inställt på `true`ignoreras statusen för en tjänst och lastbalanseraren tar inte bort slutpunkten. Ange det här värdet till `true` användbart för felsökning av upptagna instanser av en tjänst. Standardvärdet är `false`. Obs! En slutpunkt kan fortfarande ta emot trafik även om rollen inte är i tillståndet Redo.
loadBalancerProbe	sträng	Valfritt. Namnet på lastbalanserarens avsökning som är associerad med indataslutpunkten. Mer information finns i LoadBalancerProbe Schema.

InternalEndpoint

Elementet InternalEndpoint beskriver en intern slutpunkt för en webbroll. En intern slutpunkt är endast tillgänglig för andra rollinstanser som körs i tjänsten. Det är inte tillgängligt för klienter utanför tjänsten. Webbroller som inte innehåller elementet Sites kan bara ha en enda intern HTTP-, UDP- eller TCP-slutpunkt.

I följande tabell beskrivs elementets InternalEndpoint attribut.

Attribut	Typ	Beskrivning
name	sträng	Obligatoriskt. Ett unikt namn för den interna slutpunkten.
protokoll	sträng	Obligatoriskt. Transportprotokollet för den interna slutpunkten. Möjliga värden är `HTTP`, `TCP`, `UDP`eller `ANY`. Värdet `ANY` anger att alla protokoll, alla portar tillåts.
port	heltal	Valfritt. Porten som används för interna belastningsutjämningsanslutningar på slutpunkten. En belastningsutjämningsslutpunkt använder två portar. Porten som används för den offentliga IP-adressen och porten som används på den privata IP-adressen. Normalt är dessa värden inställda på samma, men du kan välja att använda olika portar. Möjliga värden mellan 1 och 65535, inklusive (Azure SDK version 1.7 eller senare). Attributet `Port` är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

InstanceInputEndpoint

Elementet InstanceInputEndpoint beskriver en instansindataslutpunkt till en webbroll. En instansindataslutpunkt är associerad med en specifik rollinstans med hjälp av portvidarebefordring i lastbalanseraren. Varje instansindataslutpunkt mappas till en specifik port från ett antal möjliga portar. Det här elementet är överordnat för elementet AllocatePublicPortFrom .

Elementet InstanceInputEndpoint är endast tillgängligt med hjälp av Azure SDK version 1.7 eller senare.

I följande tabell beskrivs elementets InstanceInputEndpoint attribut.

Attribut	Typ	Beskrivning
name	sträng	Obligatoriskt. Ett unikt namn för slutpunkten.
localPort	heltal	Obligatoriskt. Anger den interna port som alla rollinstanser lyssnar på för att ta emot inkommande trafik som vidarebefordras från lastbalanseraren. Möjliga värden mellan 1 och 65535, inklusive.
protokoll	sträng	Obligatoriskt. Transportprotokollet för den interna slutpunkten. Möjliga värden är `udp` eller `tcp`. Används `tcp` för http/https-baserad trafik.

AllokeraPublicPortFrom

Elementet AllocatePublicPortFrom beskriver det offentliga portintervall som externa kunder kan använda för att komma åt varje instansindataslutpunkt. Det offentliga portnumret (VIP) allokeras från det här intervallet och tilldelas till varje enskild rollinstansslutpunkt under klientdistributionen och uppdateringen. Det här elementet är överordnat för elementet FixedPortRange .

Elementet AllocatePublicPortFrom är endast tillgängligt med hjälp av Azure SDK version 1.7 eller senare.

FixedPort

Elementet FixedPort anger porten för den interna slutpunkten, som aktiverar belastningsutjämningsanslutningar på slutpunkten.

Elementet FixedPort är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

I följande tabell beskrivs elementets FixedPort attribut.

Attribut	Typ	Beskrivning
port	heltal	Obligatoriskt. Porten för den interna slutpunkten. Det här attributet har samma effekt som att ange `FixedPortRange` min och max till samma port. Möjliga värden mellan 1 och 65535, inklusive (Azure SDK version 1.7 eller senare).

FixedPortRange

Elementet FixedPortRange anger intervallet för portar som är tilldelade till den interna slutpunkten eller instansens indataslutpunkt och anger den port som används för belastningsutjämningsanslutningar på slutpunkten.

Kommentar

Elementet FixedPortRange fungerar annorlunda beroende på vilket element det finns i. När elementet FixedPortRange finns i elementet InternalEndpoint öppnas alla portar i lastbalanseraren inom intervallet för attributen min och max för alla virtuella datorer som rollen körs på. När elementet FixedPortRange finns i -elementet InstanceInputEndpoint öppnas bara en port inom intervallet för attributen min och max på varje virtuell dator som kör rollen.

Elementet FixedPortRange är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

I följande tabell beskrivs elementets FixedPortRange attribut.

Attribut	Typ	Beskrivning
min	heltal	Obligatoriskt. Minsta port i intervallet. Möjliga värden mellan 1 och 65535, inklusive (Azure SDK version 1.7 eller senare).
max	sträng	Obligatoriskt. Maximal port i intervallet. Möjliga värden mellan 1 och 65535, inklusive (Azure SDK version 1.7 eller senare).

Certifikat

Elementet Certificates beskriver samlingen av certifikat för en webbroll. Det här elementet är överordnat för elementet Certificate . En roll kan ha valfritt antal associerade certifikat. Mer information om hur du använder certifikatelementet finns i Ändra tjänstdefinitionsfilen med ett certifikat.

Certifikat

Elementet Certificate beskriver ett certifikat som är associerat med en webbroll.

I följande tabell beskrivs elementets Certificate attribut.

Attribut	Typ	Beskrivning
name	sträng	Obligatoriskt. Ett namn på det här certifikatet, som används för att referera till det när det är associerat med ett HTTPS-element `InputEndpoint` .
storeLocation	sträng	Obligatoriskt. Platsen för certifikatarkivet där det här certifikatet kan hittas på den lokala datorn. Möjliga värden är `CurrentUser` och `LocalMachine`.
storeName	sträng	Obligatoriskt. Namnet på certifikatarkivet där det här certifikatet finns på den lokala datorn. Möjliga värden inkluderar de inbyggda butiksnamnen `My`, `Root`, `CA`, `Trust`, `Disallowed`, `TrustedPeople`, `TrustedPublisher`, , `AuthRoot`, `AddressBook`eller alla anpassade butiksnamn. Om ett anpassat butiksnamn anges skapas arkivet automatiskt.
permissionLevel	sträng	Valfritt. Anger de åtkomstbehörigheter som ges till rollprocesserna. Om du bara vill att förhöjda processer ska kunna komma åt den privata nyckeln anger du `elevated` behörighet. `limitedOrElevated` behörighet tillåter att alla rollprocesser får åtkomst till den privata nyckeln. Möjliga värden är `limitedOrElevated` eller `elevated`. Standardvärdet är `limitedOrElevated`.

Importer

Elementet Imports beskriver en samling importmoduler för en webbroll som lägger till komponenter i gästoperativsystemet. Det här elementet är överordnat för elementet Import . Det här elementet är valfritt och en roll kan bara ha ett importblock.

Elementet Imports är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

Importera

Elementet Import anger en modul som ska läggas till i gästoperativsystemet.

Elementet Import är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

I följande tabell beskrivs elementets Import attribut.

Attribut	Typ	Beskrivning
moduleName	sträng	Obligatoriskt. Namnet på modulen som ska importeras. Giltiga importmoduler är: – RemoteAccess – RemoteForwarder -Diagnostik Med modulerna RemoteAccess och RemoteForwarder kan du konfigurera rollinstansen för fjärrskrivbordsanslutningar. Mer information finns i Tillägg. Med modulen Diagnostik kan du samla in diagnostikdata för en rollinstans.

Körmiljö

Elementet Runtime beskriver en samling miljövariabelinställningar för en webbroll som styr körningsmiljön för Azure-värdprocessen. Det här elementet är överordnat för elementet Environment . Det här elementet är valfritt och en roll kan bara ha ett körningsblock.

Elementet Runtime är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

I följande tabell beskrivs elementets Runtime attribut:

Attribut	Typ	Beskrivning
executionContext	sträng	Valfritt. Anger i vilken kontext rollprocessen startas. Standardkontexten är `limited`. - `limited` – Processen startas utan administratörsbehörighet. - `elevated` – Processen startas med administratörsbehörighet.

Environment

Elementet Environment beskriver en samling miljövariabelinställningar för en webbroll. Det här elementet är överordnat för elementet Variable . En roll kan ha valfritt antal miljövariabler angivna.

Olika

Elementet Variable anger en miljövariabel som ska anges i gästdriften.

Elementet Variable är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

I följande tabell beskrivs elementets Variable attribut:

Attribut	Typ	Beskrivning
name	sträng	Obligatoriskt. Namnet på miljövariabeln som ska anges.
värde	sträng	Valfritt. Värdet som ska anges för miljövariabeln. Du måste inkludera antingen ett värdeattribut eller ett `RoleInstanceValue` element.

RoleInstanceValue

Elementet RoleInstanceValue anger den xPath som variabelns värde ska hämtas från.

I följande tabell beskrivs elementets RoleInstanceValue attribut.

Attribut	Typ	Beskrivning
xpath	sträng	Valfritt. Platssökväg för distributionsinställningar för instansen. Mer information finns i Konfigurationsvariabler med XPath. Du måste inkludera antingen ett värdeattribut eller ett `RoleInstanceValue` element.

EntryPoint

Elementet EntryPoint anger startpunkten för en roll. Det här elementet är överordnat för elementen NetFxEntryPoint . Med de här elementen kan du ange ett annat program än standard WaWorkerHost.exe att fungera som startpunkt för rollen.

Elementet EntryPoint är endast tillgängligt med hjälp av Azure SDK version 1.5 eller senare.

NetFxEntryPoint

Elementet NetFxEntryPoint anger vilket program som ska köras för en roll.

Kommentar

Elementet NetFxEntryPoint är endast tillgängligt med hjälp av Azure SDK version 1.5 eller senare.

I följande tabell beskrivs elementets NetFxEntryPoint attribut.

Attribut	Typ	Beskrivning
assemblyName	sträng	Obligatoriskt. Sökvägen och filnamnet för sammansättningen som innehåller startpunkten. Sökvägen är relativ till mappen \%ROLEROOT%\Approot (ange inte \%ROLEROOT%\Approot på kommandoraden. Den antas). %ROLEROOT% är en miljövariabel som underhålls av Azure och representerar rotmappens plats för din roll. Mappen \%ROLEROOT%\Approot representerar programmappen för din roll. För HWC-roller är sökvägen alltid relativ till mappen \%ROLEROOT%\Approot\bin . Om sammansättningen inte kan hittas i förhållande till mappen \%ROLEROOT%\Approot för fullständiga IIS- och IIS Express-webbroller genomsöks mappen \%ROLEROOT%\Approot\bin. Det här tillbakafallsbeteendet för fullständig IIS är inte en rekommenderad metod och kanske tas bort i framtida versioner.
targetFrameworkVersion	sträng	Obligatoriskt. Versionen av .NET-ramverket som sammansättningen skapades på. Exempel: `targetFrameworkVersion="v4.0"`

Webbplatser

Elementet Sites beskriver en samling webbplatser och webbprogram som finns i en webbroll. Det här elementet är överordnat för elementet Site . Om du inte anger ett Sites element hanteras webbrollen som en äldre webbroll och du kan bara ha en webbplats i webbrollen. Det här elementet är valfritt och en roll kan bara ha ett platsblock.

Elementet Sites är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

Webbplats

Elementet Site anger en webbplats eller ett webbprogram som ingår i webbrollen.

Elementet Site är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

I följande tabell beskrivs elementets Site attribut.

Attribut	Typ	Beskrivning
name	sträng	Obligatoriskt. Namnet på webbplatsen eller programmet.
physicalDirectory	sträng	Platsen för innehållskatalogen för platsroten. Platsen kan anges som en absolut sökväg eller i förhållande till csdef-platsen.

VirtualApplication

Elementet VirtualApplication definierar ett program i Internet Information Services (IIS) 7 är en gruppering av filer som levererar innehåll eller tillhandahåller tjänster via protokoll, till exempel HTTP. När du skapar ett program i IIS 7 blir programmets sökväg en del av webbplatsens URL.

Elementet VirtualApplication är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

I följande tabell beskrivs elementets VirtualApplication attribut.

Attribut	Typ	Beskrivning
name	sträng	Obligatoriskt. Anger ett namn för att identifiera det virtuella programmet.
physicalDirectory	sträng	Obligatoriskt. Anger sökvägen på utvecklingsdatorn som innehåller det virtuella programmet. I beräkningsemulatorn är IIS konfigurerat för att hämta innehåll från den här platsen. När det distribueras till Azure paketeras innehållet i den fysiska katalogen tillsammans med resten av tjänsten. När tjänstpaketet distribueras till Azure konfigureras IIS med platsen för det uppackade innehållet.

VirtualDirectory

Elementet VirtualDirectory anger ett katalognamn (kallas även sökväg) som du anger i IIS och mappar till en fysisk katalog på en lokal eller fjärransluten server.

Elementet VirtualDirectory är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

I följande tabell beskrivs elementets VirtualDirectory attribut.

Attribut	Typ	Beskrivning
name	sträng	Obligatoriskt. Anger ett namn för att identifiera den virtuella katalogen.
värde	physicalDirectory	Obligatoriskt. Anger sökvägen på utvecklingsdatorn som innehåller webbplatsen eller innehållet i den virtuella katalogen. I beräkningsemulatorn är IIS konfigurerat för att hämta innehåll från den här platsen. När det distribueras till Azure paketeras innehållet i den fysiska katalogen tillsammans med resten av tjänsten. När tjänstpaketet distribueras till Azure konfigureras IIS med platsen för det uppackade innehållet.

Bindningar

Elementet Bindings beskriver en samling bindningar för en webbplats. Det är elementets överordnade element Binding . Elementet krävs för varje Site element. Mer information om hur du konfigurerar slutpunkter finns i Aktivera kommunikation för rollinstanser.

Elementet Bindings är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

Bindning

Elementet Binding anger konfigurationsinformation som krävs för begäranden om att kommunicera med en webbplats eller ett webbprogram.

Elementet Binding är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

Attribut	Typ	Beskrivning
name	sträng	Obligatoriskt. Anger ett namn för att identifiera bindningen.
endpointName	sträng	Obligatoriskt. Anger det slutpunktsnamn som ska bindas till.
hostHeader	sträng	Valfritt. Anger ett värdnamn som gör att du kan vara värd för flera platser, med olika värdnamn, på en enda KOMBINATION av IP-adress/portnummer.

Start

Elementet Startup beskriver en samling uppgifter som körs när rollen startas. Det här elementet kan vara det överordnade elementet Variable . Mer information om hur du använder rollstartuppgifter finns i Konfigurera startuppgifter. Det här elementet är valfritt och en roll kan bara ha ett startblock.

I följande tabell beskrivs elementets Startup attribut.

Attribut	Typ	Beskrivning
prioritet	heltal	Enbart för internt bruk.

Uppgift

Elementet Task anger startaktiviteten som äger rum när rollen startar. Startuppgifter kan användas för att utföra uppgifter som förbereder rollen för att köra sådana installera programvarukomponenter eller köra andra program. Aktiviteter körs i den ordning de visas i elementblocket Startup .

Elementet Task är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

I följande tabell beskrivs elementets Task attribut.

Attribut	Typ	Beskrivning
commandLine	sträng	Obligatoriskt. Ett skript, till exempel en CMD-fil, som innehåller de kommandon som ska köras. Startkommandot och batchfilerna måste sparas i ANSI-format. Filformat som anger en byteordningsmarkör i början av filprocesserna felaktigt.
executionContext	sträng	Anger i vilken kontext skriptet körs. - `limited` [Standard] – Kör med samma behörigheter som rollen som värd för processen. - `elevated` – Kör med administratörsbehörighet.
taskType	sträng	Anger körningsbeteendet för kommandot. - `simple` [Standard] – Systemet väntar på att aktiviteten ska avslutas innan andra aktiviteter startas. - `background` – Systemet väntar inte på att uppgiften ska avslutas. - `foreground` – Liknar bakgrunden, förutom att rollen inte startas om förrän alla förgrundsuppgifter avslutas.

Innehåll

Elementet Contents beskriver samlingen med innehåll för en webbroll. Det här elementet är överordnat för elementet Content .

Elementet Contents är endast tillgängligt med hjälp av Azure SDK version 1.5 eller senare.

Innehåll

Elementet Content definierar källplatsen för innehåll som ska kopieras till den virtuella Azure-datorn och målsökvägen som den kopierar till.

Elementet Content är endast tillgängligt med hjälp av Azure SDK version 1.5 eller senare.

I följande tabell beskrivs elementets Content attribut.

Attribut	Typ	Beskrivning
destination	sträng	Obligatoriskt. Plats på den virtuella Azure-dator som innehållet placeras till. Den här platsen är relativ till mappen %ROLEROOT%\Approot.

Det här elementet är elementets SourceDirectory överordnade element.

SourceDirectory

Elementet SourceDirectory definierar den lokala katalog som innehållet kopieras från. Använd det här elementet för att ange det lokala innehållet som ska kopieras till den virtuella Azure-datorn.

Elementet SourceDirectory är endast tillgängligt med hjälp av Azure SDK version 1.5 eller senare.

I följande tabell beskrivs elementets SourceDirectory attribut.

Attribut	Typ	Beskrivning
path	sträng	Obligatoriskt. Relativ eller absolut sökväg för en lokal katalog vars innehåll kopieras till den virtuella Azure-datorn. Expansion av miljövariabler i katalogsökvägen stöds.

Nästa steg

Definitionsschema för Cloud Service (utökad support).

Dela via

WebRole-schema för Azure Cloud Services-definition (utökad support)

Grundläggande tjänstdefinitionsschema för en webbroll

Schemaelement

WebRole

ConfigurationSettings

Inställning

LocalResources

LocalStorage

Slutpunkter

InputEndpoint

InternalEndpoint

InstanceInputEndpoint

AllokeraPublicPortFrom

FixedPort

FixedPortRange

Certifikat

Certifikat

Importer

Importera

Körmiljö

Environment

Olika

RoleInstanceValue

EntryPoint

NetFxEntryPoint

Webbplatser

Webbplats

VirtualApplication

VirtualDirectory

Bindningar

Bindning

Start

Uppgift

Innehåll

Innehåll

SourceDirectory

Nästa steg

Feedback

Ytterligare resurser