Freigeben über

Azure Cloud Services (klassisch) – Konfigurationsschema (CSCFG-Datei)

  • Artikel

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 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 Virtual Network ist, müssen Konfigurationsinformationen für das Netzwerk in der Dienstkonfigurationsdatei und in der Konfigurationsdatei des virtuellen Netzwerks bereitgestellt werden. Die Standarderweiterung für die Dienstkonfigurationsdatei ist .cscfg.

Das Clouddienst (klassisch)-Definitionsschema beschreibt das Servicemodell.

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

Basic Service-Konfigurationsschema

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 auf eine bestimmte Gastbetriebssystemversion festgelegt haben, wird der 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. Wenn dies auf * festgelegt ist, werden die Rolleninstanzen mit der aktuellen Version des Gastbetriebssystems für die angegebene Betriebssystemfamilie bereitgestellt und automatisch aktualisiert, wenn neue Versionen des Gastbetriebssystems veröffentlicht werden.

Um eine bestimmte Version manuell anzugeben, verwenden Sie die Configuration String aus der Tabelle im Abschnitt Zukünftige, aktuelle und Übergangs-Gastbetriebssystemversionen der Matrix für Azure-Gastbetriebssystemreleases und SDK-Kompatibilität.

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.