Schemat definicji usługi Azure Cloud Services (wersja klasyczna) (plik csdef)

Ważne

Cloud Services (wersja klasyczna) jest teraz przestarzała dla nowych klientów i zostanie wycofana 31 sierpnia 2024 r. dla wszystkich klientów. Nowe wdrożenia powinny używać nowego modelu wdrażania opartego na usłudze Azure Resource Manager Azure Cloud Services (wsparcie dodatkowe).

Plik definicji usługi definiuje model usługi dla aplikacji. Plik zawiera definicje ról dostępnych dla usługi w chmurze, określa punkty końcowe usługi i ustanawia ustawienia konfiguracji dla usługi. Wartości ustawień konfiguracji są ustawiane w pliku konfiguracji usługi zgodnie z opisem w schemacie konfiguracji usługi w chmurze (wersja klasyczna).

Domyślnie plik schematu konfiguracji Diagnostyka Azure jest instalowany w C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas katalogu. Zastąp <version> element zainstalowaną wersją zestawu Azure SDK.

Domyślnym rozszerzeniem pliku definicji usługi jest .csdef.

Podstawowy schemat definicji usługi

Plik definicji usługi musi zawierać jeden ServiceDefinition element. Definicja usługi musi zawierać co najmniej jedną rolę (WebRole lub WorkerRole) element. Może zawierać maksymalnie 25 ról zdefiniowanych w jednej definicji i można mieszać typy ról. Definicja usługi zawiera również opcjonalny NetworkTrafficRules element, który ogranicza, które role mogą komunikować się z określonymi wewnętrznymi punktami końcowymi. Definicja usługi zawiera również opcjonalny LoadBalancerProbes element, który zawiera zdefiniowane przez klienta sondy kondycji punktów końcowych.

Podstawowy format pliku definicji usługi jest następujący.

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

Definicje schematu

W poniższych tematach opisano schemat:

ServiceDefinition, element

Element ServiceDefinition jest elementem najwyższego poziomu pliku definicji usługi.

W poniższej tabeli opisano atrybuty ServiceDefinition elementu.

Atrybut Opis
name Wymagane. Nazwa usługi. Nazwa musi być unikatowa w ramach konta usługi.
topologiaChangeDiscovery Opcjonalny. Określa typ powiadomienia o zmianie topologii. Możliwe wartości:

- Blast — Wysyła aktualizację tak szybko, jak to możliwe do wszystkich wystąpień roli. Jeśli wybierzesz opcję, rola powinna być w stanie obsłużyć aktualizację topologii bez ponownego uruchamiania.
- UpgradeDomainWalk — wysyła aktualizację do każdego wystąpienia roli w sposób sekwencyjny po pomyślnym zaakceptowaniu aktualizacji przez poprzednie wystąpienie.
schemaVersion Opcjonalny. Określa wersję schematu definicji usługi. Wersja schematu umożliwia programowi Visual Studio wybranie odpowiednich narzędzi zestawu SDK do użycia na potrzeby weryfikacji schematu, jeśli zainstalowano więcej niż jedną wersję zestawu SDK obok siebie.
upgradeDomainCount Opcjonalny. Określa liczbę domen uaktualniania, w których są przydzielane role w tej usłudze. Wystąpienia ról są przydzielane do domeny uaktualniania po wdrożeniu usługi. Aby uzyskać więcej informacji, zobacz Aktualizowanie roli lub wdrożenia usługi w chmurze, Zarządzanie dostępnością maszyn wirtualnych i Co to jest model usługi w chmurze.

Można określić maksymalnie 20 domen uaktualnienia. Jeśli nie zostanie określony, domyślna liczba domen uaktualnienia wynosi 5.