Freigeben über

Azure Cloud Services (klassisch) – Konfigurationsschema (CSCFG-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 sind ab Oktober 2024 dauerhaft verloren. Neue Bereitstellungen sollten das neue azure Resource Manager-basierte Bereitstellungsmodell Azure Cloud Services (erweiterter Support) verwenden.

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 Definitionsschema des Clouddiensts (klassisch) beschreibt das Dienstmodell.

Die Konfigurationsschemadatei für die Azure-Diagnose wird standardmäßig im Verzeichnis C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas 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".

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.

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

Attribut BESCHREIBUNG
Dienstname Erforderlich. Der Name des Clouddiensts. Der hier angegebene Name muss mit dem Namen in der Dienstdefinitionsdatei übereinstimmen.
osFamily Wahlfrei. Gibt das Gastbetriebssystem an, das auf Rolleninstanzen im Clouddienst ausgeführt wird. Informationen zu unterstützten Gastbetriebssystemversionen finden Sie unter Azure Guest OS Releases and SDK Compatibility Matrix.

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 Wahlfrei. Gibt die Version des Gastbetriebssystems an, das auf Rolleninstanzen im Clouddienst ausgeführt wird. Weitere Informationen zu Gastbetriebssystemversionen finden Sie unter Azure Guest OS Releases and SDK Compatibility Matrix.

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.

Wenn Sie eine bestimmte Version manuell angeben möchten, verwenden Sie die Configuration String aus der Tabelle im Abschnitt Future, Current und Transitional Guest OS Versions von Azure Guest OS Releases und SDK Compatibility Matrix.

Der Standardwert für die osVersion-Eigenschaft ist *.
schemaVersion Wahlfrei. 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. Weitere Informationen zur Schema- und Versionskompatibilität finden Sie unter Azure-Gastbetriebssystemversionen 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.

  • Last updated on