Definition für Azure Cloud Services (klassisch): WebRole-Schema

Wichtig

Cloud Services (klassisch) wurde für neue Kunden nun als veraltet gekennzeichnet und wird am 31. August 2024 für alle Kunden ausgemustert. In neuen Bereitstellungen sollte das neue auf Azure Resource Manager basierende Bereitstellungsmodell für Azure Cloud Services (erweiterter Support) verwendet werden.

Die Azure-Webrolle ist eine Rolle, die für die Programmierung von Webanwendungen gemäß Unterstützung durch IIS 7 angepasst wird, z.B. ASP.NET, PHP, Windows Communication Foundation und FastCGI.

Die Standarderweiterung für die Dienstdefinitionsdatei lautet „.csdef“.

Grundlegendes Dienstdefinitionsschema für eine Webrolle

Das Standardformat einer Dienstdefinitionsdatei, die eine Webrolle enthält, lautet wie folgt:

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

Schema-Elemente

Die Dienstdefinitionsdatei enthält die unten angegebenen Elemente, die in den folgenden Abschnitten in diesem Thema ausführlich beschrieben werden:

WebRole

ConfigurationSettings

Einstellung

LocalResources

LocalStorage

Endpunkte

InternalEndpoint

InstanceInputEndpoint

AllocatePublicPortFrom

FixedPort

FixedPortRange

Zertifikate

Certificate

Importe

Importieren

Laufzeit

Umgebung

Variable

RoleInstanceValue

NetFxEntryPoint

Sites

Website

VirtualApplication

VirtualApplication

Bindungen

Binding

Startup

Aufgabe

Contents

Inhalt

SourceDirectory

WebRole

Das WebRole-Element beschreibt eine Rolle, die für die Programmierung von Webanwendungen gemäß Unterstützung durch IIS 7 und ASP.NET angepasst ist. Ein Dienst kann null oder mehr Webrollen enthalten.

In der folgenden Tabelle werden die Attribute des Elements WebRole beschrieben.

attribute	type	BESCHREIBUNG
name	Zeichenfolge	Erforderlich. Der Name für die Webrolle. Der Name der Rolle muss eindeutig sein.
enableNativeCodeExecution	boolean	Optional. Der Standardwert ist true. Die native Codeausführung und die volle Vertrauenswürdigkeit sind standardmäßig aktiviert. Legen Sie dieses Attribut auf false fest, um die native Codeausführung für die Webrolle zu deaktivieren und stattdessen Azure-Teilvertrauenswürdigkeit zu verwenden.
vmsize	Zeichenfolge	Optional. Legen Sie diesen Wert fest, um die Größe des virtuellen Computers zu ändern, der der Rolle zugeordnet ist. Standardwert: Small. Weitere Informationen finden Sie unter Größen virtueller Computer und Azure-Clouddienste.

ConfigurationSettings

Das ConfigurationSettings-Element beschreibt die Sammlung mit Konfigurationseinstellungen für eine Webrolle. Dies ist das übergeordnete Element des Setting-Elements.

Einstellung

Das Setting-Element beschreibt ein Name-Wert-Paar, mit dem eine Konfigurationseinstellung für die Instanz einer Rolle angegeben wird.

In der folgenden Tabelle werden die Attribute des Elements Setting beschrieben.

attribute	type	Beschreibung
name	Zeichenfolge	Erforderlich. Ein eindeutiger Name für die Konfigurationseinstellung.

Die Konfigurationseinstellungen für eine Rolle umfassen Name-Wert-Paare, die in der Dienstdefinitionsdatei deklariert und in der Dienstkonfigurationsdatei festgelegt werden.

LocalResources

Das LocalResources-Element beschreibt die Sammlung mit lokalen Speicherressourcen für eine Webrolle. Dies ist das übergeordnete Element des LocalStorage-Elements.

LocalStorage

Mit dem LocalStorage-Element wird eine lokale Speicherressource identifiziert, die für den Dienst zur Laufzeit Dateisystem-Speicherplatz bereitstellt. Eine Rolle kann null oder mehr lokale Speicherressourcen definieren.

Hinweis

Das LocalStorage-Element kann als untergeordnetes Element des WebRole-Elements verwendet werden, um die Kompatibilität mit früheren Versionen des Azure SDK zu unterstützen.

