Dela via

Definitionsschema för Azure Cloud Services (klassisk) (.csdef-fil)

  • Artikel

Viktigt!

Cloud Services (klassisk) är nu inaktuellt för alla kunder från och med den 1 september 2024. Alla befintliga distributioner som körs stoppas och stängs av av Microsoft och data kommer att förloras kontinuerligt från och med oktober 2024. Nya distributioner bör använda den nya Azure Resource Manager-baserade distributionsmodellen Azure Cloud Services (utökad support).

Tjänstdefinitionsfilen definierar tjänstmodellen för ett program. Filen innehåller definitionerna för de roller som är tillgängliga för en molntjänst, anger tjänstslutpunkterna och upprättar konfigurationsinställningar för tjänsten. Konfigurationsinställningsvärden anges i tjänstkonfigurationsfilen enligt beskrivningen i konfigurationsschemat för molntjänsten (klassisk).

Som standard installeras azure Diagnostics-konfigurationsschemafilen i C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas katalogen. Ersätt <version> med den installerade versionen av Azure SDK.

Standardtillägget för tjänstdefinitionsfilen är .csdef.

Grundläggande tjänstdefinitionsschema

Tjänstdefinitionsfilen måste innehålla ett ServiceDefinition element. Tjänstdefinitionen måste innehålla minst en roll (WebRole eller WorkerRole) element. Den kan innehålla upp till 25 roller som definierats i en enda definition och du kan blanda rolltyper. Tjänstdefinitionen innehåller också det valfria NetworkTrafficRules elementet, vilket begränsar vilka roller som kan kommunicera med angivna interna slutpunkter. Tjänstdefinitionen innehåller också det valfria LoadBalancerProbes elementet, som innehåller kunddefinierade hälsoavsökningar för slutpunkter.

Det grundläggande formatet för tjänstdefinitionsfilen är följande.

<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>

Schemadefinitioner

Följande avsnitt beskriver schemat:

ServiceDefinition-element

Elementet ServiceDefinition är det översta elementet i tjänstdefinitionsfilen.

I följande tabell beskrivs elementets ServiceDefinition attribut.

Attribut Beskrivning
name Obligatoriska. Namnet på tjänsten. Namnet måste vara unikt i tjänstkontot.
topologiChangeDiscovery Valfritt. Anger typ av meddelande om ändring av topologi. Möjliga värden är:

- Blast – Skickar uppdateringen så snart som möjligt till alla rollinstanser. Om du väljer alternativet bör rollen kunna hantera topologiuppdateringen utan att startas om.
- UpgradeDomainWalk – Skickar uppdateringen till varje rollinstans på ett sekventiellt sätt efter att den tidigare instansen har godkänt uppdateringen.
schemaVersion Valfritt. Anger versionen av tjänstdefinitionsschemat. Med schemaversionen kan Visual Studio välja rätt SDK-verktyg som ska användas för schemavalidering om mer än en version av SDK:t installeras sida vid sida.
upgradeDomainCount Valfritt. Anger antalet uppgraderingsdomäner för vilka roller i den här tjänsten tilldelas. Rollinstanser allokeras till en uppgraderingsdomän när tjänsten distribueras. Mer information finns i Uppdatera en molntjänstroll eller distribution, Hantera tillgängligheten för virtuella datorer och Vad är en molntjänstmodell.

Du kan ange upp till 20 uppgraderingsdomäner. Om det inte anges är standardantalet uppgraderingsdomäner 5.