Esquema de definição (arquivo .csdef) dos Serviços de Nuvem do Azure
Importante
Os Serviços de Nuvem (clássicos) estão obsoletos para todos os clientes desde 1º de setembro de 2024. Todas as implantações em execução existentes serão interrompidas e encerradas pela Microsoft e os dados serão perdidos permanentemente a partir de outubro de 2024. As novas implantações devem usar o novo modelo de implantação baseado no Azure Resource Manager Serviços de Nuvem do Azure (suporte estendido) .
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 (clássico).
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 tópicos a seguir 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 implantação de serviço de nuvem, Gerenciar a disponibilidade de máquinas virtuais e O que é um modelo de serviço de nuvem. É possível especificar até 20 domínios de atualização. Se não especificado, o número padrão de domínios de atualização é 5. |