Schemat definicji usług Azure Cloud Services (klasyczny) (plik csdef)
Ważne
Usługi Cloud Services (wersja klasyczna) są teraz przestarzałe dla wszystkich klientów od 1 września 2024 r. Wszystkie istniejące uruchomione wdrożenia zostaną zatrzymane i zamknięte przez firmę Microsoft, a dane zostaną trwale utracone od października 2024 r. Nowe wdrożenia powinny używać nowego modelu wdrażania opartego na usłudze Azure Resource Manager w usługach Azure Cloud Services (wsparcie dodatkowe).
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 (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 | Wymagany. Nazwa usługi. Nazwa musi być unikatowa w ramach konta usługi. |
| topologiaChangeDiscovery | Opcjonalny. Określa typ powiadomienia o zmianie topologii. Dopuszczalne 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 podczas wdrażania usługi. Aby uzyskać więcej informacji, zobacz Aktualizowanie roli lub wdrażania 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ślona, domyślna liczba domen uaktualnienia wynosi 5. |