Configuratie schema van Azure Cloud Services (uitgebreide ondersteuning) (cscfg-bestand)

Het configuratie bestand van de service specificeert het aantal rolinstanties dat moet worden geïmplementeerd voor elke rol in de service, de waarden van de configuratie-instellingen en de vinger afdrukken voor alle certificaten die aan een rol zijn gekoppeld. Als de service deel uitmaakt van een Virtual Network, moet de configuratie-informatie voor het netwerk worden verstrekt in het service configuratie bestand en in het configuratie bestand voor virtuele netwerken. De standaard extensie voor het service configuratie bestand is cscfg.

Het service model wordt beschreven in het definitie schema van Cloud service (Extended support).

Het Azure Diagnostics-configuratie schema bestand wordt standaard geïnstalleerd in de C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas map. Vervang door <version> de geïnstalleerde versie van de Azure SDK.

Zie Wat is het Cloud service modelvoor meer informatie over het configureren van rollen in een service.

Basis schema voor service configuratie

De basis indeling van het service configuratie bestand is als volgt.

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

  <Role …>
    …
  </Role>

  <NetworkConfiguration>
    …
  </NetworkConfiguration>

</ServiceConfiguration>

Schema definities

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

Service configuratie naam ruimte

De XML-naam ruimte voor het service configuratie bestand is: http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceConfiguration .

ServiceConfiguration-element

Het ServiceConfiguration element is het element op het hoogste niveau van het service configuratie bestand.

In de volgende tabel worden de kenmerken van het ServiceConfiguration element beschreven. Alle kenmerk waarden zijn teken reeks typen.

Kenmerk Beschrijving
serviceName Vereist. De naam van de Cloud service. De naam die u hier opgeeft, moet overeenkomen met de naam die is opgegeven in het service definitie bestand.
osFamily Optioneel. Hiermee geeft u het gast besturingssysteem op dat wordt uitgevoerd op rolinstanties in de Cloud service. Zie Azure Guest OS Releases and SDK Compatibility Matrix(Engelstalig) voor meer informatie over ondersteunde versies van gast besturingssystemen.

Als u geen osFamily waarde opgeeft en u het kenmerk niet hebt ingesteld osVersion op een specifieke versie van het gast besturingssysteem, wordt een standaard waarde van 1 gebruikt.
osVersion Optioneel. Hiermee geeft u de versie van het gast besturingssysteem op dat wordt uitgevoerd op rolinstanties in de Cloud service. Zie Azure Guest OS releases en SDK Compatibility Matrix(Engelstalig) voor meer informatie over de versies van het gast besturingssysteem.

U kunt opgeven dat het gast besturingssysteem automatisch moet worden bijgewerkt naar de nieuwste versie. Als u dit wilt doen, stelt u de waarde van het osVersion kenmerk in op * . Als deze functie is ingesteld op * , worden de rolinstanties geïmplementeerd met de nieuwste versie van het gast besturingssysteem voor de opgegeven besturingssysteem familie en worden deze automatisch bijgewerkt wanneer nieuwe versies van het gast besturingssysteem worden vrijgegeven.

Als u een specifieke versie hand matig wilt opgeven, gebruikt u de Configuration String sectie uit de tabel in de toekomst, huidig en voorlopig gast besturingssysteem versies van Azure Guest OS releases en SDK Compatibility Matrix.

De standaard waarde voor het osVersion kenmerk is * .
schemaVersion Optioneel. Hiermee geeft u de versie van het service configuratie schema op. Met de schema versie kan Visual Studio de juiste SDK-hulpprogram ma's selecteren die voor schema validatie moeten worden gebruikt als meer dan één versie van de SDK naast elkaar is geïnstalleerd. Zie Azure Guest OS Releases and SDK Compatibility Matrix (Engelstalig) voor meer informatie over schema-en versie compatibiliteit

Het service configuratie bestand moet één ServiceConfiguration element bevatten. Het ServiceConfiguration element kan een wille keurig aantal Role elementen en nul of 1 NetworkConfiguration elementen bevatten.

Zie ook

Definitie schema voor Azure Cloud Services (uitgebreide ondersteuning) (csdef-bestand)