Delen via

Configuratieschema van Azure Cloud Services (klassiek) (.cscfg-bestand)

  • Artikel

Belangrijk

Cloud Services (klassiek) is vanaf 1 september 2024 afgeschaft voor alle klanten. Bestaande actieve implementaties worden gestopt en afgesloten door Microsoft en de gegevens gaan vanaf oktober 2024 permanant verloren. Nieuwe implementaties moeten gebruikmaken van het nieuwe op Azure Resource Manager gebaseerde implementatiemodel Azure Cloud Services (uitgebreide ondersteuning).

Het serviceconfiguratiebestand geeft het aantal rolinstanties op dat moet worden geïmplementeerd voor elke rol in de service, de waarden van configuratie-instellingen en de vingerafdrukken voor certificaten die zijn gekoppeld aan een rol. Als de service deel uitmaakt van een virtueel netwerk, moeten configuratiegegevens voor het netwerk worden opgegeven in het serviceconfiguratiebestand en het configuratiebestand voor virtuele netwerken. De standaardextensie voor het serviceconfiguratiebestand is .cscfg.

In het definitieschema van de cloudservice (klassiek) wordt het servicemodel beschreven.

Standaard wordt het configuratieschemabestand van Azure Diagnostics geïnstalleerd in de C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas map. Vervang <version> door de geïnstalleerde versie van de Azure SDK.

Zie Wat is het cloudservicemodel voor meer informatie over het configureren van rollen in een service.

Basisserviceconfiguratieschema

De basisindeling van het serviceconfiguratiebestand is als volgt.

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

  <Role …>
    …
  </Role>

  <NetworkConfiguration>
    …
  </NetworkConfiguration>

</ServiceConfiguration>

Schemadefinities

In de volgende onderwerpen wordt het schema voor het ServiceConfiguration element beschreven:

Naamruimte voor serviceconfiguratie

De XML-naamruimte voor het serviceconfiguratiebestand is: http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceConfiguration.

ServiceConfiguration-element

Het ServiceConfiguration element is het element op het hoogste niveau van het serviceconfiguratiebestand.

In de volgende tabel worden de kenmerken van het ServiceConfiguration element beschreven. Alle kenmerkwaarden zijn tekenreekstypen.

Kenmerk Beschrijving
serviceName Vereist. De naam van de cloudservice. De hier opgegeven naam moet overeenkomen met de naam die is opgegeven in het servicedefinitiebestand.
osFamily Optioneel. Hiermee geeft u het gastbesturingssystemen op die worden uitgevoerd op rolinstanties in de cloudservice. Zie voor meer informatie over ondersteunde gastbesturingssystemen versies azure-gastbesturingssystemen en SDK-compatibiliteitsmatrix.

Als u geen waarde opneemt osFamily en u het osVersion kenmerk niet hebt ingesteld op een specifieke versie van het gastbesturingssystem, wordt een standaardwaarde van 1 gebruikt.
osVersion Optioneel. Hiermee geeft u de versie van het gastbesturingssystemen op die wordt uitgevoerd op rolinstanties in de cloudservice. Zie Releases van Gastbesturingssystemen en SDK-compatibiliteitsmatrix voor meer informatie over gastbesturingssystemen.

U kunt opgeven dat het gastbesturingssystemen automatisch moeten worden bijgewerkt naar de nieuwste versie. Hiervoor stelt u de waarde van het osVersion kenmerk in op *. Wanneer deze optie is ingesteld *, worden de rolinstanties geïmplementeerd met behulp van de nieuwste versie van het gastbesturingssystemen voor de opgegeven besturingssysteemfamilie en worden deze automatisch bijgewerkt wanneer nieuwe versies van het gastbesturingssystemen worden uitgebracht.

Als u handmatig een specifieke versie wilt opgeven, gebruikt u de Configuration String tabel in de sectie Toekomstige, Huidige en Overgangsversies van gastbesturingssystemen van Azure Gastbesturingssystemen en SDK-compatibiliteitsmatrix.

De standaardwaarde voor het osVersion kenmerk is *.
schemaVersion Optioneel. Hiermee geeft u de versie van het serviceconfiguratieschema. Met de schemaversie kan Visual Studio de juiste SDK-hulpprogramma's selecteren die moeten worden gebruikt voor schemavalidatie als meer dan één versie van de SDK naast elkaar is geïnstalleerd. Zie Voor meer informatie over schema- en versiecompatibiliteit azure-gastbesturingssystemen en SDK-compatibiliteitsmatrix

Het serviceconfiguratiebestand moet één ServiceConfiguration element bevatten. Het ServiceConfiguration element kan een willekeurig aantal Role elementen en nul of 1 NetworkConfiguration elementen bevatten.