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

Article
06/01/2023

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 pour le réseau doivent être fournies dans le fichier de configuration de service, ainsi que dans le fichier de configuration de réseau virtuel. L’extension par défaut du fichier de configuration de service est cscfg.

Le modèle de service est décrit par le Schéma de définition 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.

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écutera 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 de 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écutera 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 de système d’exploitation spécifiée, et elles seront automatiquement mises à niveau dès que de nouvelles versions du système d’exploitation invité seront 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.

Voir aussi

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

Share via