Udostępnij przez


Schemat definicji usługi Azure Cloud Services (wsparcie dodatkowe) (plik csdef)

Ważne

Od 31 marca 2025 r. usługi w chmurze (wsparcie dodatkowe) są przestarzałe i zostaną w pełni wycofane 31 marca 2027 r. Dowiedz się więcej o tej deprecjacji i migracji.

Plik definicji usługi definiuje model usługi dla aplikacji. Plik zawiera definicje ról, które są dostępne 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 (rozszerzonej pomocy technicznej).

Domyślnie plik schematu konfiguracji Azure Diagnostics jest instalowany w katalogu C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas. Zastąp <version> zainstalowaną wersją 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 jeden element roli (WebRole lub WorkerRole). 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 element LoadBalancerProbes, który obejmuje zdefiniowane przez klienta testy zdrowia 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 artykułach opisano schemat:

element ServiceDefinition

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

W poniższej tabeli opisano atrybuty ServiceDefinition elementu.

Atrybut Opis
imię Wymagany. Nazwa usługi. Nazwa musi być unikatowa w ramach konta usługi.
wykrywanieZmianTopologii Opcjonalny. Określa typ powiadomienia o zmianie topologii. Dopuszczalne wartości:

- Blast — Wysyła tak szybko, jak to możliwe aktualizację 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 kolejno, po tym jak poprzednie wystąpienie pomyślnie zaakceptuje aktualizację.
wersja schematu 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.
zaktualizujLiczbęDomen Opcjonalny. Określa liczbę domen aktualizacji, na które są przypisane role w tej usłudze. Wystąpienia ról są przydzielane do domeny aktualizacji podczas wdrażania usługi. Więcej informacji można znaleźć w Aktualizowanie roli usługi w chmurze lub wdrożenia i Zarządzanie dostępnością maszyn wirtualnych. Można określić maksymalnie 20 domen uaktualnienia. Jeśli nie zostanie określona, domyślna liczba domen uaktualnienia wynosi 5.

Zobacz też

Schemat konfiguracji usług Azure Cloud Services (rozszerzona obsługa) (plik cscfg).