Partilhar via

Esquema de configuração dos Serviços de Nuvem do Azure (clássico) (arquivo .cscfg)

  • Artigo

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 configuração de serviço especifica o número de instâncias de função a serem implantadas para cada função no serviço, os valores de quaisquer definições de configuração e as impressões digitais de quaisquer certificados associados a uma função. Se o serviço fizer parte de uma Rede Virtual, as informações de configuração da rede deverão ser fornecidas no arquivo de configuração do serviço e no arquivo de configuração da rede virtual. A extensão padrão para o arquivo de configuração de serviço é .cscfg.

O Esquema de Definição do Serviço de Nuvem (clássico) descreve o modelo de serviço.

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.

Para obter mais informações sobre como configurar funções em um serviço, consulte O que é o modelo de serviço de nuvem.

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

O formato básico do arquivo 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 a seguir descrevem o esquema para o ServiceConfiguration elemento:

Namespace de configuração de serviço

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

Elemento ServiceConfiguration

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

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

Atributo Description
nome_do_serviço Obrigatório. O nome do serviço de nuvem. O nome fornecido aqui deve corresponder ao nome especificado no arquivo de definição de serviço.
osFamília Opcional. Especifica o SO convidado que é executado em instâncias de função no serviço de nuvem. Para obter informações sobre versões suportadas do SO convidado, consulte Versões do SO convidado do Azure e Matriz de compatibilidade do SDK.

Se você não incluir um osFamily valor e não tiver definido o osVersion atributo para uma versão específica do SO convidado, um valor padrão de 1 será usado.
osVersão Opcional. Especifica a versão do SO convidado que é executada em instâncias de função no serviço de nuvem. Para obter mais informações sobre versões do SO convidado, consulte Versões do SO convidado do Azure e Matriz de compatibilidade do SDK.

Você pode especificar que o SO convidado deve ser atualizado automaticamente para a versão mais recente. Para fazer isso, defina o osVersion valor do atributo como *. Quando definidas como *, as instâncias de função são implantadas usando a versão mais recente do SO convidado para a família de SO especificada e são atualizadas automaticamente quando novas versões do SO convidado são lançadas.

Para especificar uma versão específica manualmente, use a Configuration String partir da tabela na seçã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 padrão para o osVersion atributo é *.
schemaVersion Opcional. Especifica a versão do esquema de Configuração do 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. Para obter mais informações sobre compatibilidade de esquema e versão, consulte Versões do SO convidado do Azure e Matriz de compatibilidade do SDK

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