Azure Cloud Services (klassisch): Definition des Schemas (CSDEF-Datei)

  • Artikel

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