In der folgenden Tabelle werden die Attribute des Elements LocalStorage beschrieben.

attribute	type	BESCHREIBUNG
name	Zeichenfolge	Erforderlich. Ein eindeutiger Name für den lokalen Speicher.
cleanOnRoleRecycle	boolean	Optional. Gibt an, ob der lokale Speicher bereinigt werden soll, wenn die Rolle neu gestartet wird. Der Standardwert ist true.
sizeInMb	INT	Optional. Die gewünschte Speicherplatzmenge in MB, die für den lokalen Speicher zugeordnet wird. Wenn nichts angegeben ist, wird standardmäßig Speicherplatz mit einer Größe von 100 MB zugeordnet. Die Mindestmenge an Speicherplatz, die zugeordnet werden kann, beträgt 1 MB. Die maximale Größe der lokalen Ressourcen richtet sich nach der VM-Größe. Weitere Informationen finden Sie unter Größen virtueller Computer und Azure-Clouddienste.

Der Name des Verzeichnisses, der der lokalen Speicherressource zugeordnet ist, entspricht dem Wert, der für das Namensattribut angegeben wird.

Endpunkte

Das Endpoints-Element beschreibt die Sammlung mit den Endpunkten vom Typ „Eingabe (extern)“, „Intern“ und „Instanzeingabe“ einer Rolle. Dies ist das übergeordnete Element der Elemente InputEndpoint, InternalEndpoint und InstanceInputEndpoint.

Eingabe- und interne Endpunkte werden getrennt zugeordnet. Ein Dienst kann insgesamt über 25 Endpunkte vom Typ „Eingabe“, „Intern“ und „Instanzeingabe“ verfügen, die den 25 zulässigen Rollen eines Diensts zugeordnet werden können. Beispielsweise können Sie bei Verwendung von fünf Rollen fünf Eingabeendpunkte pro Rolle, 25 Eingabeendpunkte einer einzelnen Rolle oder jeweils einen Eingabeendpunkt für 25 Rollen zuordnen.

Hinweis

Für jede bereitgestellte Rolle ist eine Instanz pro Rolle erforderlich. Die standardmäßige Bereitstellung für ein Abonnement ist auf 20 Kerne und somit auf 20 Instanzen einer Rolle beschränkt. Wenn Ihre Anwendung mehr Instanzen benötigt, als standardmäßig bereitgestellt werden, helfen Ihnen die Informationen zur Erhöhung Ihres Kontingents auf der Supportseite für Abrechnung, Abonnementverwaltung und Kontingente weiter.

InputEndpoint

Das InputEndpoint-Element beschreibt einen externen Endpunkt für eine Webrolle.

Sie können mehrere Endpunkte definieren, bei denen es sich um eine Kombination aus HTTP-, HTTPS-, UDP- und TCP-Endpunkten handelt. Sie können eine beliebige Portnummer angeben, die Sie für einen Eingabeendpunkt auswählen, aber die angegebenen Portnummern für die einzelnen Rollen im Dienst müssen eindeutig sein. Wenn Sie beispielsweise angeben, dass eine Webrolle Port 80 für HTTP und Port 443 für HTTPS verwendet, können Sie anschließend ggf. angeben, dass eine zweite Webrolle Port 8080 für HTTP und Port 8043 für HTTPS verwendet.

In der folgenden Tabelle werden die Attribute des Elements InputEndpoint beschrieben.

