Partilhar via

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

Importante

A partir de 31 de março de 2025, os Serviços de nuvem (suporte estendido) foram preteridos e serão totalmente desativados em 31 de março de 2027. Saiba mais sobre esta depreciação e como migrar.

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 (suporte estendido).

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 inclui testes de integridade dos endpoints definidos 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 de esquema

Os seguintes artigos 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 Descrição
nome Obrigatório O nome do serviço. O nome deve ser exclusivo dentro da conta de serviço.
descobertaDeAlteraçãoNaTopologia 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 se implanta o serviço. Para obter mais informações, consulte Atualizar uma função ou 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 for especificado, o número padrão de domínios de atualização é 5.

Consulte também

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

  • Last updated on