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

Файл конфигурации службы определяет число экземпляров роли, которые развертываются для каждой роли в службе, значения всех параметров конфигурации и отпечатки всех сертификатов, связанных с ролью. Если служба является частью виртуальная сеть, сведения о конфигурации сети должны быть предоставлены в файле конфигурации службы и файле конфигурации виртуальной сети. По умолчанию для файла конфигурации службы используется расширение .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 (расширенная поддержка)