attribute	type	BESCHREIBUNG
name	Zeichenfolge	Erforderlich. Ein eindeutiger Name für den externen Endpunkt.
Protokoll	Zeichenfolge	Erforderlich. Das Transportprotokoll für den externen Endpunkt. Für eine Webrolle lauten die möglichen Werte HTTP, HTTPS, UDP oder TCP.
port	INT	Erforderlich. Der Port für den externen Endpunkt. Sie können eine beliebige Portnummer angeben, die Sie auswählen, aber die angegebenen Portnummern für die einzelnen Rollen im Dienst müssen eindeutig sein. Mögliche Werte reichen von 1 bis 65.535 einschließlich (Azure SDK-Version 1.7 oder höher).
Zertifikat	Zeichenfolge	Für einen HTTPS-Endpunkt erforderlich. Der Name eines Zertifikats, das durch ein Certificate-Element definiert wird.
localPort	INT	Optional. Gibt einen Port an, der für interne Verbindungen am Endpunkt verwendet wird. Mit dem localPort-Attribut wird der externe Port auf dem Endpunkt einem internen Port auf einer Rolle zugeordnet. Dies ist nützlich, wenn eine Rolle mit einer internen Komponente über einen Port kommunizieren muss, der sich von dem Port unterscheidet, der extern verfügbar gemacht wird. Wenn nichts angegeben ist, entspricht der Wert von localPort dem Wert des port-Attributs. Legen Sie den Wert von localPort auf „*“ fest, um automatisch einen nicht zugeordneten Port zuzuweisen, der mit der Runtime-API ermittelbar ist. Mögliche Werte reichen von 1 bis 65.535 einschließlich (Azure SDK-Version 1.7 oder höher). Das localPort-Attribut ist nur verfügbar, wenn die Azure SDK-Version 1.3 oder höher verwendet wird.
ignoreRoleInstanceStatus	boolean	Optional. Wenn der Wert dieses Attributs auf true festgelegt ist, wird der Status eines Diensts ignoriert, und der Endpunkt wird vom Lastenausgleich nicht entfernt. Das Festlegen dieses Werts auf true ist hilfreich, um stark ausgelastete Instanzen eines Diensts zu debuggen. Standardwert: false. Hinweis: Ein Endpunkt kann auch dann weiterhin Datenverkehr empfangen, wenn sich die Rolle nicht im Status „Bereit“ befindet.
loadBalancerProbe	Zeichenfolge	Optional. Der Name des Lastenausgleichstests, der dem Eingabeendpunkt zugeordnet ist. Weitere Informationen finden Sie unter LoadBalancerProbe-Schema.

InternalEndpoint

Das InternalEndpoint-Element beschreibt einen internen Endpunkt für eine Webrolle. Eine interner Endpunkt ist nur für andere Rolleninstanzen verfügbar, die innerhalb des Diensts ausgeführt werden. Er ist nicht für Clients außerhalb des Diensts verfügbar. Webrollen, die das Sites-Element nicht enthalten, können nur über einen einzelnen internen HTTP-, UDP- oder TCP-Endpunkt verfügen.

In der folgenden Tabelle werden die Attribute des Elements InternalEndpoint beschrieben.

attribute	type	Beschreibung
name	Zeichenfolge	Erforderlich. Ein eindeutiger Name für den internen Endpunkt.
Protokoll	Zeichenfolge	Erforderlich. Das Transportprotokoll für den internen Endpunkt. Mögliche Werte sind HTTP, TCP, UDP oder ANY. Mit dem Wert ANY wird angegeben, dass alle Protokolle und alle Ports zulässig sind.
port	INT	Optional. Der Port, der für interne Verbindungen mit Lastenausgleich auf dem Endpunkt verwendet wird. Für einen Endpunkt mit Lastenausgleich werden zwei Ports verwendet. Der Port für die öffentliche IP-Adresse und der Port für die private IP-Adresse. Normalerweise wird hierfür der gleiche Port verwendet, aber Sie können auch unterschiedliche Ports verwenden. Mögliche Werte reichen von 1 bis 65.535 einschließlich (Azure SDK-Version 1.7 oder höher). Das Port-Attribut ist nur verfügbar, wenn die Azure SDK-Version 1.3 oder höher verwendet wird.

InstanceInputEndpoint

Das InstanceInputEndpoint-Element beschreibt einen Instanz-Eingabeendpunkt für eine Webrolle. Ein Instanz-Eingabeendpunkt wird einer bestimmten Rolleninstanz zugeordnet, indem die Portweiterleitung im Lastenausgleich verwendet wird. Jeder Instanz-Eingabeendpunkt ist einem bestimmten Port aus einem Bereich möglicher Ports zugeordnet. Dies ist das übergeordnete Element des AllocatePublicPortFrom-Elements.

Das InstanceInputEndpoint-Element ist nur verfügbar, wenn die Azure SDK-Version 1.7 oder höher verwendet wird.

In der folgenden Tabelle werden die Attribute des Elements InstanceInputEndpoint beschrieben.

