Partager via

Schéma de définition d’Azure Cloud Services (classique) [fichier .csdef]

  • Article

Important

Cloud Services (classique) est désormais déconseillé pour tous les clients depuis le 1er septembre 2024. Tous les déploiements existants en cours d’exécution seront arrêtés par Microsoft, et les données seront définitivement perdues à partir d’octobre 2024. Les nouveaux déploiements doivent utiliser le nouveau modèle de déploiement basé sur Azure Resource Manager Azure Cloud Services (support étendu) .

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 services cloud (classique).

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 de 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 le client 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 :

É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, après l’acceptation correcte de la mise à jour par l’instance précédente.
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, Gestion de la disponibilité des machines virtuelles et What is a Cloud Service Model (Qu’est-ce qu’un modèle Cloud Service ?).

Vous pouvez spécifier jusqu’à 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.