Configurer des rôles Azure Cloud Services (support étendu) avec Visual Studio

Note

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) sera retiré 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) peut avoir un ou plusieurs rôles de travail ou web. Pour chaque rôle, vous devez définir la façon dont ce rôle est configuré et configurer également la façon dont ce rôle s’exécute.

Les informations de votre service cloud sont stockées dans les fichiers suivants :

• ServiceDefinition.csdef : le fichier de définition de service définit les paramètres d’exécution de votre service cloud, y compris les rôles requis, les points de terminaison et la taille de machine virtuelle. Aucune des données stockées dans ServiceDefinition.csdef ne peut être modifiée lorsque votre rôle est en cours d’exécution.
• ServiceConfiguration.cscfg : le fichier de configuration de service configure le nombre d’instances d’un rôle exécutées et les valeurs des paramètres définis pour un rôle. Les données stockées dans ServiceConfiguration.cscfg peuvent être modifiées pendant l’exécution de votre rôle.

Pour stocker différentes valeurs pour les paramètres qui contrôlent l’exécution d’un rôle, vous pouvez définir plusieurs configurations de service. Vous pouvez utiliser une configuration de service différente pour chaque environnement de déploiement. Par exemple, vous pouvez définir votre chaîne de connexion de compte de stockage pour utiliser l’émulateur de stockage Azure local dans une configuration de service local et créer une autre configuration de service pour utiliser Stockage Azure dans le cloud.

Lorsque vous créez un projet Azure Cloud Services (support étendu) dans Visual Studio, deux configurations de service sont automatiquement créées et ajoutées à votre projet Azure :

• ServiceConfiguration.Cloud.cscfg
• ServiceConfiguration.Local.cscfg

Conditions préalables

• Visual Studio (consultez [Téléchargements Visual Studio] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)) avec la charge de travail Développement Azure installée, ainsi que le composant individuel Modèles de projets et d’éléments .NET Framework installé. Consultez Modifier Visual Studio.
• Un compte Azure. Si vous n’avez pas de compte Azure, activez vos avantages Azure pour les abonnés Visual Studio ou inscrivez-vous à un essai gratuit.

Configurer un projet Azure Cloud Services (support étendu)

Vous pouvez configurer un projet Azure Cloud Services (support étendu) à partir de l’Explorateur de solutions dans Visual Studio, comme indiqué dans les étapes suivantes :

1. Créez ou ouvrez un projet Azure Cloud Services (support étendu) dans Visual Studio.

2. Dans l’Explorateur de solutions,faites un clic droit sur le projet, puis, dans le menu contextuel, sélectionnez Propriétés.

   

3. Dans la page des propriétés du projet, sélectionnez l’onglet Développement.

   page propriétés du projet

4. Dans la liste Configuration du service, sélectionnez le nom de la configuration de service que vous souhaitez modifier.

   

Modifier le nombre d’instances de rôle

Pour améliorer les performances de votre service cloud, vous pouvez modifier le nombre d’instances d’un rôle en cours d’exécution, en fonction du nombre d’utilisateurs ou de la charge attendue pour un rôle particulier. Une machine virtuelle distincte est créée pour chaque instance d’un rôle lorsque le service cloud s’exécute dans Azure. Cela affecte la facturation du déploiement de ce service cloud. Pour plus d’informations sur la facturation, consultez Comprendre votre facture pour Microsoft Azure.

1. Créez ou ouvrez un projet Azure Cloud Services (support étendu) dans Visual Studio.

2. Dans Explorateur de solutions, développez le nœud du projet. Sous le nœud Rôles, cliquez avec le bouton droit sur le rôle à mettre à jour, puis, dans le menu contextuel, sélectionnez Propriétés.

   

3. Sélectionnez l’onglet Configuration.

   