attribute	type	BESCHREIBUNG
name	Zeichenfolge	Erforderlich. Ein eindeutiger Name für den Endpunkt.
localPort	INT	Erforderlich. Gibt den internen Port an, auf den alle Rolleninstanzen lauschen, um eingehenden Datenverkehr zu empfangen, der vom Lastenausgleich weitergeleitet wird. Mögliche Werte liegen zwischen 1 und 65.535 (einschließlich).
Protokoll	Zeichenfolge	Erforderlich. Das Transportprotokoll für den internen Endpunkt. Mögliche Werte sind udp oder tcp. Verwenden Sie tcp für HTTP/HTTPS-basierten Datenverkehr.

AllocatePublicPortFrom

Das AllocatePublicPortFrom-Element beschreibt den öffentlichen Portbereich, der von externen Kunden verwendet werden kann, um auf die einzelnen Instanz-Eingabeendpunkte zuzugreifen. Die öffentliche Portnummer (VIP) wird aus diesem Bereich zugeordnet und während der Bereitstellung und Aktualisierung des Mandanten den individuellen Rolleninstanzendpunkten zugewiesen. Dies ist das übergeordnete Element des FixedPortRange-Elements.

Das AllocatePublicPortFrom-Element ist nur verfügbar, wenn die Azure SDK-Version 1.7 oder höher verwendet wird.

FixedPort

Das FixedPort-Element gibt den Port für den internen Endpunkt an, um auf dem Endpunkt die Verwendung von Verbindungen mit Lastenausgleich zu ermöglichen.

Das FixedPort-Element ist nur verfügbar, wenn die Azure SDK-Version 1.3 oder höher verwendet wird.

In der folgenden Tabelle werden die Attribute des Elements FixedPort beschrieben.

attribute	type	Beschreibung
port	INT	Erforderlich. Der Port für den internen Endpunkt. Dies hat die gleiche Wirkung wie das Festlegen des Minimums und Maximums von FixedPortRange auf denselben Port. Mögliche Werte reichen von 1 bis 65.535 einschließlich (Azure SDK-Version 1.7 oder höher).

FixedPortRange

Das FixedPortRange-Element gibt den Bereich der Ports an, die dem internen Endpunkt oder Instanz-Eingabeendpunkt zugewiesen sind, und legt den Port fest, der für Verbindungen mit Lastenausgleich auf dem Endpunkt verwendet wird.

Hinweis

Das FixedPortRange-Element verhält sich je nach dem Element, auf dem es sich befindet, auf unterschiedliche Weise. Wenn sich das FixedPortRange-Element unter dem InternalEndpoint-Element befindet, werden alle Ports auf dem Lastenausgleich innerhalb des Bereichs der min- und max-Attribute für alle virtuellen Computer geöffnet, auf denen die Rolle ausgeführt wird. Wenn sich das FixedPortRange-Element auf dem InstanceInputEndpoint-Element befindet, wird nur ein Port innerhalb des Bereichs der min- und max-Attribute auf jedem virtuellen Computer geöffnet, auf dem die Rolle ausgeführt wird.

Das FixedPortRange-Element ist nur verfügbar, wenn die Azure SDK-Version 1.3 oder höher verwendet wird.

In der folgenden Tabelle werden die Attribute des Elements FixedPortRange beschrieben.

attribute	type	Beschreibung
Min	INT	Erforderlich. Der niedrigste Port im Bereich. Mögliche Werte reichen von 1 bis 65.535 einschließlich (Azure SDK-Version 1.7 oder höher).
max	Zeichenfolge	Erforderlich. Der höchste Port im Bereich. Mögliche Werte reichen von 1 bis 65.535 einschließlich (Azure SDK-Version 1.7 oder höher).

Zertifikate

Das Certificates-Element beschreibt die Sammlung mit Zertifikaten für eine Webrolle. Dies ist das übergeordnete Element des Certificate-Elements. Eine Rolle kann über beliebig viele zugeordnete Zertifikate verfügen. Weitere Informationen zur Verwendung des Certificate-Elements finden Sie unter Ändern der Definitions- und Konfigurationsdateien für den Dienst.

Zertifikat

Das Certificate-Element beschreibt ein Zertifikat, das einer Webrolle zugeordnet ist.

