Поделиться через


Схема конфигурации (.cscfg файл) классических облачных служб Azure

Это важно

Облачные службы (классическая версия) теперь не поддерживается для всех пользователей с 1 сентября 2024 года. Все существующие запущенные развертывания будут остановлены и завершены корпорацией Майкрософт, и данные будут окончательно потеряны начиная с октября 2024 года. Для новых развертываний следует использовать Облачные службы Azure с расширенной поддержкой. Это новая модель развертывания на основе Azure Resource Manager.

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

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

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