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

Это важно

По состоянию на 31 марта 2025 г. облачные службы (расширенная поддержка) устарели и будут полностью прекращены 31 марта 2027 г. Узнайте больше об этом отказе и о том, как осуществить миграцию.

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

Атрибут Описание
название сервиса Обязательный. Имя облачной службы. Указанное здесь имя должно соответствовать имени, указанному в файле определения службы.
osFamily Необязательно. Указывает гостевую ОС, которая выполняется на экземплярах ролей в облачной службе. Информацию о поддерживаемых выпусках гостевой ОС вы найдете в таблице совместимости выпусков гостевых ОС Azure и пакетов SDK.

Если вы не включаете osFamily значение и не задаете osVersion атрибут определенной версии гостевой ОС, используется значение по умолчанию 1.
Версия ОС Необязательно. Указывает версию гостевой ОС, которая выполняется на экземплярах ролей в облачной службе. Дополнительную информацию о версиях гостевой ОС вы найдете в таблице совместимости выпусков гостевых ОС Azure и пакетов SDK.

Вы можете настроить автоматическое обновление гостевой ОС до последней версии. Для этого присвойте атрибуту osVersion значение *. Если задано значение *, экземпляры ролей развертываются с помощью последней версии гостевой ОС для указанного семейства ОС и автоматически обновляются при выпуске новых версий гостевой ОС.

Чтобы вручную указать определенную версию, используйте Configuration String из таблицы в разделе «Будущие, текущие и переходные версии гостевой ОС» в «Выпуски Azure Guest OS и матрица совместимости пакета SDK».

Для атрибута osVersion по умолчанию используется значение *.
schemaVersion Необязательно. Указывает версию схемы конфигурации службы. Версия схемы позволяет Visual Studio выбрать правильные средства пакета SDK для использования при проверке схемы, если установлено одновременно несколько версий пакета SDK. Дополнительную информацию о схеме и совместимости версий вы найдете в таблице совместимости выпусков гостевых ОС Azure и пакетов SDK.

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

См. также

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

  • Last updated on