In der folgenden Tabelle werden die Attribute des Elements Certificate beschrieben.

attribute	type	BESCHREIBUNG
name	Zeichenfolge	Erforderlich. Ein Name für dieses Zertifikat, mit dem darauf verwiesen wird, wenn es einem InputEndpoint-HTTPS-Element zugeordnet ist.
storeLocation	Zeichenfolge	Erforderlich. Der Speicherort des Zertifikatspeichers, in dem sich dieses Zertifikat auf dem lokalen Computer befinden kann. Mögliche Werte sind CurrentUser und LocalMachine.
storeName	Zeichenfolge	Erforderlich. Der Name des Zertifikatspeichers, in dem sich dieses Zertifikat auf dem lokalen Computer befindet. Mögliche Werte sind die Namen My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot und AddressBook von integrierten Speichern oder der Name eines beliebigen benutzerdefinierten Speichers. Wenn der Name eines benutzerdefinierten Speichers angegeben wird, wird der Speicher automatisch erstellt.
permissionLevel	Zeichenfolge	Optional. Gibt die Zugriffsberechtigungen an, die für die Rollenprozesse gewährt werden. Geben Sie die Berechtigung elevated an, wenn nur Prozesse mit erhöhten Rechten auf den privaten Schlüssel zugreifen sollen. Mit der Berechtigung limitedOrElevated können alle Rollenprozesse auf den privaten Schlüssel zugreifen. Mögliche Werte sind limitedOrElevated oder elevated. Standardwert: limitedOrElevated.

Importe

Das Imports-Element beschreibt eine Sammlung mit Importmodulen für eine Webrolle, mit denen Komponenten dem Gastbetriebssystem hinzugefügt werden. Dies ist das übergeordnete Element des Import-Elements. Dieses Element ist optional, und eine Rolle kann nur einen Importblock aufweisen.

Das Imports-Element ist nur verfügbar, wenn die Azure SDK-Version 1.3 oder höher verwendet wird.

Importieren

Das Import-Element gibt ein Modul zum Hinzufügen zum Gastbetriebssystem an.

Das Import-Element ist nur verfügbar, wenn die Azure SDK-Version 1.3 oder höher verwendet wird.

In der folgenden Tabelle werden die Attribute des Elements Import beschrieben.

attribute	type	Beschreibung
moduleName	Zeichenfolge	Erforderlich. Der Name des zu importierenden Moduls. Gültige Importmodule sind: - RemoteAccess - RemoteForwarder - Diagnostics Mit den Modulen RemoteAccess und RemoteForwarder können Sie Ihre Rolleninstanz für Remotedesktopverbindungen konfigurieren. Weitere Informationen finden Sie unter Aktivieren einer Remotedesktopverbindung. Das Modul Diagnostics ermöglicht Ihnen das Sammeln von Diagnosedaten für eine Rolleninstanz.

Laufzeit

Das Runtime-Element beschreibt eine Sammlung mit Umgebungsvariableneinstellungen für eine Webrolle, mit denen die Laufzeitumgebung des Azure-Hostprozesses gesteuert wird. Dies ist das übergeordnete Element des Environment-Elements. Dieses Element ist optional, und eine Rolle kann nur einen Laufzeitblock haben.

Das Runtime-Element ist nur verfügbar, wenn die Azure SDK-Version 1.3 oder höher verwendet wird.

In der folgenden Tabelle sind die Attribute des Runtime-Elements beschrieben:

Attribut	type	Beschreibung
executionContext	Zeichenfolge	Optional. Gibt den Kontext an, in dem der Rollenprozess gestartet wird. Der Standardkontext ist limited. - limited: Der Prozess wird ohne Administratorrechte gestartet. - elevated: Der Prozess wird mit Administratorrechten gestartet.

Umgebung

Das Environment-Element beschreibt eine Sammlung mit Umgebungsvariableneinstellungen für eine Webrolle. Dies ist das übergeordnete Element des Variable-Elements. Für eine Rolle kann eine beliebige Anzahl von Umgebungsvariablen festgelegt werden.

Variable

Das Variable-Element gibt eine Umgebungsvariable zum Festlegen im Gastbetriebssystem an.

Das Variable-Element ist nur verfügbar, wenn die Azure SDK-Version 1.3 oder höher verwendet wird.

