Partilhar via


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:

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.