Esquema de configuração dos serviços de nuvem do Azure (arquivo. cscfg)Azure Cloud Services Config Schema (.cscfg File)

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 parâmetros de configuração e as impressões digitais para quaisquer certificados associados a uma função.The service configuration file specifies the number of role instances to deploy for each role in the service, the values of any configuration settings, and the thumbprints for any certificates associated with a role. Se o serviço fizer parte de uma rede virtual, as informações de configuração para a rede deverão ser fornecidas no arquivo de configuração de serviço, bem como no arquivo de configuração de rede virtual.If the service is part of a Virtual Network, configuration information for the network must be provided in the service configuration file, as well as in the virtual networking configuration file. A extensão padrão para o arquivo de configuração de serviço é. cscfg.The default extension for the service configuration file is .cscfg.

O modelo de serviço é descrito pelo esquema de definição do serviço de nuvem (clássico).The service model is described by the Cloud Service (classic) Definition Schema.

Por padrão, o arquivo de esquema de configuração diagnóstico do Azure é instalado C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas no diretório.By default, the Azure Diagnostics configuration schema file is installed to the C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas directory. Substitua <version> pela versão instalada do SDK do Azure.Replace <version> with the installed version of the Azure SDK.

Para obter mais informações sobre como configurar funções em um serviço, consulte o que é o modelo de serviço de nuvem.For more information about configuring roles in a service, see What is the Cloud Service model.

Esquema de configuração de serviço básicoBasic Service Configuration Schema

O formato básico do arquivo de configuração de serviço é o seguinte.The basic format of the service configuration file is as follows.

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

  <Role …>
    …
  </Role>

  <NetworkConfiguration>
    …
  </NetworkConfiguration>

</ServiceConfiguration>

Definições de esquemaSchema definitions

Os tópicos a seguir descrevem o esquema para ServiceConfiguration o elemento:The following topics describe the schema for the ServiceConfiguration element:

Namespace de configuração de serviçoService Configuration Namespace

O namespace XML para o arquivo de configuração de serviço http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceConfigurationé:.The XML namespace for the service configuration file is: http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceConfiguration.

Elemento de configuraçãoServiceConfiguration Element

O ServiceConfiguration elemento é o elemento de nível superior do arquivo de configuração de serviço.The ServiceConfiguration element is the top-level element of the service configuration file.

A tabela a seguir descreve os atributos do ServiceConfiguration elemento.The following table describes the attributes of the ServiceConfiguration element. Todos os valores de atributos são tipos de cadeia de caracteres.All attributes values are string types.

AtributoAttribute DescriçãoDescription
serviceNameserviceName Necessário.Required. O nome do serviço de nuvem.The name of the cloud service. O nome fornecido aqui deve corresponder ao nome especificado no arquivo de definição de serviço.The name given here must match the name specified in the service definition file.
osFamilyosFamily Opcional.Optional. Especifica o sistema operacional convidado que será executado em instâncias de função no serviço de nuvem.Specifies the Guest OS that will run on role instances in the cloud service. Para obter informações sobre as versões de SO convidado com suporte, consulte versões do SO convidado do Azure e matriz de compatibilidade do SDK.For information about supported Guest OS releases, see Azure Guest OS Releases and SDK Compatibility Matrix.

Se você não incluir um osFamily valor e não tiver definido o osVersion atributo para uma versão específica do sistema operacional convidado, será usado um valor padrão de 1.If you do not include an osFamily value and you have not set the osVersion attribute to a specific Guest OS version, a default value of 1 is used.
osVersionosVersion Opcional.Optional. Especifica a versão do sistema operacional convidado que será executado em instâncias de função no serviço de nuvem.Specifies the version of the Guest OS that will run on role instances in the cloud service. Para obter mais informações sobre versões do sistema operacional convidado, consulte versões do SO convidado do Azure e matriz de compatibilidade do SDK.For more information about Guest OS versions, see Azure Guest OS Releases and SDK Compatibility Matrix.

Você pode especificar que o sistema operacional convidado deve ser atualizado automaticamente para a versão mais recente.You can specify that the Guest OS should be automatically upgraded to the latest version. Para fazer isso, defina o valor do osVersion atributo como. *To do this, set the value of the osVersion attribute to *. Quando definido como *, as instâncias de função são implantadas usando a versão mais recente do sistema operacional convidado para a família de sistemas operacionais especificada e serão atualizadas automaticamente quando novas versões do sistema operacional convidado forem liberadas.When set to *, the role instances are deployed using the latest version of the Guest OS for the specified OS family and will be automatically upgraded when new versions of the Guest OS are released.

Para especificar uma versão específica manualmente, use a Configuration String da tabela na seção versões futuras, atuais e transacionais do sistema operacional convidado de versões do SO convidado do Azure e matriz de compatibilidade do SDK.To specify a specific version manually, use the Configuration String from the table in the Future, Current and Transitional Guest OS Versions section of Azure Guest OS Releases and SDK Compatibility Matrix.

O valor padrão para o osVersion atributo é *.The default value for the osVersion attribute is *.
schemaVersionschemaVersion Opcional.Optional. Especifica a versão do esquema de configuração de serviço.Specifies the version of the Service Configuration schema. A versão do esquema permite que o Visual Studio selecione as ferramentas do SDK corretas a serem usadas para validação de esquema se mais de uma versão do SDK estiver instalada lado a lado.The schema version allows Visual Studio to select the correct SDK tools to use for schema validation if more than one version of the SDK is installed side-by-side. 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 SDKFor more information about schema and version compatibility, see Azure Guest OS Releases and SDK Compatibility Matrix

O arquivo de configuração de serviço deve ServiceConfiguration conter um elemento.The service configuration file must contain one ServiceConfiguration element. O ServiceConfiguration elemento pode incluir qualquer número de Role elementos e zero ou 1 NetworkConfiguration elementos.The ServiceConfiguration element may include any number of Role elements and zero or 1 NetworkConfiguration elements.