In der folgenden Tabelle sind die Attribute des Variable-Elements beschrieben:

Attribut	type	BESCHREIBUNG
name	Zeichenfolge	Erforderlich. Der Name der festzulegenden Umgebungsvariablen.
value	Zeichenfolge	Optional. Der Wert, der für die Umgebungsvariable festgelegt werden soll. Sie müssen entweder ein Wertattribut oder ein RoleInstanceValue-Element einbinden.

RoleInstanceValue

Das RoleInstanceValue-Element gibt den xPath an, über den der Wert der Variablen abgerufen wird.

In der folgenden Tabelle werden die Attribute des Elements RoleInstanceValue beschrieben.

attribute	type	Beschreibung
xpath	Zeichenfolge	Optional. Pfad zum Speicherort der Bereitstellungseinstellungen für die Instanz. Weitere Informationen finden Sie unter Verfügbarmachen von Rollenkonfigurationseinstellungen als Umgebungsvariable mit XPath. Sie müssen entweder ein Wertattribut oder ein RoleInstanceValue-Element einbinden.

EntryPoint

Das EntryPoint-Element gibt den Einstiegspunkt für eine Rolle an. Dies ist das übergeordnete Element des NetFxEntryPoint-Elements. Diese Elemente ermöglichen Ihnen das Angeben einer anderen Anwendung als der Standarddatei „WaWorkerHost.exe“ als Rolleneinstiegspunkt.

Das EntryPoint-Element ist nur verfügbar, wenn die Azure SDK-Version 1.5 oder höher verwendet wird.

NetFxEntryPoint

Das NetFxEntryPoint-Element gibt das Programm an, das für eine Rolle ausgeführt werden soll.

Hinweis

Das NetFxEntryPoint-Element ist nur verfügbar, wenn die Azure SDK-Version 1.5 oder höher verwendet wird.

In der folgenden Tabelle werden die Attribute des Elements NetFxEntryPoint beschrieben.

attribute	type	Beschreibung
assemblyName	Zeichenfolge	Erforderlich. Der Pfad und Dateiname der Assembly, die den Einstiegspunkt enthält. Der Pfad ist relativ zum Ordner \%ROLEROOT%\Approot (geben Sie nicht \%ROLEROOT%\Approot in commandLine an; davon wird ausgegangen). %ROLEROOT% ist eine von Azure verwaltete Umgebungsvariable, die den Speicherort des Stammordners für Ihre Rolle darstellt. Der Ordner \%ROLEROOT%\Approot stellt den Anwendungsordner für Ihre Rolle dar. Bei HWC-Rollen verhält sich der Pfad immer relativ zum Ordner \%ROLEROOT%\Approot\bin. Für vollständige IIS- und IIS Express-Webrollen wird \%ROLEROOT%\Approot\bin durchsucht, wenn die Assembly in Bezug auf \%ROLEROOT%\Approot nicht gefunden wird. Dieses Fallback-Verhalten für die IIS-Vollversion ist keine bewährte Methode und wird in zukünftigen Versionen unter Umständen nicht mehr möglich sein.
targetFrameworkVersion	Zeichenfolge	Erforderlich. Die .NET Framework-Version, unter der die Assembly erstellt wurde. Beispiel: targetFrameworkVersion="v4.0".

Standorte

Das Sites-Element beschreibt eine Sammlung mit Websites und Webanwendungen, die in einer Webrolle gehostet werden. Dies ist das übergeordnete Element des Site-Elements. Wenn Sie kein Sites-Element angeben,wird Ihre Webrolle als Legacywebrolle gehostet, und Sie können unter Ihrer Webrolle nur eine Website hosten. Dieses Element ist optional, und eine Rolle kann nur einen Websiteblock haben.

Das Sites-Element ist nur verfügbar, wenn die Azure SDK-Version 1.3 oder höher verwendet wird.

Website

Das Site-Element gibt eine Website oder Webanwendung an, die Teil der Webrolle ist.

Das Site-Element ist nur verfügbar, wenn die Azure SDK-Version 1.3 oder höher verwendet wird.

In der folgenden Tabelle werden die Attribute des Elements Site beschrieben.

