Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Wichtig
Cloud Services (klassisch) ist jetzt ab dem 1. September 2024 für alle Kunden veraltet. Alle vorhandenen ausgeführten Bereitstellungen werden beendet und von Microsoft heruntergefahren, und die Daten sind ab Oktober 2024 dauerhaft verloren. Neue Bereitstellungen sollten das neue azure Resource Manager-basierte Bereitstellungsmodell Azure Cloud Services (erweiterter Support) verwenden.
Die Azure-Workerrolle ist eine Rolle, die für die generalisierte Entwicklung nützlich ist und die Hintergrundverarbeitung für eine Webrolle durchführen kann.
Die Standarderweiterung für die Dienstdefinitionsdatei lautet „.csdef“.
Grundlegendes Dienstdefinitionsschema für eine Worker-Rolle
Das Standardformat einer Dienstdefinitionsdatei, die eine Workerrolle enthält, lautet wie folgt:
<ServiceDefinition …>
<WorkerRole name="<worker-role-name>" vmsize="<worker-role-size>" enableNativeCodeExecution="[true|false]">
<Certificates>
<Certificate name="<certificate-name>" storeLocation="[CurrentUser|LocalMachine]" storeName="[My|Root|CA|Trust|Disallow|TrustedPeople|TrustedPublisher|AuthRoot|AddressBook|<custom-store>" />
</Certificates>
<ConfigurationSettings>
<Setting name="<setting-name>" />
</ConfigurationSettings>
<Endpoints>
<InputEndpoint name="<input-endpoint-name>" protocol="[http|https|tcp|udp]" localPort="<local-port-number>" port="<port-number>" certificate="<certificate-name>" 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>
<Imports>
<Import moduleName="[RemoteAccess|RemoteForwarder|Diagnostics]"/>
</Imports>
<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>"/>
<ProgramEntryPoint commandLine="<application>" setReadyOnProcessStart="[true|false]"/>
</EntryPoint>
</Runtime>
<Startup priority="<for-internal-use-only>">
<Task commandLine="" 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>
</WorkerRole>
</ServiceDefinition>
Schemaelemente
Die Dienstdefinitionsdatei enthält die unten angegebenen Elemente, die in den folgenden Abschnitten in diesem Artikel ausführlich beschrieben werden:
Arbeitsrolle
Das WorkerRole-Element beschreibt eine Rolle, die für die generalisierte Entwicklung nützlich ist und die Hintergrundverarbeitung für eine Webrolle durchführen kann. Ein Dienst kann null oder mehr Workerrollen enthalten.
In der folgenden Tabelle werden die Attribute des Elements WorkerRole beschrieben.
| Attribut | Typ | BESCHREIBUNG |
|---|---|---|
| Name | Schnur | Erforderlich. Der Name für die Arbeiterrolle. Der Name der Rolle muss eindeutig sein. |
| Ausführung von nativen Code aktivieren | Boolescher Wert | Wahlfrei. 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 Workerrolle zu deaktivieren und stattdessen Teilvertrauen in Azure zu verwenden. |
| vmsize | Schnur | Wahlfrei. Legen Sie diesen Wert fest, um die Größe des virtuellen Computers zu ändern, der dieser Rolle zugeordnet ist. Der Standardwert ist Small. Eine Liste der möglichen Größen virtueller Computer und deren Attribute finden Sie unter Virtual Machine sizes for Cloud Services. |
Konfigurationseinstellungen
Das ConfigurationSettings-Element beschreibt die Sammlung von Konfigurationseinstellungen für eine Workerrolle. Dies ist das übergeordnete Element des Setting-Elements.
Konfiguration
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.
| Attribut | Typ | BESCHREIBUNG |
|---|---|---|
| Name | Schnur | 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.
LokaleRessourcen
Das LocalResources-Element beschreibt die Sammlung lokaler Speicherressourcen für eine Worker-Rolle. Dies ist das übergeordnete Element des LocalStorage-Elements.
Lokale Speicherung (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 WorkerRole-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.
| Attribut | Typ | BESCHREIBUNG |
|---|---|---|
| Name | Schnur | Erforderlich. Ein einzigartiger Name für den lokalen Laden. |
| cleanOnRoleRecycle | Boolescher Wert | Wahlfrei. Gibt an, ob der lokale Speicher bereinigt werden soll, wenn die Rolle neu gestartet wird. Der Standardwert ist true. |
| GrößeInMB | Int | Wahlfrei. 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 in den Größen virtueller Computer für 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 von externen, internen und Instanzeingabeendpunkten 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. Wenn Sie beispielsweise über fünf Rollen verfügen, können Sie fünf Eingabeendpunkte pro Rolle zuordnen, einer einzelnen Rolle 25 Eingabeendpunkte zuordnen oder jeweils 25 Rollen einen Eingabeendpunkt zuordnen.
Hinweis
Für jede bereitgestellte Rolle ist eine Instanz pro Rolle erforderlich. Die Standardbereitstellung für ein Abonnement ist auf 20 Kerne und somit auf 20 Instanzen einer Rolle beschränkt. Wenn Ihre Anwendung mehr Instanzen erfordert als von der Standardbereitstellung bereitgestellt wird, finden Sie unter Abrechnung, Abonnementverwaltung und Kontingentunterstützung weitere Informationen zum Erhöhen Ihres Kontingents.
Eingabe-Endpunkt
Das InputEndpoint-Element beschreibt einen externen Endpunkt für eine Arbeiterrolle.
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 Workerrolle Port 80 für HTTP und Port 443 für HTTPS verwendet, können Sie anschließend ggf. angeben, dass eine zweite Workerrolle Port 8080 für HTTP und Port 8043 für HTTPS verwendet.
In der folgenden Tabelle werden die Attribute des Elements InputEndpoint beschrieben.
| Attribut | Typ | BESCHREIBUNG |
|---|---|---|
| Name | Schnur | Erforderlich. Ein eindeutiger Name für den externen Endpunkt. |
| Protokoll | Schnur | Erforderlich. Das Transportprotokoll für den externen Endpunkt. Für eine Worker-Rolle lauten die möglichen Werte HTTP, HTTPS, UDP oder TCP. |
| Hafen | Int | Erforderlich. Der Port für den externen Endpunkt. Sie können jede von Ihnen ausgewählte Portnummer angeben, aber die für jede Rolle im Dienst angegebenen Portnummern müssen eindeutig sein. Mögliche Werte reichen von 1 bis 65.535 einschließlich (Azure SDK-Version 1.7 oder höher). |
| Zertifikat | Schnur | Für einen HTTPS-Endpunkt erforderlich. Der Name eines Zertifikats, das durch ein Certificate-Element definiert wird. |
| lokaler Port | Int | Wahlfrei. Gibt einen Port an, der für interne Verbindungen am Endpunkt verwendet wird. Mit dem localPort-Attribut wird der externe Port eines Endpunkts einem internen Port einer Rolle zugeordnet. Dieses Attribut 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 | Boolescher Wert | Wahlfrei. Wenn der Wert dieses Attributs auf true festgelegt ist, wird der Status eines Diensts ignoriert, und der Lastenausgleich entfernt den Endpunkt nicht. Das Festlegen dieses Werts auf true ist hilfreich, um stark ausgelastete Instanzen eines Diensts zu debuggen. Der Standardwert ist false.
Anmerkung: Ein Endpunkt kann weiterhin Datenverkehr empfangen, auch wenn sich die Rolle nicht im Status "Bereit" befindet. |
| loadBalancerProbe | Schnur | Wahlfrei. Der Name des Lastenausgleichsprüfers, der dem Eingabeendpunkt zugeordnet ist. Weitere Informationen finden Sie unter LoadBalancerProbe-Schema. |
InternerEndpunkt
Das InternalEndpoint-Element beschreibt einen internen Endpunkt für eine Worker-Role. 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. Eine Workerrolle kann bis zu fünf interne HTTP-, UDP- oder TCP-Endpunkte haben.
In der folgenden Tabelle werden die Attribute des Elements InternalEndpoint beschrieben.
| Attribut | Typ | BESCHREIBUNG |
|---|---|---|
| Name | Schnur | Erforderlich. Ein eindeutiger Name für den internen Endpunkt. |
| Protokoll | Schnur | Erforderlich. Das Transportprotokoll für den internen Endpunkt. Mögliche Werte lauten HTTP, TCP, UDP oder ANY.Mit dem Wert ANY wird angegeben, dass alle Protokolle und alle Ports zulässig sind. |
| Hafen | Int | Wahlfrei. 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 werden diese Werte gleich eingestellt, 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. |
InstanzEingabeEndpunkt
Das InstanceInputEndpoint-Element beschreibt einen Instanz-Input-Endpunkt für eine Worker-Role. Ein Instanz-Eingabeendpunkt wird einer spezifischen Rolleninstanz zugeordnet, indem die Portweiterleitung im Load Balancer 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.
| Attribut | Typ | BESCHREIBUNG |
|---|---|---|
| Name | Schnur | Erforderlich. Ein eindeutiger Name für den Endpunkt. |
| lokaler Port | Int | Erforderlich. Gibt den internen Port an, auf den alle Rolleninstanzen horchen, um eingehenden Datenverkehr zu empfangen, der vom Load Balancer weitergeleitet wird. Mögliche Werte liegen zwischen 1 und 65535 einschließlich. |
| Protokoll | Schnur | Erforderlich. Das Transportprotokoll für den internen Endpunkt. Mögliche Werte sind udp oder tcp. Verwenden Sie tcp für HTTP/HTTPS-basierten Datenverkehr. |
ÖffentlichenPortZuweisenVon
Das AllocatePublicPortFrom-Element beschreibt den öffentlichen Portbereich, der von externen Kunden verwendet werden kann, um auf die einzelnen Instanzeingabeendpunkte zuzugreifen. Die öffentliche (VIP) Portnummer stammt aus diesem Bereich und wird den einzelnen Rolleninstanzendpunkten während der Bereitstellung und Aktualisierung des Mandanten 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.
fester Anschluss
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.
| Attribut | Typ | BESCHREIBUNG |
|---|---|---|
| Hafen | Int | Erforderlich. Der Port für den internen Endpunkt. Dieses Attribut 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 im InternalEndpoint-Element befindet, werden innerhalb des Bereichs der min- und max-Attribute alle Ports auf dem Load-Balancer für alle virtuellen Rechner 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.
| Attribut | Typ | 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 | Schnur | 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 von Zertifikaten für eine Worker-Rolle. Dies ist das übergeordnete Element des Certificate-Elements. Eine Rolle kann über beliebig viele zugeordnete Zertifikate verfügen. Weitere Informationen zur Verwendung des Zertifikatelements finden Sie unter Ändern der Dienstdefinitionsdatei mit einem Zertifikat.
Zertifikat
Das Certificate-Element beschreibt ein Zertifikat, das einer Workerrolle zugeordnet ist.
In der folgenden Tabelle werden die Attribute des Elements Certificate beschrieben.
| Attribut | Typ | BESCHREIBUNG |
|---|---|---|
| Name | Schnur | Erforderlich. Ein Name für dieses Zertifikat, mit dem darauf verwiesen wird, wenn es einem InputEndpoint-HTTPS-Element zugeordnet ist. |
| Ladenstandort | Schnur | Erforderlich. Der Speicherort des Zertifikatspeichers, in dem sich dieses Zertifikat auf dem lokalen Computer befinden kann. Mögliche Werte sind CurrentUser und LocalMachine. |
| storeName | Schnur | 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. |
| Berechtigungsstufe | Schnur | Wahlfrei. 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. Der Standardwert ist limitedOrElevated. |
Importe
Das Imports-Element beschreibt eine Sammlung mit Importmodulen für eine Workerrolle, 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 Laufzeitblock haben.
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.
| Attribut | Typ | BESCHREIBUNG |
|---|---|---|
| Modulname | Schnur | Erforderlich. Der Name des zu importierenden Moduls. Gültige Importmodule sind: – RemoteAccess - RemoteForwarder - Diagnostik Mit den Modulen RemoteAccess und RemoteForwarder können Sie Ihre Rolleninstanz für Remotedesktopverbindungen konfigurieren. Weitere Informationen finden Sie unter Aktivieren der 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 Workerrolle, 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 | Typ | BESCHREIBUNG |
|---|---|---|
| Ausführungskontext | Schnur | Wahlfrei. 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. |
Umwelt
Das Environment-Element beschreibt eine Sammlung mit Umgebungsvariableneinstellungen für eine Workerrolle. 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 | Typ | BESCHREIBUNG |
|---|---|---|
| Name | Schnur | Erforderlich. Der Name der festzulegenden Umgebungsvariablen. |
| Wert | Schnur | Wahlfrei. Der Wert, der für die Umgebungsvariable festgelegt werden soll. Sie müssen entweder ein Wertattribut oder ein RoleInstanceValue-Element einbinden. |
Rolleninstanzwert
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.
| Attribut | Typ | BESCHREIBUNG |
|---|---|---|
| xpath | Schnur | Wahlfrei. Pfad zum Speicherort der Bereitstellungseinstellungen für die Instanz. Weitere Informationen finden Sie unter Konfigurationsvariablen mit XPath. Sie müssen entweder ein Wertattribut oder ein RoleInstanceValue-Element einbinden. |
Einstiegspunkt
Das EntryPoint-Element gibt den Einstiegspunkt für eine Rolle an. Dies ist das übergeordnete Element der NetFxEntryPoint-Elemente. 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.
| Attribut | Typ | BESCHREIBUNG |
|---|---|---|
| assemblyName | Schnur | 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 der Befehlszeile an. Es wird davon ausgegangen). %ROLEROOT% ist eine Von Azure verwaltete Umgebungsvariable und stellt den Speicherort des Stammordners für Ihre Rolle dar. Der Ordner \%ROLEROOT%\Approot stellt den Anwendungsordner für Ihre Rolle dar. |
| targetFrameworkVersion (Ziel-Framework-Version) | Schnur | Erforderlich. Die .NET Framework-Version, unter der die Assembly erstellt wurde. Beispiel: targetFrameworkVersion="v4.0". |
ProgramEntryPoint
Das ProgramEntryPoint-Element gibt das Programm an, das für eine Rolle ausgeführt werden soll. Mit dem ProgramEntryPoint-Element können Sie einen Programmeinstiegspunkt angeben, der nicht auf einer .NET-Assembly basiert.
Hinweis
Das ProgramEntryPoint-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 ProgramEntryPoint beschrieben.
| Attribut | Typ | BESCHREIBUNG |
|---|---|---|
| Kommandozeile | Schnur | Erforderlich. Der Pfad, Dateiname und alle Befehlszeilenargumente des auszuführenden Programms. Der Pfad ist relativ zum Ordner %ROLEROOT%\Approot (geben Sie nicht %ROLEROOT%\Approot in der Befehlszeile an; es wird angenommen).
%ROLEROOT% ist eine Von Azure verwaltete Umgebungsvariable und stellt den Speicherort des Stammordners für Ihre Rolle dar. Der ordner%ROLEROOT%\Approot stellt den Anwendungsordner für Ihre Rolle dar. Wenn das Programm endet, wird die Rolle recycelt. Im Allgemeinen sollten Sie das Programm also so festlegen, dass es weiter ausgeführt und nicht nur zum Durchführen einer begrenzten Aufgabe gestartet wird. |
| BereitBeiProzessStartSetzen | Boolescher Wert | Erforderlich. Gibt an, ob die Rolleninstanz darauf wartet, dass das Befehlszeilenprogramm signalisiert, wann es startet. Dieser Wert muss hier auf true festgelegt werden. Das Festlegen des Werts auf false ist für die spätere Nutzung reserviert. |
Unternehmensgründung
Das Startup-Element beschreibt eine Sammlung mit Aufgaben, die ausgeführt werden, wenn die Rolle gestartet wird. Dieses Element kann das übergeordnete Element des Variable-Elements sein. Weitere Informationen zur Verwendung der Rollenstartaufgaben finden Sie unter Konfigurieren von Startaufgaben. Dieses Element ist optional, und eine Rolle kann nur einen Startblock haben.
In der folgenden Tabelle sind die Attribute des Startup-Elements beschrieben.
| Attribut | Typ | BESCHREIBUNG |
|---|---|---|
| Priorität | Int | Nur für die interne 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.
| Attribut | Typ | BESCHREIBUNG |
|---|---|---|
| Kommandozeile | Schnur | 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, die am Anfang der Datei einen Byte-Reihenfolgemarker setzen, verarbeiten sich nicht korrekt. |
| Ausführungskontext | Schnur | 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. |
| Aufgabentyp | Schnur | 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: Ähnlich wie im Hintergrund, aber die Funktion wird erst neugestartet, wenn alle Aufgaben im Vordergrund beendet sind. |
Inhalt
Das Contents-Element beschreibt die Inhaltssammlung einer Worker-Role. 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.
| Attribut | Typ | BESCHREIBUNG |
|---|---|---|
| Bestimmungsort | Schnur | 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.
| Attribut | Typ | BESCHREIBUNG |
|---|---|---|
| Pfad | Schnur | Erforderlich. Der relative oder absolute Pfad eines lokalen Verzeichnisses, dessen Inhalte auf den virtuellen Azure-Computer kopiert werden. Die Erweiterung von Umgebungsvariablen im Verzeichnispfad wird unterstützt. |