Schemat konfiguracji usług Azure Cloud Services (wsparcie dodatkowe) (plik cscfg)

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, a także w pliku konfiguracji sieci wirtualnej. Domyślnym rozszerzeniem pliku konfiguracji usługi jest cscfg.

Model usługi jest opisany przez schemat definicji usługi w chmurze (wsparcie rozszerzone).

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 Wymagane. 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, który będzie 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, która będzie działać 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 roli są wdrażane przy użyciu najnowszej wersji systemu operacyjnego gościa dla określonej rodziny systemów operacyjnych i zostaną automatycznie uaktualnione 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.

Zobacz też

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