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

Artigo
07/25/2024

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 (suporte estendido) 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 seguintes artigos 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.

Consulte também

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

Partilhar via