Comparteix a través de


Esquema de configuración de Azure Cloud Services (soporte extendido) (archivo .cscfg)

El archivo de configuración de servicio especifica el número de instancias de rol que se implementan para cada rol del servicio, los valores de los parámetros de configuración y las huellas digitales de los certificados asociados a un rol. Si el servicio forma parte de una red virtual, se debe proporcionar información de configuración de la red en el archivo de configuración de servicio y en el archivo de configuración de red virtual. La extensión predeterminada del archivo de configuración de servicio es. cscfg.

El esquema de definición de Cloud Services (clásico) describe el modelo de servicio.

De forma predeterminada, el archivo de esquema de configuración de Diagnósticos de Azure se instala en el directorio C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas. Reemplace <version> por la versión instalada del SDK de Azure.

Para más información sobre la configuración de roles en un servicio, consulte el artículo sobre el modelo de servicio en la nube.

Esquema básico de configuración de servicio

El formato básico del archivo de configuración de servicio es el siguiente.

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

  <Role …>
    …
  </Role>

  <NetworkConfiguration>
    …
  </NetworkConfiguration>

</ServiceConfiguration>

Definiciones de esquema

En los artículos siguientes se describe el esquema del elemento ServiceConfiguration:

Espacio de nombres de configuración de servicio

El espacio de nombres XML del archivo de configuración de servicio es: http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceConfiguration.

Elemento ServiceConfiguration

El elemento ServiceConfiguration es el elemento de nivel superior del archivo de configuración de servicio.

En la tabla siguiente se describen los atributos del elemento ServiceConfiguration: Todos los valores de atributo son tipos de cadena.

Atributo Descripción
serviceName Necesario. Nombre del servicio en la nube. El nombre especificado aquí debe coincidir con el nombre especificado en el archivo de definición de servicio.
osFamily Opcional. Especifica el sistema operativo invitado que se ejecuta en las instancias de rol de Cloud Services. Para información sobre las versiones admitidas del SO invitado, consulte Matriz de compatibilidad del SDK y versiones del SO invitado de Azure.

Si no incluye un valor osFamily y no ha establecido el atributo osVersion en una versión específica del sistema operativo invitado, se usa un valor predeterminado de 1.
osVersion Opcional. Especifica la versión del sistema operativo invitado que se ejecuta en las instancias de rol del servicio en Cloud Services. Para más información sobre las versiones del sistema operativo invitado, consulte Matriz de compatibilidad del SDK y versiones del SO invitado de Azure.

Puede especificar que el sistema operativo invitado debe actualizarse automáticamente a la versión más reciente. Para ello, establezca el valor del atributo osVersion en *. Cuando se establece en *, las instancias de rol se implementan con la versión más reciente del sistema operativo invitado de la familia de SO especificada y se actualizan automáticamente cuando se publican nuevas versiones de él.

Para especificar manualmente una versión concreta, use el elemento Configuration String de la tabla de la sección sobre versiones futuras, actuales y transicionales del sistema operativo invitado de Matriz de compatibilidad del SDK y versiones del sistema operativo invitado de Azure.

El valor predeterminado del atributo osVersion es *.
schemaVersion Opcional. Especifica la versión del esquema de configuración de servicio. La versión del esquema permite que Visual Studio seleccione las herramientas del SDK correcto que se usarán en la validación del esquema si se instala más de una versión del SDK en paralelo. Para más información sobre la compatibilidad con versiones y esquemas, consulte Matriz de compatibilidad del SDK y versiones del SO invitado de Azure

El archivo de configuración de servicio debe contener un elemento ServiceConfiguration. El elemento ServiceConfiguration puede incluir cualquier número de elementos Role y ningún elemento NetworkConfiguration o 1.

Consulte también

Esquema de definición de Azure Cloud Services (soporte extendido) (archivo .cscfg)