Azure Cloud Services (klassisch): Definition des Schemas (CSDEF-Datei)
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 gehen ab Oktober 2024 dauerhaft verloren. In neuen Bereitstellungen sollte das neue auf Azure Resource Manager basierende Bereitstellungsmodell für Azure Cloud Services (erweiterter Support) verwendet werden.
Die Dienstdefinitionsdatei definiert das Dienstmodell für eine Anwendung. Die Datei enthält die Definitionen für die Rollen, die für einen Clouddienst verfügbar sind, gibt die Anbieterendpunkte an und legt Konfigurationseinstellungen für den Dienst fest. Konfigurationseinstellungswerte werden in der Dienstkonfigurationsdatei festgelegt, wie im Clouddienst-Konfigurationsschema (klassisch) beschrieben.
Standardmäßig wird die Konfigurationsschemadatei der Azure-Diagnose im C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas-Verzeichnis installiert. Ersetzen Sie <version> durch die installierte Version des Azure SDK.
Die Standarderweiterung für die Dienstdefinitionsdatei lautet „.csdef“.
Basisdienstdefinitionsschema
Die Dienstdefinitionsdatei muss ein ServiceDefinition-Element enthalten. Die Dienstdefinition muss mindestens ein Rollenelement enthalten (WebRole oder WorkerRole). Sie kann bis zu 25 Rollen enthalten, die in einer Definition definiert sind. Rollentypen können miteinander kombiniert werden. Zudem enthält die Dienstdefinition das optionale Element NetworkTrafficRules, mit dem eingeschränkt werden kann, welche Rollen mit angegebenen internen Endpunkten kommunizieren können. Die Dienstdefinition enthält auch das optionale Element LoadBalancerProbes, das vom Kunden definierte Integritätstests von Endpunkten enthält.
Das Standardformat der Dienstdefinitionsdatei sieht wie folgt aus.
<ServiceDefinition name="<service-name>" topologyChangeDiscovery="<change-type>" xmlns="http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceDefinition" upgradeDomainCount="<number-of-upgrade-domains>" schemaVersion="<version>">
<LoadBalancerProbes>
…
</LoadBalancerProbes>
<WebRole …>
…
</WebRole>
<WorkerRole …>
…
</WorkerRole>
<NetworkTrafficRules>
…
</NetworkTrafficRules>
</ServiceDefinition>
Schemadefinitionen
In den folgenden Themen wird das Schema beschrieben:
ServiceDefinition-Element
Das Element ServiceDefinition ist das Element der obersten Ebene der Dienstdefinitionsdatei.
In der folgenden Tabelle werden die Attribute des Elements ServiceDefinition beschrieben.
| attribute | Beschreibung |
|---|---|
| name | Erforderlich. Der Name des Diensts. Der Name muss innerhalb des Dienstkontos eindeutig sein. |
| topologyChangeDiscovery | Optional. Gibt die Änderungsbenachrichtigung zur Art der Topologie an. Mögliche Werte: - Blast: Sendet das Update so schnell wie möglich an alle Rolleninstanzen. Wenn Sie die Option auswählen, sollte die Rolle das Topologieupdate verarbeiten können, ohne neu gestartet werden zu müssen.- UpgradeDomainWalk: Sendet das Update sequenziell an alle Rolleninstanzen, nachdem die vorherige Instanz das Update erfolgreich akzeptiert hat. |
| schemaVersion | Optional. Gibt die Version des Dienstdefinitionsschemas an. Die Schemaversion ermöglicht Visual Studio, die richtigen SDK-Tools für die Schemaüberprüfung auszuwählen, wenn mehrere Versionen des SDK nebeneinander installiert sind. |
| upgradeDomainCount | Optional. Gibt die Anzahl von Upgradedomänen an, über die die Rollen in diesem Dienst zugeordnet werden. Rolleninstanzen werden bei der Bereitstellung des Diensts einer Upgradedomäne zugeordnet. Weitere Informationen finden Sie unter Aktualisieren einer Clouddienstrolle oder -bereitstellung, Verwalten der Verfügbarkeit virtueller Windows-Computer in Azure und Was ist das Clouddienstmodell, und wie kann es gepackt werden?. Sie können bis zu 20 Upgradedomänen angeben. Bei fehlender Angabe wird der Standardwert in Höhe von 5 Upgradedomänen verwendet. |