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

Artigo
12/04/2024

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. Caso o serviço faça parte de uma Rede Virtual, as informações de configuração da rede precisam 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 do Serviço de Nuvem (suporte estendido) descreve o modelo do 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 artigos 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 Sistema Operacional Convidado que será 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 Sistema Operacional Convidado que será executado 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.

Confira também

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

Compartilhar via