Azure Cloud Services (klassiek) configuratieschema (.cscfg-bestand)

  • Artikel

Belangrijk

Cloud Services (klassiek) is nu afgeschaft voor nieuwe klanten en wordt op 31 augustus 2024 voor alle klanten buiten gebruik gesteld. Nieuwe implementaties moeten gebruikmaken van het nieuwe op Azure Resource Manager gebaseerde implementatiemodel Azure Cloud Services (uitgebreide ondersteuning).

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

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

Standaard wordt het Azure Diagnostics configuratieschemabestand in de C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas map geïnstalleerd. Vervang door <version> 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:

Serviceconfiguratienaamruimte

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
Servicenaam Vereist. De naam van de cloudservice. De hier gegeven naam moet overeenkomen met de naam die is opgegeven in het servicedefinitiebestand.
osFamily Optioneel. Hiermee geeft u het gastbesturingssystemen op dat wordt uitgevoerd op rolinstanties in de cloudservice. Zie Azure Guest OS Releases and SDK Compatibility Matrix (Azure-gastbesturingssystemen en SDK-compatibiliteitsmatrix) voor informatie over ondersteunde releases van gastbesturingssystemen.

Als u geen waarde opneemt osFamily en u het osVersion kenmerk niet hebt ingesteld op een specifieke versie van het gastbesturingssystemen, wordt de standaardwaarde 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 van Azure voor meer informatie over versies van gastbesturingssystemen.

U kunt opgeven dat het gastbesturingssystemen automatisch moeten worden bijgewerkt naar de nieuwste versie. Stel hiervoor de waarde van het osVersion kenmerk in op *. Als dit is ingesteld op *, worden de rolinstanties geïmplementeerd met behulp van de nieuwste versie van het gastbesturingssysteem voor de opgegeven besturingssysteemfamilie en worden ze automatisch bijgewerkt wanneer nieuwe versies van het gastbesturingssysteem worden uitgebracht.

Als u handmatig een specifieke versie wilt opgeven, gebruikt u de Configuration String uit de tabel in de sectie Toekomstige, huidige en overgangsversies van gastbesturingssystemen van Azure releases en SDK-compatibiliteitsmatrix.

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

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