Definitieschema van Azure Cloud Services (klassiek) (.csdef-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 implementatiemodel op basis van Azure Resource Manager Azure Cloud Services (uitgebreide ondersteuning).

Het servicedefinitiebestand definieert het servicemodel voor een toepassing. Het bestand bevat de definities voor de rollen die beschikbaar zijn voor een cloudservice, geeft de service-eindpunten op en stelt configuratie-instellingen voor de service in. Waarden voor configuratie-instellingen worden ingesteld in het serviceconfiguratiebestand, zoals beschreven in het configuratieschema 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.

De standaardextensie voor het servicedefinitiebestand is .csdef.

Basisschema voor servicedefinities

Het servicedefinitiebestand moet één ServiceDefinition element bevatten. De servicedefinitie moet ten minste één rol (WebRole of WorkerRole) element bevatten. Het kan maximaal 25 rollen bevatten die in één definitie zijn gedefinieerd en u kunt roltypen combineren. De servicedefinitie bevat ook het optionele NetworkTrafficRules element dat beperkt welke rollen kunnen communiceren met opgegeven interne eindpunten. De servicedefinitie bevat ook het optionele LoadBalancerProbes element dat door de klant gedefinieerde statustests van eindpunten bevat.

De basisindeling van het servicedefinitiebestand is als volgt.

<ServiceDefinition name="<service-name>" topologyChangeDiscovery="<change-type>" xmlns="http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceDefinition" upgradeDomainCount="<number-of-upgrade-domains>" schemaVersion="<version>">
  
  <LoadBalancerProbes>
         …
  </LoadBalancerProbes>
  
  <WebRole …>
         …
  </WebRole>
  
  <WorkerRole …>
         …
  </WorkerRole>
  
  <NetworkTrafficRules>
         …
  </NetworkTrafficRules>

</ServiceDefinition>

Schemadefinities

In de volgende onderwerpen wordt het schema beschreven:

ServiceDefinition-element

Het ServiceDefinition element is het element op het hoogste niveau van het servicedefinitiebestand.

In de volgende tabel worden de kenmerken van het ServiceDefinition element beschreven.

Kenmerk Beschrijving
naam Vereist. De naam van de service. De naam moet uniek zijn binnen het serviceaccount.
topologyChangeDiscovery Optioneel. Hiermee geeft u het type melding voor topologiewijzigingen op. Mogelijke waarden zijn:

- Blast - Verzendt de update zo snel mogelijk naar alle rolinstanties. Als u een optie kiest, moet de rol de topologie-update kunnen verwerken zonder opnieuw te worden opgestart.
- UpgradeDomainWalk : verzendt de update naar elk rolexemplaar op een sequentiële manier nadat het vorige exemplaar de update heeft geaccepteerd.
schemaVersion Optioneel. Hiermee geeft u de versie van het servicedefinitieschema 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.
upgradeDomainCount Optioneel. Hiermee geeft u het aantal upgradedomeinen waaraan rollen in deze service worden toegewezen. Rolinstanties worden toegewezen aan een upgradedomein wanneer de service wordt geïmplementeerd. Zie Een cloudservicerol of -implementatie bijwerken, De beschikbaarheid van virtuele machines beheren en Wat is een cloudservicemodel? voor meer informatie.

U kunt maximaal 20 upgradedomeinen opgeven. Als dit niet is opgegeven, is het standaardaantal upgradedomeinen 5.