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

  • Artigo

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, bem como no arquivo de configuração da rede virtual. A extensão padrão para o arquivo de configuração de serviço é cscfg.

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

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 Descrição
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 será 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 valor e não tiver definido o atributo para uma versão específica do osVersion SO convidado, um osFamily valor padrão de 1 será usado.
osVersão Opcional. Especifica a versão do SO convidado que será 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 definido 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 serão atualizadas automaticamente quando novas versões do SO convidado forem 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.

Consulte também

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