Esquema de Definição do Azure Serviços Cloud (clássico) (Ficheiro .csdef)

Importante

Serviços Cloud (clássico) foi preterido para novos clientes e será descontinuado a 31 de agosto de 2024 para todos os clientes. As novas implementações devem utilizar o novo modelo de implementação baseado em Resource Manager do Azure Serviços Cloud (suporte alargado).

O ficheiro de definição de serviço define o modelo de serviço para uma aplicação. O ficheiro contém as definições das funções que estão disponíveis para um serviço cloud, especifica os pontos finais de serviço e estabelece as definições de configuração do serviço. Os valores das definições de configuração são definidos no ficheiro de configuração do serviço, conforme descrito pelo Esquema de Configuração do Serviço Cloud (clássico).

Por predefinição, o Diagnóstico do Azure ficheiro de esquema de configuração está 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 predefinida para o ficheiro de definição de serviço é .csdef.

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

O ficheiro de definição de serviço tem de conter um ServiceDefinition elemento. A definição de serviço tem de conter, pelo menos, um elemento de função (WebRole ou WorkerRole) . Pode conter até 25 funções definidas numa única definição e pode misturar tipos de função. A definição de serviço também contém o elemento opcional NetworkTrafficRules que restringe as funções que podem comunicar com pontos finais internos especificados. A definição de serviço também contém o elemento opcional LoadBalancerProbes que contém sondas de estado de funcionamento definidas pelo cliente dos pontos finais.

O formato básico do ficheiro 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 seguintes descrevem o esquema:

• Esquema de LoadBalancerProbe
• Esquema de WebRole
• Esquema de WorkerRole
• Esquema de NetworkTrafficRules

ServiceDefinition Element

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

A tabela seguinte descreve os atributos do ServiceDefinition elemento .

Atributo	Descrição
name	Obrigatório. O nome do serviço. O nome tem de ser exclusivo na 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 o mais rapidamente possível a todas as instâncias de função. Se escolher a opção, a função deverá conseguir processar a atualização de topologia sem ser reiniciada. - UpgradeDomainWalk – Envia a atualização para cada instância de função de forma sequencial depois de a instância anterior ter aceite a atualização com êxito.
schemaVersion	Opcional. Especifica a versão do esquema de definição de serviço. A versão de esquema permite que o Visual Studio selecione as ferramentas do SDK corretas a utilizar para validação de esquema se mais do que uma versão do SDK estiver instalada lado a lado.
upgradeDomainCount	Opcional. Especifica o número de domínios de atualização em que 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 é implementado. Para obter mais informações, veja Atualizar uma função ou implementação do serviço cloud, Gerir a disponibilidade de máquinas virtuais e O que é um Modelo de Serviço Cloud. Pode especificar até 20 domínios de atualização. Se não for especificado, o número predefinido de domínios de atualização é 5.