Compartilhar via

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

  • Artigo

Importante

Os Serviços de Nuvem (clássicos) estão obsoletos para todos os clientes desde 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. As 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 ser implantado para cada função no serviço, os valores das configurações e as impressões digitais de todos os 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 do arquivo de configuração de serviço é .cscfg.

O Esquema de definição de serviço em 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 diretório C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas. 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 What is the Cloud Service model (O que é o modelo do Serviço de Nuvem).

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

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

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

  <Role …>
    …
  </Role>

  <NetworkConfiguration>
    …
  </NetworkConfiguration>

</ServiceConfiguration>

Definições do esquema

Os tópicos a seguir descrevem o esquema para o elemento ServiceConfiguration:

Namespace de configuração de serviço

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

Elemento ServiceConfiguration

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

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

Atributo Descrição
serviceName Obrigatórios. O nome do serviço de nuvem. O nome fornecido aqui deve corresponder ao nome especificado no arquivo de definição de serviço.
osFamily Opcional. Especifica o SO convidado executado em instâncias de função no serviço de nuvem. Para obter informações sobre versões do SO convidado com suporte, consulte Azure Guest OS Releases and SDK Compatibility Matrix (Matriz de compatibilidade do SDK e lançamentos do SO convidado do Azure).

Se você não incluir um valor osFamily e não tiver definido o atributo osVersion para uma versão específica do sistema operacional convidado, um valor padrão de 1 será usado.
osVersion Opcional. Especifica a versão do SO convidado executada em instâncias de função no serviço de nuvem. Para obter mais informações sobre as versões do SO convidado, consulte Azure Guest OS Releases and SDK Compatibility Matrix (Matriz de compatibilidade do SDK e lançamentos do SO convidado do Azure).

É possível especificar que o SO convidado deve ser atualizado automaticamente para a versão mais recente. Para fazer isso, defina o valor do atributo osVersion 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 o Configuration String da tabela na seção Versões futuras, atuais e transitórias do sistema operacional convidado de Versões do sistema operacional convidado do Azure e matriz de compatibilidade do SDK.

O valor padrão do atributo osVersion é *.
schemaVersion Opcional. Especifica a versão do esquema de configuração de serviço. A versão do esquema permitirá que o Visual Studio selecione as ferramentas do SDK corretas para usar para a validação de esquema se mais de uma versão do SDK for instalada lado a lado. Para obter mais informações sobre a compatibilidade do esquema e da versão, consulte Azure Guest OS Releases and SDK Compatibility Matrix (Matriz de compatibilidade do SDK e lançamentos do SO convidado do Azure)

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