Azure Cloud Services (erweiterter Support) – Konfigurationsschema (CSCFG-Datei)

Artikel
06/01/2023

Die Dienstkonfigurationsdatei gibt die Anzahl der Rolleninstanzen, die für jede Rolle im Dienst bereitgestellt werden, die Werte aller Konfigurationseinstellungen und die Fingerabdrücke für alle einer Rolle zugeordneten Zertifikate an. Wenn der Dienst Teil eines virtuellen Netzwerks ist, müssen Konfigurationsinformationen für das Netzwerk in der Dienstkonfigurationsdatei sowie in der Konfigurationsdatei für virtuelle Netzwerke bereitgestellt werden. Die Standarderweiterung für die Dienstkonfigurationsdatei ist „cscfg“.

Das Dienstmodell wird durch das Definitionsschema von Cloud Service (erweiterter Support) 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.

Weitere Informationen zum Konfigurieren von Rollen in einem Dienst finden Sie unter What is the Cloud Service model (Was ist das Clouddienstmodell).

Grundlegendes Dienstkonfigurationsschema

Das grundlegende Format der Dienstkonfigurationsdatei sieht wie folgt aus.

<ServiceConfiguration serviceName="<service-name>" osFamily="<osfamily-number>" osVersion="<os-version>" schemaVersion="<schema-version>">

  <Role …>
    …
  </Role>

  <NetworkConfiguration>
    …
  </NetworkConfiguration>

</ServiceConfiguration>

Schemadefinitionen

Die folgenden Themen beschreiben das Schema für das Element ServiceConfiguration:

Dienstkonfigurations-Namespace

Der XML-Namespace für die Dienstkonfigurationsdatei lautet: http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceConfiguration.

ServiceConfiguration-Element

Das Element ServiceConfiguration ist das Element der obersten Ebene der Dienstkonfigurationsdatei.

In der folgenden Tabelle werden die Attribute des Elements ServiceConfiguration beschrieben. Alle Attributwerte sind Zeichenfolgentypen.

attribute	BESCHREIBUNG
serviceName	Erforderlich. Der Name des Clouddiensts. Der hier angegebene Name muss mit dem Namen in der Dienstdefinitionsdatei übereinstimmen.
osFamily	Optional. Gibt das Gastbetriebssystem an, das auf Rolleninstanzen im Clouddienst ausgeführt wird. Nähere Informationen zu unterstützten Gastbetriebssystem-Releases finden Sie unter Azure Gastbetriebssystem-Releases und SDK-Kompatibilitätsmatrix. Wenn Sie keinen `osFamily`-Wert einschließen, und wenn Sie das `osVersion`-Attribut nicht für eine bestimmte Gastbetriebssystem-Version festgelegt haben, wird ein Standardwert 1 verwendet.
osVersion	Optional. Gibt die Version des Gastbetriebssystems an, das auf Rolleninstanzen im Clouddienst ausgeführt wird. Nähere Informationen zu unterstützten Gastbetriebssystem-Versionen finden Sie unter Azure Gastbetriebssystem-Releases und SDK-Kompatibilitätsmatrix. Sie können angeben, dass das Gastbetriebssystem automatisch auf die neueste Version aktualisiert werden soll. Zu diesem Zweck legen Sie den Wert des `osVersion`-Attributs auf `` fest. Bei Festlegung auf `` werden die Rolleninstanzen mit der neuesten Version des Gastbetriebssystems für die angegebene Betriebssystemfamilie bereitgestellt und automatisch aktualisiert, wenn neue Versionen des Gastbetriebssystems freigegeben werden. Wenn Sie eine bestimmte Version manuell angeben möchten, verwenden Sie die `Configuration String` aus der Tabelle im Abschnitt Future, Current and Transitional Guest OS Versions (Zukünftige-, Aktuelle- und Übergangs- Gastversionen) der Azure Gastbetriebssystem-Releases und SDK-Kompatibilitätsmatrix. Der Standardwert für die `osVersion`-Eigenschaft ist `*`.
schemaVersion	Optional. Gibt die Version des Dienstkonfigurationsschemas 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. Nähere Informationen zu Schema- und Versionskompatibilität finden Sie unter Azure Gastbetriebssystem-Releases und SDK-Kompatibilitätsmatrix.

Die Dienstkonfigurationsdatei muss ein ServiceConfiguration-Element enthalten. Das ServiceConfiguration-Element kann eine beliebige Anzahl von Role-Elementen und 0 (null) oder 1 NetworkConfiguration-Elemente enthalten.

Siehe auch

Azure Cloud Services (erweiterter Support) – Definitionsschema (CSDEF-Datei)