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

Это важно

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

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

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

По умолчанию определения службы хранятся в файле с расширением .csdef.

Базовая схема определения службы

Файл определения службы должен содержать один элемент ServiceDefinition. Определение службы должно содержать как минимум один элемент роли (WebRole или WorkerRole). В одном определении могут содержаться до 25 ролей. Также вы можете смешивать типы ролей. Определение службы также содержит необязательный NetworkTrafficRules элемент, который ограничивает, какие роли могут взаимодействовать с указанными внутренними конечными точками. Определение службы также содержит необязательный элемент LoadBalancerProbes, который включает проверки работоспособности конечных точек, определяемые клиентом.

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

<ServiceDefinition name="<service-name>" topologyChangeDiscovery="<change-type>" xmlns="http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceDefinition" upgradeDomainCount="<number-of-upgrade-domains>" schemaVersion="<version>">
  
  <LoadBalancerProbes>
         …
  </LoadBalancerProbes>
  
  <WebRole …>
         …
  </WebRole>
  
  <WorkerRole …>
         …
  </WorkerRole>
  
  <NetworkTrafficRules>
         …
  </NetworkTrafficRules>

</ServiceDefinition>

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

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

Элемент ServiceDefinition

Элемент ServiceDefinition — это элемент верхнего уровня файла определения службы.

В таблице ниже описаны атрибуты элемента ServiceDefinition.

Атрибут Описание
имя Обязательное. Имя службы. Имя должно быть уникальным в пределах учетной записи службы.
обнаружение изменений топологии Необязательно. Указывает тип уведомления об изменении топологии. Возможны следующие значения:

- Blast — отправляет обновление как можно быстрее всем экземплярам роли. Чтобы вы могли использовать этот параметр, роль должна иметь возможность обработать обновление топологии без перезапуска.
- UpgradeDomainWalk — отправляет обновление каждому экземпляру роли последовательно после успешного принятия обновления предыдущего экземпляра.
schemaVersion Необязательно. Указывает версию схемы определения службы. Версия схемы позволяет Visual Studio выбрать правильные средства пакета SDK для использования при проверке схемы, если установлено одновременно несколько версий пакета SDK.
обновитьКоличествоДомена Необязательно. Указывает количество доменов для обновления, по которым распределяются роли в этой службе. В процессе развертывания службы экземпляры ролей распределяются по домену обновления. Дополнительные сведения см. в Обновлении роли или развертывания Облачной службы и Управлении доступностью виртуальных машин. Можно указать до 20 доменов обновления. Если число доменов обновления не указано, по умолчанию оно равно 5.

См. также

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

  • Last updated on