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

Artikel
07/29/2024

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 und in der Konfigurationsdatei für virtuelle Netzwerke bereitgestellt werden. Die Standarderweiterung für die Dienstkonfigurationsdatei ist „cscfg“.

Das Definitionsschema von Cloud Service (erweiterter Support) beschreibt das Dienstmodell.

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 Artikel 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 auf eine bestimmte Gastbetriebssystem-Version festgelegt haben, wird der Standardwert 1 verwendet.
osVersion	Optional. Gibt die Version des Gastbetriebssystems an, die 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 der Einstellung `` werden die Rolleninstanzen mit der neuesten Version des Gastbetriebssystems für die angegebene Betriebssystemfamilie bereitgestellt und automatisch aktualisiert, wenn neue Versionen des Gastbetriebssystems veröffentlicht werden. Wenn Sie eine bestimmte Version manuell angeben möchten, verwenden Sie `Configuration String` aus der Tabelle im Abschnitt Gastbetriebssystemversionen – zukünftige, aktuelle und Übergangsversionen der Kompatibilitätsmatrix für Azure-Gastbetriebssystemreleases und SDK. 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.

Weitere Informationen

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

Freigeben über