Configuration de votre projet Azure dans Visual Studio pour utiliser plusieurs configurations de service

Remarque

Cet article s’applique à Azure Azure Cloud Services (support étendu). Cloud Services (classique) est mis hors service depuis le 31 août 2024. Pour plus d’informations, consultez le modèle de déploiement de services cloud (classique) , qui sera arrêté le 31 août 2024. Pour le nouveau développement, nous vous recommandons d’utiliser un type de service plus récent conçu à des fins spécifiques, comme Azure App Service, azure Functionsou Azure Container Apps. Pour obtenir la liste la plus récente des services disponibles, consultez Directory des produits Azure.

Un projet Azure Cloud Services (support étendu) dans Visual Studio comprend trois fichiers de configuration : ServiceDefinition.csdef, ServiceConfiguration.Local.cscfget ServiceConfiguration.Cloud.cscfg:

• ServiceDefinition.csdef est déployé sur Azure pour décrire les exigences du service cloud et de ses rôles, et fournir des paramètres qui s’appliquent à toutes les instances. Les paramètres peuvent être lus au moment de l’exécution à l’aide de l’API Azure Service Hosting Runtime. Ce fichier peut être mis à jour sur Azure uniquement lorsque le service cloud est arrêté.
• ServiceConfiguration.Local.cscfg et ServiceConfiguration.Cloud.cscfg fournissez des valeurs pour les paramètres dans le fichier de définition et spécifiez le nombre d’instances à exécuter pour chaque rôle. Le fichier « Local » contient des valeurs utilisées dans le débogage local ; le fichier « Cloud » est déployé sur Azure en tant que ServiceConfiguration.cscfg et fournit des paramètres pour l’environnement serveur. Ce fichier peut être mis à jour pendant l’exécution de votre service cloud dans Azure.

Les paramètres de configuration sont gérés et modifiés dans Visual Studio à l’aide de pages de propriétés pour le rôle applicable (cliquez avec le bouton droit sur le rôle, puis sélectionnez Propriétés, ou double-cliquez sur le rôle). Les modifications peuvent être limitées à la configuration du service choisie dans la liste déroulante. Les propriétés des rôles web et de travail sont similaires, sauf si elles sont décrites dans les sections suivantes.

Pour plus d’informations sur les schémas sous-jacents pour les fichiers de configuration de service et de définition de service, consultez les articles .csdef XML Schema et schéma XML .cscfg. Pour plus d’informations sur la configuration du service, consultez How to Configure Cloud Services.

Page de configuration

Configuration du service

Sélectionne le fichier ServiceConfiguration.*.cscfg affecté par les modifications. Par défaut, il existe des variantes locales et cloud, et vous pouvez utiliser la commande Gérer... pour copier, renommer et supprimer des fichiers de configuration. Ces fichiers sont ajoutés à votre projet de service cloud et apparaissent dans Explorateur de solutions. Toutefois, le changement de nom ou la suppression des configurations ne peut être effectué que dans ce contrôle.

Exemples

Définissez la propriété Instance count sur le nombre d’instances que le service doit exécuter pour ce rôle.

Action de démarrage (rôle web uniquement)

Définissez cette propriété pour spécifier que Visual Studio doit lancer un navigateur web pour les points de terminaison HTTP ou les points de terminaison HTTPS, ou les deux lorsque vous démarrez le débogage.

L’option point de terminaison HTTPS est disponible uniquement si vous avez déjà défini un point de terminaison HTTPS pour votre rôle. Vous pouvez définir un point de terminaison HTTPS sur la page de propriétés Points de terminaison.

Si vous avez déjà ajouté un point de terminaison HTTPS, l’option de point de terminaison HTTPS est activée par défaut et Visual Studio lance un navigateur pour ce point de terminaison lorsque vous démarrez le débogage, en plus d’un navigateur pour votre point de terminaison HTTP, en supposant que les deux options de démarrage sont activées.

Page des paramètres

Dans la page Paramètres, vous pouvez ajouter des paramètres à une configuration en tant que paires nom-valeur. Le code exécuté dans le rôle peut lire les valeurs de vos paramètres de configuration au moment de l’exécution à l’aide de classes fournies par la Bibliothèque managée Azure, en particulier la méthode GetConfigurationSettingValue.

Configuration d’une chaîne de connexion pour un compte de stockage

Une chaîne de connexion est un paramètre qui fournit des informations de connexion et d’authentification pour l’émulateur de stockage ou pour un compte de stockage Azure. Chaque fois que le code d’un rôle accède au stockage Azure (objets blob, files d’attente ou tables), il a besoin d’une chaîne de connexion.

Remarque

Une chaîne de connexion pour un compte de stockage Azure doit utiliser un format défini (consultez Configurer des chaînes de connexion de stockage Azure).

Vous pouvez définir la chaîne de connexion pour utiliser le stockage local si nécessaire, puis la modifier pour utiliser un compte de stockage Azure lorsque vous déployez l'application sur le service cloud. L’échec de la définition correcte de la chaîne de connexion peut empêcher votre rôle de démarrer ou de passer par les états d’initialisation, d’activité, et d’arrêt.