4. Dans la liste Configuration du service, sélectionnez la configuration du service que vous souhaitez mettre à jour. (Si vous souhaitez apporter des modifications à toutes les configurations de service pour ce rôle, sélectionnez Toutes les configurations.)

   Important

   Si vous choisissez une configuration de service spécifique, certaines propriétés sont désactivées, car elles ne peuvent être définies que pour toutes les configurations. Pour modifier ces propriétés, vous devez sélectionner Toutes les configurations.

   liste de configuration de service

5. Dans la zone de texte Nombre d’instances, entrez le nombre d’instances que vous voulez démarrer pour ce rôle. Chaque instance s’exécute sur une machine virtuelle distincte lorsque vous publiez le service cloud sur Azure.

   

6. Dans la barre d’outils Visual Studio, sélectionnez Enregistrer.

Gérer les chaînes de connexion pour les comptes de stockage

Vous pouvez ajouter, supprimer ou modifier des chaînes de connexion pour vos configurations de service. Vous pouvez également configurer une configuration de service cloud qui utilise un compte de stockage dans Azure.

Avertissement

Lorsque vous entrez les informations de clé de compte de stockage Azure pour une chaîne de connexion de compte de stockage, ces informations sont stockées localement dans le fichier de configuration du service. Toutefois, ces informations ne sont pas stockées en tant que texte chiffré.

En utilisant une valeur différente pour chaque configuration de service, vous n’avez pas besoin d’utiliser différentes chaînes de connexion dans votre service cloud ou de modifier votre code lorsque vous publiez votre service cloud sur Azure. Vous pouvez utiliser le même nom pour la chaîne de connexion dans votre code et la valeur est différente, en fonction de la configuration du service que vous sélectionnez lorsque vous générez votre service cloud ou lorsque vous la publiez.

1. Créez ou ouvrez un projet Azure Cloud Services (support étendu) dans Visual Studio.

2. Dans Explorateur de solutions, développez le nœud du projet. Sous le nœud Rôles, cliquez avec le bouton droit sur le rôle que vous souhaitez mettre à jour, puis, dans le menu contextuel, sélectionnez Propriétés.

   

3. Sélectionnez l’onglet Paramètres .

   

4. Dans la liste Configuration du service, sélectionnez la configuration du service que vous souhaitez mettre à jour.

   

5. Pour ajouter une chaîne de connexion, sélectionnez Ajouter un paramètre.

   

6. Une fois que le nouveau paramètre a été ajouté à la liste, mettez à jour la ligne de la liste avec les informations nécessaires.

   

   • Nom : entrez le nom que vous souhaitez utiliser pour la chaîne de connexion.
   • Tapez : sélectionnez la chaîne de connexion dans la liste déroulante.
   • Valeur : vous pouvez entrer la chaîne de connexion directement dans la cellule Valeur ou sélectionner les points de suspension (...) pour utiliser la boîte de dialogue Créer une chaîne de connexion de stockage.

7. Dans la boîte de dialogue Créer une chaîne de connexion de stockage, sélectionnez une option pour Se connecter avec. Suivez ensuite les instructions de l’option que vous sélectionnez :

   • l’émulateur de stockage Microsoft Azure : si vous sélectionnez cette option, les autres paramètres de la boîte de dialogue sont désactivés, car ils s’appliquent uniquement à Azure. Sélectionnez OK.
   • votre abonnement - Si vous sélectionnez cette option, utilisez la liste déroulante pour sélectionner et vous connecter à un compte Microsoft ou ajouter un compte Microsoft. Sélectionnez un abonnement Azure et un compte de stockage. Sélectionnez OK.
   • Informations d’identification entrées manuellement : entrez le nom du compte de stockage, ainsi que la clé primaire ou secondaire. Sélectionnez une option pour connexion (HTTPS est recommandé pour la plupart des scénarios.) Sélectionnez OK.

8. Pour supprimer une chaîne de connexion, sélectionnez la chaîne de connexion, puis sélectionnez Supprimer le paramètre.

9. Dans la barre d’outils Visual Studio, sélectionnez Enregistrer.

Accéder par programmation à une chaîne de connexion

