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

  • Artigo

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 configuração do serviço especifica o número de instâncias de função a implementar para cada função no serviço, os valores de quaisquer definições de configuração e os thumbprints para quaisquer certificados associados a uma função. Se o serviço fizer parte de um Rede Virtual, as informações de configuração da rede têm de ser fornecidas no ficheiro de configuração do serviço, bem como no ficheiro de configuração de rede virtual. A extensão predefinida para o ficheiro de configuração do serviço é .cscfg.

O modelo de serviço é descrito pelo Esquema de Definiçã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.

Para obter mais informações sobre como configurar funções num serviço, veja O que é o modelo do Serviço Cloud.

Esquema de Configuração do Serviço Básico

O formato básico do ficheiro de configuração do serviço é o seguinte.

<ServiceConfiguration serviceName="<service-name>" osFamily="<osfamily-number>" osVersion="<os-version>" schemaVersion="<schema-version>">

  <Role …>
    …
  </Role>

  <NetworkConfiguration>
    …
  </NetworkConfiguration>

</ServiceConfiguration>

Definições de esquema

Os tópicos seguintes descrevem o esquema do ServiceConfiguration elemento:

Espaço de Nomes da Configuração do Serviço

O espaço de nomes XML para o ficheiro de configuração do serviço é: http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceConfiguration.

ServiceConfiguration Element

O ServiceConfiguration elemento é o elemento de nível superior do ficheiro de configuração do serviço.

A tabela seguinte descreve os atributos do ServiceConfiguration elemento . Todos os valores de atributos são tipos de cadeia.

Atributo Descrição
serviceName Obrigatório. O nome do serviço cloud. O nome aqui indicado tem de corresponder ao nome especificado no ficheiro de definição de serviço.
osFamily Opcional. Especifica o SO Convidado que será executado em instâncias de função no serviço cloud. Para obter informações sobre as versões suportadas do SO Convidado, veja Azure Guest OS Releases and SDK Compatibility Matrix (Versões do SO Convidado do Azure e Matriz de Compatibilidade do SDK).

Se não incluir um osFamily valor e não tiver definido o osVersion atributo para uma versão específica do SO Convidado, é utilizado um valor predefinido de 1.
osVersion Opcional. Especifica a versão do SO Convidado que será executada em instâncias de função no serviço cloud. Para obter mais informações sobre as versões do SO Convidado, veja Versões do SO Convidado do Azure e Matriz de Compatibilidade do SDK.

Pode especificar que o SO Convidado deve ser atualizado automaticamente para a versão mais recente. Para tal, defina o valor do osVersion atributo como *. Quando definidas como *, as instâncias de função são implementadas com a versão mais recente do SO Convidado para a família de SO especificada e serão atualizadas automaticamente quando forem lançadas novas versões do SO Convidado.

Para especificar uma versão específica manualmente, utilize a Configuration String da tabela na secção Versões futuras, atuais e transitórias do SO Convidado das Versões do SO Convidado do Azure e da Matriz de Compatibilidade do SDK.

O valor predefinido para o osVersion atributo é *.
schemaVersion Opcional. Especifica a versão do esquema de Configuração do 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. Para obter mais informações sobre o esquema e a compatibilidade de versões, veja Versões do SO Convidado do Azure e Matriz de Compatibilidade do SDK

O ficheiro de configuração do serviço tem de conter um ServiceConfiguration elemento. O ServiceConfiguration elemento pode incluir qualquer número de Role elementos e zero ou 1 NetworkConfiguration elementos.