attribute	type	BESCHREIBUNG
name	Zeichenfolge	Erforderlich. Der Name der Website oder Anwendung.
physicalDirectory	Zeichenfolge	Der Speicherort des Inhaltsverzeichnisses für das Stammverzeichnis der Site. Der Speicherort kann als absoluter Pfad oder relativ zum CSDEF-Speicherort angegeben werden.

VirtualApplication

Das VirtualApplication-Element definiert eine Anwendung in Internetinformationsdienste (IIS) 7. Es handelt sich um eine Gruppierung von Dateien, mit denen Inhalte oder über Protokolle wie HTTP Dienste bereitgestellt werden. Wenn Sie eine Anwendung in IIS 7 erstellen, wird der Pfad der Anwendung Teil der Site-URL.

Das VirtualApplication-Element ist nur verfügbar, wenn die Azure SDK-Version 1.3 oder höher verwendet wird.

In der folgenden Tabelle werden die Attribute des Elements VirtualApplication beschrieben.

attribute	type	BESCHREIBUNG
name	Zeichenfolge	Erforderlich. Gibt einen Namen zur Identifizierung der virtuellen Anwendung an.
physicalDirectory	Zeichenfolge	Erforderlich. Gibt den Pfad auf dem Entwicklungscomputer an, der die virtuelle Anwendung enthält. Im Serveremulator ist IIS so konfiguriert, dass Inhalt von diesem Speicherort abgerufen wird. Beim Bereitstellen in Azure wird der Inhalt des physischen Verzeichnisses zusammen mit dem Rest des Diensts verpackt. Wenn das Dienstpaket in Azure bereitgestellt wird, wird IIS mit dem Speicherort des entpackten Inhalts konfiguriert.

VirtualDirectory

Das VirtualDirectory-Element gibt einen Verzeichnisnamen an (auch als Pfad bezeichnet), den Sie in IIS angeben und einem physischen Verzeichnis auf einem lokalen Server oder Remoteserver zuordnen.

Das VirtualDirectory-Element ist nur verfügbar, wenn die Azure SDK-Version 1.3 oder höher verwendet wird.

In der folgenden Tabelle werden die Attribute des Elements VirtualDirectory beschrieben.

attribute	type	BESCHREIBUNG
name	Zeichenfolge	Erforderlich. Gibt einen Namen zur Identifizierung des virtuellen Verzeichnisses an.
value	physicalDirectory	Erforderlich. Gibt den Pfad auf dem Entwicklungscomputer an, der die Inhalte der Website bzw. des virtuellen Verzeichnisses enthält. Im Serveremulator ist IIS so konfiguriert, dass Inhalt von diesem Speicherort abgerufen wird. Beim Bereitstellen in Azure wird der Inhalt des physischen Verzeichnisses zusammen mit dem Rest des Diensts verpackt. Wenn das Dienstpaket in Azure bereitgestellt wird, wird IIS mit dem Speicherort des entpackten Inhalts konfiguriert.

Bindungen

Das Bindings-Element beschreibt eine Sammlung mit Bindungen für eine Website. Dies ist das übergeordnete Element des Binding-Elements. Das Element ist für jedes Site-Element erforderlich. Weitere Informationen zum Konfigurieren von Endpunkten finden Sie unter Ermöglichen der Kommunikation für Rolleninstanzen in Azure.

Das Bindings-Element ist nur verfügbar, wenn die Azure SDK-Version 1.3 oder höher verwendet wird.

Bindung

Das Binding-Element gibt Konfigurationsinformationen an, die für Anforderungen zum Kommunizieren mit einer Website oder Webanwendung erforderlich sind.

Das Binding-Element ist nur verfügbar, wenn die Azure SDK-Version 1.3 oder höher verwendet wird.

Attribut	type	BESCHREIBUNG
name	Zeichenfolge	Erforderlich. Gibt einen Namen zur Identifizierung der Bindung an.
endpointName	Zeichenfolge	Erforderlich. Gibt den Endpunktnamen an, für den die Bindung erfolgen soll.
hostHeader	Zeichenfolge	Optional. Gibt einen Hostnamen an, mit dem Sie mehrere Sites mit unterschiedlichen Hostnamen unter einer einzelnen Kombination aus IP-Adresse und Portnummer hosten können.

Start

