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

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

По умолчанию файл схемы конфигурации системы диагностики 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>

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

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

• Схема LoadBalancerProbe
• Схема WebRole
• Схема WorkerRole
• Схема NetworkTrafficRules

Элемент ServiceDefinition

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

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

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

См. также

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