Partager via

Schéma de définition Azure Cloud Services (classique) (fichier .cscfg)

  • 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 configuration de service spécifie le nombre d’instances de rôle à déployer pour chaque rôle dans le service, les valeurs des paramètres de configuration et les empreintes des certificats associés à un rôle. Si le service fait partie d’un réseau virtuel, les informations de configuration du réseau doivent être fournies dans le fichier de configuration du service et dans le fichier config du réseau virtuel. L’extension par défaut du fichier de configuration de service est .cscfg.

Le schéma de définition de services cloud (classique) décrit le modèle de service.

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.

Pour plus d’informations sur la configuration des rôles dans un service, consultez Qu’est-ce que le modèle Cloud Service ?

Schéma de configuration de service de base

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

<ServiceConfiguration serviceName="<service-name>" osFamily="<osfamily-number>" osVersion="<os-version>" schemaVersion="<schema-version>">

  <Role …>
    …
  </Role>

  <NetworkConfiguration>
    …
  </NetworkConfiguration>

</ServiceConfiguration>

Définitions de schéma

Les rubriques suivantes décrivent le schéma pour l’élément ServiceConfiguration :

Espace de noms de configuration de service

L’espace de noms XML du fichier de configuration de service est : http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceConfiguration.

Élément ServiceConfiguration

L’élément ServiceConfiguration est l’élément de niveau supérieur du fichier de configuration de service.

Le tableau suivant décrit les attributs d’un de l’élément ServiceConfiguration. Toutes les valeurs d’attribut sont des types de chaîne.

Attribut Description
serviceName Obligatoire. Nom du service cloud. Le nom indiqué ici doit correspondre au nom spécifié dans le fichier de définition de service.
osFamily facultatif. Spécifie le système d’exploitation invité qui s’exécute sur les instances de rôle dans le service cloud. Pour plus d’informations sur les versions du système d'exploitation invité prises en charge, consultez Versions du système d'exploitation invité d'Azure et matrice de compatibilité du Kit de développement logiciel (SDK).

Si vous n’incluez pas de valeur osFamily et n’avez pas défini l’attribut osVersion sur une version du système d’exploitation invité spécifique, la valeur par défaut utilisée est 1.
osVersion facultatif. Spécifie la version du système d’exploitation invité qui s’exécute sur les instances de rôle dans le service cloud. Pour plus d’informations sur les versions du système d'exploitation invité, consultez Versions du système d'exploitation invité d'Azure et matrice de compatibilité du Kit de développement logiciel (SDK).

Vous pouvez spécifier que le système d’exploitation invité doit être automatiquement mis à niveau vers la dernière version. Pour ce faire, définissez la valeur de l’attribut osVersion sur *. Quand cette valeur est définie sur *, les instances de rôle sont déployées à l’aide de la dernière version du système d’exploitation invité pour la famille spécifiée de système d’exploitation. Elles sont aussi automatiquement mises à niveau dès que de nouvelles versions du système d’exploitation invité sont disponibles.

Pour indiquer une version spécifique manuellement, utilisez la colonne Configuration String du tableau de la section relative aux versions de SE invité futures, actuelles et de transition de la page Versions du SE invité et matrice de compatibilité du Kit de développement logiciel (SDK) Azure.

La valeur par défaut de l’attribut osVersion est *.
schemaVersion facultatif. Spécifie la version du schéma de configuration 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. Pour plus d’informations sur la compatibilité des schémas et des versions, consultez Versions du système d'exploitation invité d'Azure et matrice de compatibilité du Kit de développement logiciel (SDK).

Le fichier de configuration de service doit contenir un élément ServiceConfiguration. L’élément ServiceConfiguration peut inclure un nombre quelconque d’éléments Role et zéro ou 1 élément NetworkConfiguration.