Das Startup-Element beschreibt eine Sammlung mit Aufgaben, die ausgeführt werden, wenn die Rolle gestartet wird. Dies kann das übergeordnete Element des Variable-Elements sein. Weitere Informationen zur Verwendung der Rollenstartaufgaben finden Sie unter Konfigurieren und Ausführen von Startaufgaben für einen Clouddienst. Dieses Element ist optional, und eine Rolle kann nur einen Startblock haben.

In der folgenden Tabelle sind die Attribute des Startup-Elements beschrieben.

Attribut	type	Beschreibung
priority	INT	Nur zur internen Verwendung.

Aufgabe

Das Task-Element gibt Startaufgaben an, die ausgeführt werden, wenn die Rolle gestartet wird. Startaufgaben können verwendet werden, um Aufgaben durchzuführen, mit denen die Rolle darauf vorbereitet wird, diese Komponenten zur Softwareinstallation oder andere Anwendungen auszuführen. Aufgaben werden in der Reihenfolge ausgeführt, in der sie im Startup-Elementblock angezeigt werden.

Das Task-Element ist nur verfügbar, wenn die Azure SDK-Version 1.3 oder höher verwendet wird.

In der folgenden Tabelle werden die Attribute des Elements Task beschrieben.

attribute	type	Beschreibung
commandLine	Zeichenfolge	Erforderlich. Ein Skript, z.B. eine CMD-Datei, das die auszuführenden Befehle enthält. Startbefehls- und Batchdateien müssen im ANSI-Format gespeichert werden. Dateiformate, bei denen am Anfang der Datei eine Bytereihenfolge-Marke festgelegt wird, werden nicht richtig verarbeitet.
executionContext	Zeichenfolge	Gibt den Kontext an, in dem das Skript ausgeführt wird. - limited [Standard]: Die Ausführung erfolgt mit den gleichen Rechten wie für die Rolle, die den Prozess hostet. - elevated: Die Ausführung erfolgt mit Administratorrechten.
taskType	Zeichenfolge	Gibt das Ausführungsverhalten des Befehls an. - simple [Standard]: Das System wartet, bis die Aufgabe beendet wird (exit), bevor andere Aufgaben gestartet werden. - background: Das System wartet nicht auf die Beendigung der Aufgabe. - foreground: Ähnelt „background“, aber die Rolle wird erst neu gestartet, nachdem alle Aufgaben im Vordergrund beendet wurden.

Inhalte

Das Contents-Element beschreibt die Sammlung mit dem Inhalt einer Webrolle. Dies ist das übergeordnete Element des Content-Elements.

Das Contents-Element ist nur verfügbar, wenn die Azure SDK-Version 1.5 oder höher verwendet wird.

Inhalt

Das Content-Element definiert den Quellspeicherort des Inhalts, der auf den virtuellen Azure-Computer kopiert werden soll, und den Zielpfad für den Kopiervorgang.

Das Content-Element ist nur verfügbar, wenn die Azure SDK-Version 1.5 oder höher verwendet wird.

In der folgenden Tabelle werden die Attribute des Elements Content beschrieben.

attribute	type	Beschreibung
destination	Zeichenfolge	Erforderlich. Der Speicherort des virtuellen Azure-Computers, auf dem der Inhalt angeordnet wird. Dieser Speicherort ist relativ zum Ordner %ROLEROOT%\Approot.

Dies ist das übergeordnete Element des SourceDirectory-Elements.

SourceDirectory

Das SourceDirectory-Element definiert das lokale Verzeichnis, aus dem der Inhalt kopiert wird. Verwenden Sie dieses Element, um die lokalen Inhalte anzugeben, die auf den virtuellen Azure-Computer kopiert werden sollen.

Das SourceDirectory-Element ist nur verfügbar, wenn die Azure SDK-Version 1.5 oder höher verwendet wird.

In der folgenden Tabelle werden die Attribute des Elements SourceDirectory beschrieben.

attribute	type	Beschreibung
path	Zeichenfolge	Erforderlich. Der relative oder absolute Pfad eines lokalen Verzeichnisses, dessen Inhalte auf den virtuellen Azure-Computer kopiert werden sollen. Die Erweiterung von Umgebungsvariablen im Verzeichnispfad wird unterstützt.

Weitere Informationen

Clouddienst-Definitionsschema (klassisch)