Схема конфигурации (файл CSCFG) Облачных служб Azure (расширенная поддержка)

Статья
06/01/2023

Файл конфигурации службы определяет число экземпляров роли, которые развертываются для каждой роли в службе, значения всех параметров конфигурации и отпечатки всех сертификатов, связанных с ролью. Если служба является частью виртуальной сети, нужно указать сведения о конфигурации сети в файле конфигурации службы и в файле конфигурации виртуальной сети. По умолчанию для файла конфигурации службы используется расширение .cscfg.

Модель службы описывается в схеме определения Облачной службы (расширенная поддержка).

По умолчанию файл схемы конфигурации системы диагностики Azure устанавливается в каталог C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas. Замените <version> установленной версией пакета SDK для Azure.

Дополнительные сведения о настройке ролей для службы см. в статье Что такое модель облачных служб и как создать ее пакет?

Базовая схема конфигурации службы

Ниже приводится базовый формат файла конфигурации службы.

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

  <Role …>
    …
  </Role>

  <NetworkConfiguration>
    …
  </NetworkConfiguration>

</ServiceConfiguration>

Определения схем

В следующих статьях описаны схемы для элемента ServiceConfiguration:

Пространство имен для конфигурации службы

Для файла конфигурации диагностики используется пространство имен XML http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceConfiguration.

Элемент ServiceConfiguration

Элемент ServiceConfiguration занимает верхний уровень в файле конфигурации службы.

В таблице ниже описаны атрибуты элемента ServiceConfiguration. Значения всех атрибутов имеют строковый тип.

Атрибут	Description
serviceName	Обязательно. Имя облачной службы. Указанное здесь имя должно соответствовать имени, указанному в файле определения службы.
osFamily	Необязательно. Определяет гостевую ОС, которая будет запускаться на экземплярах ролей в Облачной службе. Информацию о поддерживаемых выпусках гостевой ОС вы найдете в таблице совместимости выпусков гостевых ОС Azure и пакетов SDK. Если вы не включите значение `osFamily` и не укажете конкретную версию гостевой ОС через атрибут `osVersion`, по умолчанию используется значение 1.
osVersion	Необязательно. Определяет версию гостевой ОС, которая будет запускаться на экземплярах ролей в Облачной службе. Дополнительную информацию о версиях гостевой ОС вы найдете в таблице совместимости выпусков гостевых ОС Azure и пакетов SDK. Вы можете настроить автоматическое обновление гостевой ОС до последней версии. Для этого присвойте атрибуту `osVersion` значение ``. Если задано значение ``, экземпляры роли развертываются с последней версией гостевой ОС из указанного семейства ОС, и эти версии автоматически обновляются при выходе новых версий гостевой ОС. Чтобы вручную указать конкретную версию, используйте `Configuration String` (строку конфигурации) из раздела о будущих, текущих и переходных версиях гостевой ОС в таблице совместимости выпусков гостевых ОС Azure и пакетов SDK. Для атрибута `osVersion` по умолчанию используется значение `*`.
schemaVersion	Необязательно. Указывает версию схемы конфигурации службы. Версия схемы позволяет Visual Studio выбрать правильные средства пакета SDK для использования при проверке схемы, если установлено одновременно несколько версий пакета SDK. Дополнительную информацию о схеме и совместимости версий вы найдете в таблице совместимости выпусков гостевых ОС Azure и пакетов SDK.

Файл конфигурации службы должен содержать один элемент ServiceConfiguration. Элемент ServiceConfiguration может содержать любое количество элементов Role и не более одного элемента NetworkConfiguration.

См. также

Схема определения (файл CSDEF) Облачных служб Azure (расширенная поддержка)

Share via