Esquema de configuración de Azure Cloud Services (clásico) (archivo .cscfg)
Importante
Cloud Services (clásico) ahora está en desuso para los nuevos clientes y se retirará el 31 de agosto de 2024 para todos los clientes. Las nuevas implementaciones deben utilizar 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, así como en el archivo de configuración de red virtual. La extensión predeterminada del archivo de configuración de servicio es. cscfg.
El modelo de servicio se describe en Cloud Service (classic) Definition Schema (Esquema de definición de servicio en la nube [clásico]).
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 temas 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. El 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 ejecutará en las instancias de rol del servicio en la nube. 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 ejecutará en las instancias de rol del servicio en la nube. 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 SO invitado de la familia de SO especificada y se actualizarán 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 SO invitado de Matriz de compatibilidad del SDK y versiones del SO 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.