Les étapes suivantes montrent comment accéder par programmation à une chaîne de connexion à l’aide de C#.

1. En utilisant les directives, ajoutez le contenu suivant dans un fichier en C# dans lequel vous allez utiliser le paramètre :

   using Microsoft.WindowsAzure;
   using Microsoft.WindowsAzure.Storage;
   using Microsoft.WindowsAzure.ServiceRuntime;
   

2. Le code suivant illustre un exemple d’accès à une chaîne de connexion. Remplacez l’espace réservé <ConnectionStringName> par la valeur appropriée.

   // Setup the connection to Azure Storage
   var storageAccount = CloudStorageAccount.Parse(RoleEnvironment.GetConfigurationSettingValue("<ConnectionStringName>"));
   

Ajouter des paramètres personnalisés à utiliser dans votre projet Azure Cloud Services (support étendu)

Les paramètres personnalisés dans le fichier de configuration de service vous permettent d’ajouter un nom et une valeur pour une chaîne pour une configuration de service spécifique. Vous pouvez choisir d’utiliser ce paramètre pour configurer une fonctionnalité dans votre service cloud en lisant la valeur du paramètre et en utilisant cette valeur pour contrôler la logique dans votre code. Vous pouvez modifier ces valeurs de configuration de service sans avoir à reconstruire votre package de service ou lorsque votre service cloud est en cours d’exécution. Votre code peut vérifier les notifications de la modification d’un paramètre. Pour plus d’informations, consultez RoleEnvironment.Changing Event.

Vous pouvez ajouter, supprimer ou modifier des paramètres personnalisés pour vos configurations de service. Vous souhaiterez peut-être des valeurs différentes pour ces chaînes pour différentes configurations de service.

En utilisant une valeur différente pour chaque configuration de service, vous n’avez pas besoin d’utiliser différentes chaînes dans votre service cloud ou de modifier votre code lorsque vous publiez votre service cloud sur Azure. Vous pouvez utiliser le même nom pour la chaîne dans votre code et la valeur est différente, en fonction de la configuration du service que vous sélectionnez lorsque vous générez votre service cloud ou lorsque vous la publiez.

1. Créez ou ouvrez un projet Azure Cloud Services (support étendu) dans Visual Studio.

2. Dans Explorateur de solutions, développez le nœud du projet. Sous le nœud Rôles, cliquez avec le bouton droit sur le rôle que vous souhaitez mettre à jour, puis, dans le menu contextuel, sélectionnez Propriétés.

   

3. Sélectionnez l’onglet Paramètres .

   onglet Paramètres

4. Dans la liste Configuration du service, sélectionnez la configuration du service que vous souhaitez mettre à jour.

   liste de configuration de service

5. Pour ajouter un paramètre personnalisé, sélectionnez Ajouter un paramètre.

   

6. Une fois que le nouveau paramètre a été ajouté à la liste, mettez à jour la ligne de la liste avec les informations nécessaires.

   

   • Nom : entrez le nom du paramètre.
   • Type / Sélectionnez Chaîne dans la liste déroulante.
   • Valeur : entrez la valeur du paramètre. Vous pouvez entrer directement la valeur dans la cellule Valeur ou sélectionner les points de suspension (...) pour entrer la valeur dans la boîte de dialogue Modifier la chaîne.

7. Pour supprimer un paramètre personnalisé, sélectionnez le paramètre, puis sélectionnez Supprimer le paramètre.

8. Dans la barre d’outils Visual Studio, sélectionnez Enregistrer.

Accéder par programmation à la valeur d’un paramètre personnalisé

Les étapes suivantes montrent comment accéder par programmation à un paramètre personnalisé à l’aide de C#.

1. En utilisant les directives, ajoutez le contenu suivant dans un fichier en C# dans lequel vous allez utiliser le paramètre :

   using Microsoft.WindowsAzure;
   using Microsoft.WindowsAzure.Storage;
   using Microsoft.WindowsAzure.ServiceRuntime;
   

