Schéma de définition d’Azure Cloud Services (support étendu) (fichier csdef)

Le fichier de définition de service définit le modèle de service d’une application. Le fichier contient les définitions des rôles disponibles pour un service cloud, spécifie les points de terminaison de service et établit les paramètres de configuration du service. Les valeurs des paramètres de configuration sont définies dans le fichier de configuration de service, comme indiqué dans le schéma de configuration de service cloud (support étendu).

Par défaut, le fichier de schéma de configuration Diagnostics Azure est installé dans le répertoire C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas. Remplacez <version> par la version installée du Kit de développement logiciel (SDK) Azure.

L’extension par défaut du fichier de définition du service est csdef.

Schéma de définition de service de base

Le fichier de configuration de service doit contenir un élément ServiceDefinition. La définition de service doit contenir au moins un élément de rôle (WebRole ou WorkerRole). Elle peut contenir jusqu’à 25 rôles définis dans une seule définition ; vous pouvez associer des types de rôles. La définition du service contient également l’élément facultatif NetworkTrafficRules, qui limite les rôles pouvant communiquer avec les points de terminaison internes spécifiés. La définition du service contient également l’élément facultatif LoadBalancerProbes, qui contient les sondes d’intégrité définies par les clients pour les points de terminaison.

Le format de base du fichier de définition de service se présente comme suit.

<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>

Définitions de schéma

Les rubriques suivantes décrivent le schéma :

• Schéma LoadBalancerProbe
• Schéma WebRole
• Schéma WorkerRole
• Schéma NetworkTrafficRules

Élément ServiceDefinition

L’élément ServiceDefinition correspond à l’élément de niveau supérieur du fichier de définition de service.

Le tableau suivant décrit les attributs d’un de l’élément ServiceDefinition.

Attribut	Description
name	Obligatoire. Nom du service. Ce nom doit être unique au sein du compte de service.
topologyChangeDiscovery	facultatif. Spécifie le type de notification de modification de la topologie. Les valeurs possibles sont les suivantes : - Blast : envoie la mise à jour à toutes les instances de rôle, dès que possible. Si vous choisissez l’option, le rôle doit être en mesure de gérer la mise à jour de la topologie sans devoir redémarrer. - UpgradeDomainWalk : envoie la mise à jour à chaque instance de rôle, de manière séquentielle, une fois que l’instance précédente a accepté la mise à jour.
schemaVersion	facultatif. Spécifie la version du schéma de définition de service. La version du schéma permet à Visual Studio de sélectionner les outils du Kit de développement logiciel (SDK) appropriés à utiliser pour la validation du schéma, si plusieurs versions de ce Kit sont installées côte à côte.
upgradeDomainCount	facultatif. Spécifie le nombre de domaines de mise à niveau sur lesquels les rôles de ce service sont alloués. Les instances de rôle sont allouées à un domaine de mise à niveau lorsque le service est déployé. Pour plus d’informations, consultez Mise à jour d’un déploiement ou d’un rôle de service cloud et Gestion de la disponibilité des machines virtuelles. Vous pouvez spécifier un maximum de 20 domaines de mise à niveau. Si aucune valeur n’est spécifiée, le nombre de domaines de mise à niveau par défaut est de 5.

Voir aussi

Schéma de configuration d’Azure Cloud Services (support étendu) (fichier cscfg).