Exporter (0) Imprimer
Développer tout

Schéma de configuration du service Windows Azure (fichier .cscfg)

Mis à jour: février 2014

Ce fichier 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 numériques des certificats associés à un rôle. Si le service fait partie d’un réseau virtuel, les données de configuration du réseau doivent être fournies dans le fichier de configuration du service, ainsi que dans le fichier de configuration du réseau virtuel. L'extension par défaut pour le fichier de configuration du service est .cscfg.

Le modèle de service est décrit par le Schéma de définition du service Windows Azure (fichier .csdef).

Par défaut, le fichier du schéma de configuration des diagnostics Windows 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 de Windows Azure.

Pour plus d’informations sur la configuration de rôles dans un service, consultez la rubrique Procédure : configuration des rôles pour une application Windows Azure avec Visual Studio.

Le format de base du fichier de configuration de service est le suivant.


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

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

L'espace de noms XML du fichier de configuration du service est :

http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceConfiguration

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

Le tableau suivant décrit les attributs de l'élément ServiceConfiguration. Toutes les valeurs des attributs sont du type chaîne.

 

Attribut Description

serviceName

Obligatoire. Nom du service cloud. Le nom fourni ici doit correspondre au nom spécifié dans le fichier de définition du service.

osFamily

Ce paramètre est facultatif. Spécifie le système d’exploitation invité qui sera exécuté sur des 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 la rubrique Versions du système d’exploitation invité de Windows Azure et matrice de compatibilité du Kit de développement logiciel (SDK).

Si vous n’incluez pas de valeur osFamily et si vous n’avez pas défini l’attribut osVersion sur une version spécifique du système d’exploitation invité, la valeur par défaut 1 est utilisée.

osVersion

Ce paramètre est facultatif. Spécifie la version du système d’exploitation invité qui sera exécutée sur des instances de rôle dans le service cloud. Pour plus d’informations sur les versions du système d’exploitation invité, consultez la rubrique Versions du système d’exploitation invité de Windows Azure et matrice de compatibilité du Kit de développement logiciel (SDK).

Vous pouvez indiquer que le système d’exploitation invité doit être mis à niveau automatiquement vers la version la plus récente. Pour ce faire, définissez la valeur de l’attribut osVersion sur *. Si vous définissez la valeur sur *, les instances de rôle sont déployées à l’aide de la version la plus récente du système d’exploitation invité pour la famille de systèmes d’exploitation spécifiée, et seront automatiquement mises à niveau lorsque de nouvelles versions du système d’exploitation invité seront disponibles.

Pour spécifier une version particulière manuellement, utilisez la Configuration String figurant dans le tableau de la section Versions transitoire, actuelle et future du système d’exploitation invité de la rubrique Versions du système d’exploitation invité de Windows Azure et matrice de compatibilité du Kit de développement logiciel (SDK).

La valeur par défaut de l'attribut osVersion est *.

schemaVersion

Ce paramètre est facultatif. Spécifie la version du schéma de configuration du service. La version du schéma permet à Visual Studio de sélectionner les outils du Kit de développement logiciel appropriés pour la validation du schéma si plusieurs versions du Kit sont installées côte à côte. Pour plus d’informations sur les schémas et la compatibilité des versions, consultez la rubrique Versions du système d’exploitation invité de Windows Azure et matrice de compatibilité du Kit de développement logiciel (SDK).

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

Afficher:
© 2014 Microsoft