2. Le code suivant illustre un exemple d’accès à un paramètre personnalisé. Remplacez l’espace réservé <SettingName> par la valeur appropriée.

   var settingValue = RoleEnvironment.GetConfigurationSettingValue("<SettingName>");
   

Gérer le stockage local pour chaque instance de rôle

Vous pouvez ajouter un stockage de système de fichiers local pour chaque instance d’un rôle. Les données stockées dans ce stockage ne sont pas accessibles par d’autres instances du rôle pour lesquelles les données sont stockées ou par d’autres rôles.

1. Créez ou ouvrez un projet Azure Cloud Services (support étendu) dans Visual Studio.

2. Dans Explorateur de solutions, développez le nœud du projet. Sous le nœud Rôles, cliquez avec le bouton droit sur le rôle que vous souhaitez mettre à jour, puis, dans le menu contextuel, sélectionnez Propriétés.

   

3. Sélectionnez l’onglet Stockage local.

   

4. Dans la liste Configuration du service, vérifiez que Toutes les Configurations sont sélectionnées, car les paramètres de stockage locaux s’appliquent à toutes les configurations de service. Toute autre valeur entraîne la désactivation de tous les champs d’entrée de la page.

   liste de configuration de service

5. Pour ajouter une entrée de stockage local, sélectionnez Ajouter le stockage local.

   

6. Une fois la nouvelle entrée de stockage locale ajoutée à la liste, mettez à jour la ligne de la liste avec les informations nécessaires.

   

   • Nom : entrez le nom que vous souhaitez utiliser pour le nouveau stockage local.
   • Taille (Mo) : entrez la taille en Mo dont vous avez besoin pour le nouveau stockage local.
   • Nettoyer lors du recyclage du rôle : sélectionnez cette option pour supprimer les données du nouveau stockage local lorsque la machine virtuelle du rôle est recyclée.

7. Pour supprimer une entrée de stockage local, sélectionnez l’entrée, puis sélectionnez Supprimer le stockage local.

8. Dans la barre d’outils Visual Studio, sélectionnez Enregistrer.

Accès par programmation au stockage local

Cette section montre comment accéder par programmation au stockage local à l’aide de C# en écrivant un fichier texte de test MyLocalStorageTest.txt.

Écrire un fichier texte dans le stockage local

Le code suivant montre un exemple d’écriture d’un fichier texte dans le stockage local. Remplacez l’espace réservé <LocalStorageName> par la valeur appropriée.

// Retrieve an object that points to the local storage resource
LocalResource localResource = RoleEnvironment.GetLocalResource("<LocalStorageName>");

//Define the file name and path
string[] paths = { localResource.RootPath, "MyLocalStorageTest.txt" };
String filePath = Path.Combine(paths);

using (FileStream writeStream = File.Create(filePath))
{
    Byte[] textToWrite = new UTF8Encoding(true).GetBytes("Testing Web role storage");
    writeStream.Write(textToWrite, 0, textToWrite.Length);
}

Rechercher un fichier écrit dans le stockage local

Pour afficher le fichier créé par le code dans la section précédente, procédez comme suit :

1. Dans la zone de notification Windows, cliquez avec le bouton droit sur l’icône Azure et, dans le menu contextuel, sélectionnez Afficher l’interface utilisateur de l’émulateur de calcul.

   

2. Sélectionnez le rôle Web.

   

3. Dans le menu de l’émulateur de calcul Microsoft Azure, sélectionnez Tools>Ouvrir le magasin local.

   

4. Lorsque la fenêtre de l’Explorateur Windows s’ouvre, entrez «MyLocalStorageTest.txt» dans la zone de texte Recherche, puis sélectionnez Entrer pour démarrer la recherche.

Contenu connexe

En savoir plus sur les projets Azure dans Visual Studio en lisant Configuration d'un projet Azure. En savoir plus sur le schéma du service cloud en lisant référence de schéma.