Esquema de configuración de Azure Cloud Services (clásico) (archivo .cscfg)

Importante

Cloud Services (clásico) ahora está en desuso para todos los clientes a partir del 1 de septiembre de 2024. Microsoft detendrá y cerrará todas las implementaciones en curso y los datos se perderán de forma permanente a partir de octubre de 2024. Las nuevas implementaciones deben usar el nuevo modelo de implementación basado en Azure Resource Manager Azure Cloud Services (soporte extendido).

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 del servicio en la nube (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 por <version> la versión instalada del SDK de Azure.

Para obtener más información sobre cómo configurar roles en un servicio, consulte ¿Qué es 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 temas siguientes se describe el esquema del elemento ServiceConfiguration:

• Esquema de rol
• Esquema de NetworkConfiguration

Espacio de nombres de configuración del servicio

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

Elemento de Configuración del Servicio

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
nombreDelServicio	Obligatorio. 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 del servicio en la nube. Para obtener información sobre las versiones de SO invitado admitidas, consulte Azure Guest OS Releases and SDK Compatibility Matrix (Versiones de SO invitado de Azure y matriz de compatibilidad del SDK). 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 la nube. Para más información sobre las versiones del sistema operativo invitado, consulte Versiones del sistema operativo invitado de Azure y la matriz de compatibilidad del SDK. 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 específica, utilice la entrada de la tabla en la sección Versiones futuras, actuales y transitorias del sistema operativo invitado de Versiones del SO invitado de Azure y matriz de compatibilidad del SDK. 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 de esquemas y versiones, consulte Azure Guest OS Releases and SDK Compatibility Matrix (Versiones del sistema operativo invitado de Azure y matriz de compatibilidad del SDK).

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