Schemat konfiguracji usług Azure Cloud Services (wersja klasyczna) (plik cscfg)
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 konfiguracji usługi określa liczbę wystąpień ról do wdrożenia dla każdej roli w usłudze, wartości jakichkolwiek ustawień konfiguracji i odcisków palca dla wszystkich certyfikatów skojarzonych z rolą. Jeśli usługa jest częścią sieci wirtualnej, informacje o konfiguracji sieci muszą być podane w pliku konfiguracji usługi i pliku konfiguracji sieci wirtualnej. Domyślnym rozszerzeniem pliku konfiguracji usługi jest .cscfg.
Schemat definicji usługi w chmurze (klasyczny) opisuje model usługi.
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.
Aby uzyskać więcej informacji na temat konfigurowania ról w usłudze, zobacz Co to jest model usługi w chmurze.
Podstawowy schemat konfiguracji usługi
Podstawowy format pliku konfiguracji usługi jest następujący.
<ServiceConfiguration serviceName="<service-name>" osFamily="<osfamily-number>" osVersion="<os-version>" schemaVersion="<schema-version>">
<Role …>
…
</Role>
<NetworkConfiguration>
…
</NetworkConfiguration>
</ServiceConfiguration>
Definicje schematu
W poniższych tematach opisano schemat elementu ServiceConfiguration
:
Przestrzeń nazw konfiguracji usługi
Przestrzeń nazw XML pliku konfiguracji usługi to: http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceConfiguration
.
ServiceConfiguration, element
Element ServiceConfiguration
jest elementem najwyższego poziomu pliku konfiguracji usługi.
W poniższej tabeli opisano atrybuty ServiceConfiguration
elementu. Wszystkie wartości atrybutów to typy ciągów.
Atrybut | opis |
---|---|
serviceName | Wymagany. Nazwa usługi w chmurze. Nazwa podana tutaj musi być zgodna z nazwą określoną w pliku definicji usługi. |
osFamily | Opcjonalny. Określa system operacyjny gościa uruchamiany w wystąpieniach ról w usłudze w chmurze. Aby uzyskać informacje o obsługiwanych wersjach systemu operacyjnego gościa, zobacz Azure Guest OS Releases and SDK Compatibility Matrix (Wersje systemu operacyjnego gościa platformy Azure i macierz zgodności zestawu SDK). Jeśli nie dołączysz osFamily wartości i nie ustawiono atrybutu osVersion na określoną wersję systemu operacyjnego gościa, zostanie użyta wartość domyślna 1. |
osVersion | Opcjonalny. Określa wersję systemu operacyjnego gościa uruchomionego w wystąpieniach ról w usłudze w chmurze. Aby uzyskać więcej informacji na temat wersji systemu operacyjnego gościa, zobacz Azure Guest OS Releases and SDK Compatibility Matrix (Wersje systemu operacyjnego gościa platformy Azure i macierz zgodności zestawu SDK). Można określić, że system operacyjny gościa powinien zostać automatycznie uaktualniony do najnowszej wersji. W tym celu ustaw wartość atrybutu osVersion na * . W przypadku ustawienia wartości * wystąpienia ról są wdrażane przy użyciu najnowszej wersji systemu operacyjnego gościa dla określonej rodziny systemów operacyjnych i automatycznie uaktualnia się po wydaniu nowych wersji systemu operacyjnego gościa.Aby ręcznie określić określoną wersję, użyj Configuration String tabeli z tabeli w sekcji Przyszłe, Bieżące i Przejściowe wersje systemu operacyjnego gościa w temacie Wersje systemu operacyjnego gościa platformy Azure i macierz zgodności zestawu SDK.Wartość domyślna atrybutu osVersion to * . |
schemaVersion | Opcjonalny. Określa wersję schematu konfiguracji 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. Aby uzyskać więcej informacji na temat zgodności schematu i wersji, zobacz Azure Guest OS Releases and SDK Compatibility Matrix (Wersje systemu operacyjnego gościa platformy Azure i macierz zgodności zestawu SDK) |
Plik konfiguracji usługi musi zawierać jeden ServiceConfiguration
element. Element ServiceConfiguration
może zawierać dowolną liczbę Role
elementów i zero lub 1 NetworkConfiguration
elementy.