Partilhar via

Azure Cloud Services (suporte expandido) esquema de configuração (ficheiro cscfg)

Importante

A partir de 31 de março de 2025, os Serviços de nuvem (suporte estendido) foram preteridos e serão totalmente desativados em 31 de março de 2027. Saiba mais sobre esta depreciação e como migrar.

O ficheiro de configuração do serviço especifica o número de instâncias de cada função a implementar 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 para a rede devem ser fornecidas no ficheiro de configuração do serviço e no ficheiro de configuração da rede virtual. A extensão padrão para o ficheiro de configuração do 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 ficheiro de configuração de esquema do Azure Diagnostics é instalado no diretório C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas. Substituir <version> pela versão instalada do Azure SDK.

Para mais informações sobre a configuração de funções num serviço, consulte O que é o modelo de Serviço na Nuvem.

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

O formato básico do ficheiro 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 esquemas

Os seguintes artigos descrevem o esquema para o elemento ServiceConfiguration.

Espaço de nomes de configuração de serviço

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

Elemento de ServiceConfiguration

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

A tabela seguinte descreve os atributos do elemento ServiceConfiguration. Todos os valores de atributos são do tipo string.

Atributo Descrição
nomeDoServiço Obrigatório. O nome do Serviço de Nuvem. O nome fornecido aqui deve coincidir com o nome especificado no ficheiro de definição de serviço.
osFamília Opcional Especifica o SO de convidado que executa nas instâncias de função no Serviço de Nuvem. Para obter informações sobre as versões do Guest OS suportadas, consulte Azure Guest OS Releases and SDK Compatibility Matrix.

Se não incluir um valor de osFamily e não tiver definido o atributo osVersion para uma versão específica do sistema operativo Guest, será usado um valor padrão de 1.
osVersão Opcional Especifica a versão do sistema operativo do convidado que executa nas instâncias de função no Serviço de Nuvem. Para mais informações sobre as versões do sistema operativo convidado, consulte Lançamentos do Azure Guest OS e Matriz de Compatibilidade SDK.

Pode especificar que o sistema operativo de convidado seja automaticamente atualizado para a versão mais recente. Para isso, defina o valor do atributo osVersion para *. Quando definido para *, as instâncias de função são implantadas utilizando a versão mais recente do Guest OS para a família de sistema operativo especificada e são automaticamente atualizadas quando novas versões do Guest OS são lançadas.

Para especificar manualmente uma versão específica, utilize o Configuration String da tabela na seção Versões Futuras, Atuais e Transitórias do Sistema Operacional Convidado do Azure Guest OS Releases and SDK Compatibility Matrix.

O valor predefinido para o atributo osVersion é *.
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 corretas do SDK para validar o esquema, caso mais de uma versão do SDK esteja instalada simultaneamente. Para mais informações sobre compatibilidade de esquemas e versões, consulte Matriz de Compatibilidade de Lançamentos de Azure Guest OS e SDK

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

Ver também

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

  • Last updated on