Delen via

Definitieschema van Azure Cloud Services (klassiek) (.csdef-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 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 brengt configuratie-instellingen voor de service tot stand. Waarden voor configuratie-instellingen worden ingesteld in het configuratiebestand van de service, zoals beschreven in het configuratieschema van de cloudservice (klassiek).

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.

De standaardextensie voor het servicedefinitiebestand is .csdef.

Basisschema voor servicedefinities

Het servicedefinitiebestand moet één ServiceDefinition element bevatten. De servicedefinitie moet ten minste één rolelement (WebRole of WorkerRole) 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, waarmee wordt 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 wijzigingsmelding voor de topologie 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 afhandelen zonder opnieuw te worden opgestart.
- UpgradeDomainWalk – Verzendt de update op een opeenvolgende manier naar elk rolexemplaren nadat het vorige exemplaar de update heeft geaccepteerd.
schemaVersion Optioneel. Hiermee geeft u de versie van het servicedefinitieschema. 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.
upgradeDomainCount Optioneel. Hiermee geeft u het aantal upgradedomeinen op voor welke 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.