Esquema de definição dos Serviços de Nuvem do Azure (clássico) (arquivo .csdef)
Importante
Os Serviços na Nuvem (clássicos) foram preteridos para todos os clientes a partir de 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. 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 para as funções que estão disponíveis para um serviço de nuvem, especifica os pontos de extremidade do serviço e estabelece 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 do 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 C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas
diretório. Substitua <version>
pela versão instalada do SDK do Azure.
A extensão padrão para o arquivo de definição de serviço é .csdef.
Esquema de definição de serviço básico
O arquivo de definição de serviço deve conter um ServiceDefinition
elemento . 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 você pode misturar tipos de função. A definição de serviço também contém o elemento opcional NetworkTrafficRules
, 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 opcional LoadBalancerProbes
, que contém testes de integridade definidos pelo cliente de pontos de extremidade.
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 de esquema
Os tópicos a seguir descrevem o esquema:
- Esquema de LoadBalancerProbe
- Esquema de WebRole
- Esquema de WorkerRole
- Esquema de NetworkTrafficRules
Elemento ServiceDefinition
O ServiceDefinition
elemento é o elemento de nível superior do arquivo de definição de serviço.
A tabela a seguir descreve os atributos do ServiceDefinition
elemento .
Atributo | Description |
---|---|
nome | Necessário. O nome do serviço. O nome deve ser exclusivo dentro da conta de serviço. |
topologiaChangeDiscovery | Opcional. Especifica o tipo de notificação de alteração de topologia. Os valores possíveis são: - Blast - Envia a atualização o mais rápido possível para todas as instâncias de função. Se você escolher a opção, a função deverá ser capaz de lidar com a atualização de topologia sem ser reiniciada.- UpgradeDomainWalk – Envia a atualização para cada instância de função de forma sequencial depois que a instância anterior aceita com êxito a atualização. |
schemaVersion | Opcional. Especifica a versão do esquema de definição de serviço. A versão do esquema permite que o Visual Studio selecione as ferramentas SDK corretas a serem usadas para validação de esquema se mais de uma versão do SDK estiver instalada lado a lado. |
upgradeDomainCount | Opcional. Especifica o número de domínios de atualização nos quais as funções neste serviço são alocadas. As instâncias de função são alocadas a um domínio de atualização quando o serviço é implantado. Para obter mais informações, consulte 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. Você pode especificar até 20 domínios de atualização. Se não for especificado, o número padrão de domínios de atualização é 5. |