Pour créer une chaîne de connexion, sélectionnez Ajouter un paramètre et définissez Type sur « Chaîne de connexion ».

Pour les chaînes de connexion nouvelles ou existantes, sélectionnez ...* à droite du champ Valeur pour ouvrir la boîte de dialogue Créer une chaîne de connexion de stockage :

1. Sous Se connecter en utilisant, sélectionnez l'option Votre abonnement pour sélectionner un compte de stockage à partir d'un abonnement. Visual Studio obtient ensuite les informations d’identification du compte de stockage automatiquement à partir du fichier .publishsettings.
2. Sélectionner les identifiants saisis manuellement vous permet de spécifier directement le nom et la clé du compte en utilisant les informations du portail Azure. Pour copier la clé de compte :
   1. Accédez au compte de stockage sur le portail Azure et sélectionnez Gérer les clés.
   2. Pour copier la clé de compte, accédez au compte de stockage sur le portail Azure, sélectionnez Paramètres > clés d’accès, puis utilisez le bouton copier pour copier la clé d’accès primaire dans le Presse-papiers.
3. Sélectionnez l’une des options de connexion. Spécifier des points de terminaison personnalisés vous demande de spécifier des URL spécifiques pour les objets blob, les tables et les files d’attente. Les points de terminaison personnalisés vous permettent d'utiliser des domaines personnalisés et de contrôler plus précisément l'accès. Voir Configuration des chaînes de connexion du Stockage Azure.
4. Sélectionnez OK, puis Fichier > Enregistrer pour mettre à jour la configuration avec la nouvelle chaîne de connexion.

Là encore, lorsque vous publiez votre application sur Azure, choisissez la configuration du service qui contient le compte stockage Azure pour la chaîne de connexion. Une fois votre application publiée, vérifiez que l’application fonctionne comme prévu sur les services stockage Azure.

Pour plus d’informations sur la mise à jour des configurations de service, consultez la section Gérer les chaînes de connexion pour les comptes de stockage.

Page des Endpoints

Un rôle web a généralement un point de terminaison HTTP unique sur le port 80. Un rôle de travailleur, en revanche, peut avoir n’importe quel nombre de points de terminaison HTTP, HTTPS ou TCP. Les points de terminaison peuvent être des points de terminaison d’entrée, qui sont disponibles pour des clients externes ou des points de terminaison internes, qui sont disponibles pour d’autres rôles qui s’exécutent dans le service.

• Pour rendre un point de terminaison HTTP disponible pour les clients externes et les navigateurs web, remplacez le type de point de terminaison par entrée, puis spécifiez un nom et un numéro de port public.
• Pour rendre un point de terminaison HTTPS disponible pour les clients externes et les navigateurs web, remplacez le type de point de terminaison par d’entrée, puis spécifiez un nom, un numéro de port public et un nom de certificat de gestion. Vous devez également définir le certificat dans la page de propriétés Certificats avant de pouvoir spécifier un certificat de gestion.
• Pour rendre un point de terminaison disponible pour l’accès interne par d’autres rôles dans le service cloud, remplacez le type de point de terminaison par interne et spécifiez un nom et des ports privés possibles pour ce point de terminaison.

Page de stockage local

Vous pouvez utiliser la page des propriétés de stockage local pour réserver une ou plusieurs ressources de stockage local pour un rôle. Une ressource de stockage locale est un répertoire réservé dans le système de fichiers de la machine virtuelle Azure dans laquelle une instance d’un rôle est en cours d’exécution.

Page des Certificats

La page de propriétés Certificats ajoute des informations sur vos certificats à votre configuration de service. Notez que vos certificats ne sont pas empaquetés avec votre service ; vous devez charger vos certificats séparément sur Azure via le portail Azure .

L’ajout d’un certificat ici ajoute des informations sur vos certificats à votre configuration de service. Les certificats ne sont pas empaquetés avec le service ; vous devez charger vos certificats séparément via le portail Azure.

Pour associer un certificat à votre rôle, indiquez un nom pour le certificat. Vous utilisez ce nom pour faire référence au certificat lorsque vous configurez un point de terminaison HTTPS sur la page Points de terminaison. Ensuite, spécifiez si le magasin de certificats est ordinateur local ou utilisateur actuel et le nom du magasin. Enfin, entrez l’empreinte numérique du certificat. Si le certificat se trouve dans le magasin Current User\Personal (My), vous pouvez entrer l’empreinte numérique du certificat en sélectionnant le certificat dans une liste remplie. S'il se trouve à un autre emplacement, entrez la valeur de l'empreinte numérique à la main.

Lorsque vous ajoutez un certificat à partir du magasin de certificats, tous les certificats intermédiaires sont automatiquement ajoutés aux paramètres de configuration pour vous. De plus, ces certificats intermédiaires doivent être chargés sur Azure pour configurer correctement votre service pour SSL.

Les certificats de gestion que vous associez à votre service s’appliquent à votre service uniquement lorsqu’il s’exécute dans le cloud. Lorsque votre service s’exécute dans l’environnement de développement local, il utilise un certificat standard géré par l’émulateur de calcul.