Konfigurační schéma Azure Cloud Services (Classic) (soubor .cscfg)

  • Článek

Důležité

Cloud Services (classic) je teď pro nové zákazníky zastaralé a 31. srpna 2024 bude vyřazeno pro všechny zákazníky. Nová nasazení by měla používat nový model nasazení založený na Azure Resource Manager Azure Cloud Services (rozšířená podpora).

Konfigurační soubor služby určuje počet instancí rolí, které se mají nasadit pro každou roli ve službě, hodnoty všech nastavení konfigurace a kryptografické otisky pro všechny certifikáty přidružené k roli. Pokud je služba součástí Virtual Network, musí být informace o konfiguraci sítě uvedeny v konfiguračním souboru služby a také v konfiguračním souboru virtuální sítě. Výchozí přípona konfiguračního souboru služby je .cscfg.

Model služby je popsaný v cloudovém (klasickém) schématu definice.

Ve výchozím nastavení se do adresáře nainstaluje soubor schématu C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas konfigurace Azure Diagnostics. Nahraďte <version> nainstalovanou verzí sady Azure SDK.

Další informace o konfiguraci rolí ve službě najdete v tématu Co je model cloudové služby.

Základní schéma konfigurace služby

Základní formát konfiguračního souboru služby je následující.

<ServiceConfiguration serviceName="<service-name>" osFamily="<osfamily-number>" osVersion="<os-version>" schemaVersion="<schema-version>">

  <Role …>
    …
  </Role>

  <NetworkConfiguration>
    …
  </NetworkConfiguration>

</ServiceConfiguration>

Definice schématu

Následující témata popisují schéma elementu ServiceConfiguration :

Obor názvů konfigurace služby

Obor názvů XML pro konfigurační soubor služby je: http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceConfiguration.

ServiceConfiguration Element

Element ServiceConfiguration je element nejvyšší úrovně konfiguračního souboru služby.

Následující tabulka popisuje atributy elementu ServiceConfiguration . Všechny hodnoty atributů jsou typy řetězců.

Atribut Popis
Název_služby Povinná hodnota. Název cloudové služby. Zde zadaný název se musí shodovat s názvem zadaným v definičním souboru služby.
osFamily Nepovinný parametr. Určuje hostovaný operační systém, který se spustí v instancích rolí v cloudové službě. Informace o podporovaných verzích hostovaných operačních systému najdete v tématu Verze hostovaného operačního systému Azure a Matice kompatibility sady SDK.

Pokud nezadáte osFamily hodnotu a nenastavili osVersion jste atribut na konkrétní verzi hostovaného operačního systému, použije se výchozí hodnota 1.
osVersion Nepovinný parametr. Určuje verzi hostovaného operačního systému, která se spustí v instancích rolí v cloudové službě. Další informace o verzích hostovaných operačních systémů najdete v tématu Verze hostovaného operačního systému Azure a Matice kompatibility sady SDK.

Můžete určit, že hostovaný operační systém se má automaticky upgradovat na nejnovější verzi. Uděláte to tak, že nastavíte hodnotu atributu osVersion na *. Pokud je nastavená hodnota *, instance rolí se nasadí pomocí nejnovější verze hostovaného operačního systému pro zadanou řadu operačních systémů a při vydání nových verzí hostovaného operačního systému se automaticky upgradují.

Pokud chcete zadat konkrétní verzi ručně, použijte v matici Configuration Stringkompatibility sady SDK a vydání hostovaného operačního systému z tabulky v části Budoucí aktuální a přechodné verze hostovaného operačního systému.

Výchozí hodnota atributu osVersion je *.
schemaVersion Nepovinný parametr. Určuje verzi schématu konfigurace služby. Verze schématu umožňuje sadě Visual Studio vybrat správné nástroje sady SDK, které se mají použít k ověření schématu, pokud je souběžně nainstalovaná více než jedna verze sady SDK. Další informace o kompatibilitě schématu a verzí najdete v tématu Verze hostovaného operačního systému Azure a Matice kompatibility sady SDK.

Konfigurační soubor služby musí obsahovat jeden ServiceConfiguration prvek. Element ServiceConfiguration může obsahovat libovolný počet Role prvků a nula nebo 1 NetworkConfiguration elementů.