Compartilhar via

Esquema de definição (arquivo csdef) dos Serviços de Nuvem do Azure (suporte estendido)

  • Artigo

O arquivo de definição de serviço define o modelo de serviço para um aplicativo. O arquivo contém as definições das funções disponíveis para um serviço de nuvem, especifica os pontos de extremidade de serviço e estabelece as definições de configuração para o serviço. Os valores de definição de configuração são definidos no arquivo de configuração de serviço, conforme descrito pelo Esquema de configuração do Serviço de Nuvem (suporte estendido).

Por padrão, o arquivo de esquema de configuração do Diagnóstico do Azure é instalado no diretório C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas. Substitua <version> pela versão instalada do SDK do Azure.

A extensão padrão do arquivo de definição de serviço é csdef.

Esquema básico de definição de serviço

O arquivo de definição de serviço deve conter um elemento ServiceDefinition. A definição de serviço deve conter pelo menos um elemento de função (WebRole ou WorkerRole). Ele pode conter até 25 funções definidas em uma única definição e é possível combinar tipos de função. A definição de serviço também contém o elemento NetworkTrafficRules opcional que restringe quais funções podem se comunicar com pontos de extremidade internos especificados. A definição de serviço também contém o elemento LoadBalancerProbes opcional que contém as sondas de pontos de extremidade de integridade definidas pelo cliente.

O formato básico do arquivo de definição de serviço é o seguinte.

<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>

Definições do esquema

Os seguintes artigos descrevem o esquema:

Elemento ServiceDefinition

O elemento ServiceDefinition é o elemento de nível superior do arquivo de definição de serviço.

A tabela a seguir descreve os atributos do elemento ServiceDefinition.

Atributo Descrição
name Obrigatórios. O nome do serviço. O nome deve ser exclusivo dentro da conta de serviço.
topologyChangeDiscovery Opcional. Especifica o tipo de notificação de alteração de topologia. Os valores possíveis são:

- Blast – Envia a atualização assim que possível para todas as instâncias de função. Se você escolher uma opção, a função deverá ser capaz de lidar com a atualização da topologia sem ser reiniciada.
- UpgradeDomainWalk – envia a atualização para cada instância de função de maneira sequencial depois que a instância anterior aceita a atualização com sucesso.
schemaVersion Opcional. Especifica a versão do esquema de definição de serviço. A versão do esquema permitirá que o Visual Studio selecione as ferramentas do SDK corretas para usar para a validação de esquema se mais de uma versão do SDK for instalada lado a lado.
upgradeDomainCount Opcional. Especifica o número de domínios de atualização entre quais funções neste serviço são alocadas. As instâncias de função são alocadas para um domínio de atualização quando o serviço é implantado. Para obter mais informações, confira Atualizar uma função ou uma implantação do Serviço de Nuvem e Gerenciar a disponibilidade de máquinas virtuais. Você pode especificar até 20 domínios de atualização. Se não especificado, o número padrão de domínios de atualização é 5.

Confira também

Esquema de configuração (arquivo cscfg) dos Serviços de Nuvem do Azure (suporte estendido).