Esquema de definición de Azure Cloud Services (clásico) (archivo .csdef)
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 utilizar el nuevo modelo de implementación basado en Azure Resource Manager Azure Cloud Services (soporte extendido) .
El archivo de definición de servicio define el modelo de servicio de una aplicación. El archivo contiene las definiciones de los roles que están disponibles para un servicio en la nube, especifica los puntos de conexión de servicio y establece los valores de configuración del servicio. Los valores de configuración se establecen en el archivo de configuración de servicio, como se describe en el esquema de configuració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.
La extensión predeterminada del archivo de definición de servicio es. csdef.
Esquema básico de definición de servicio
El archivo de definición de servicio debe contener un elemento ServiceDefinition. La definición de servicio debe contener al menos un rol (elemento WebRole o WorkerRole). Puede contener hasta 25 roles definidos en una única definición y se pueden mezclar tipos de rol. La definición de servicio también contiene el elemento opcional NetworkTrafficRules, que restringe qué roles pueden comunicarse con puntos de conexión internos especificados. La definición de servicio también contiene el elemento opcional LoadBalancerProbes, que incluye sondeos de estado de mantenimiento de puntos de conexión definidos por el cliente.
El formato básico del archivo de definición de servicio es el siguiente.
<ServiceDefinition name="<service-name>" topologyChangeDiscovery="<change-type>" xmlns="http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceDefinition" upgradeDomainCount="<number-of-upgrade-domains>" schemaVersion="<version>">
<LoadBalancerProbes>
…
</LoadBalancerProbes>
<WebRole …>
…
</WebRole>
<WorkerRole …>
…
</WorkerRole>
<NetworkTrafficRules>
…
</NetworkTrafficRules>
</ServiceDefinition>
Definiciones de esquema
En los temas siguientes se describe el esquema:
Elemento ServiceDefinition
El elemento ServiceDefinition es el elemento de nivel superior del archivo de definición de servicio.
En la tabla siguiente se describen los atributos del elemento ServiceDefinition:
| Atributo | Description |
|---|---|
| name | Necesario. El nombre del servicio. El nombre debe ser único dentro de la cuenta de servicio. |
| topologyChangeDiscovery | Opcional. Especifica el tipo de notificación de cambio de topología. Los valores posibles son: - Blast: envía la actualización en cuanto es posible a todas las instancias de rol. Si elige esta opción, el rol debe ser capaz de controlar la actualización de la topología sin tener que reiniciarse.- UpgradeDomainWalk: envía la actualización a cada instancia de rol de forma secuencial después de que la instancia anterior acepte correctamente la actualización. |
| schemaVersion | Opcional. Especifica la versión del esquema de definició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. |
| upgradeDomainCount | Opcional. Especifica el número de dominios de actualización en los que se asignan roles de este servicio. Las instancias de rol se asignan a un dominio de actualización cuando se implementa el servicio. Para más información, consulte Actualización de una implementación o un rol de servicio en la nube, Administración de la disponibilidad de las máquinas virtuales y Qué es un modelo de servicio en la nube. Puede especificar hasta 20 dominios de actualización. Si no lo especifica, el número predeterminado de dominios de actualización es 5. |