Modèle de configuration dans Azure In-Role Cache

Important

Microsoft recommande tous les nouveaux développements à l’aide du Cache Redis Azure. Pour obtenir de la documentation et des conseils actuels sur le choix d’une offre Azure Cache, consultez Quelle offre Azure Cache est adaptée à moi ?

Cette rubrique décrit l’utilisation de fichiers de configuration dans Microsoft Azure Cache. Il existe deux types de paramètres de configuration.

1. Configuration du rôle

2. Configuration client

Configuration du rôle

In-Role Cache prend en charge la possibilité d’héberger la mise en cache au sein d’un rôle Azure. Ce type de mise en cache est configuré dans le cadre d’un service cloud. En règle générale, cela est effectué dans Visual Studio.

Notes

Les paramètres de configuration décrits dans cette section s’appliquent uniquement au cache de In-Role en fonction du rôle. Shared Caching prend en charge l’accès uniquement au default cache. Shared Caching ne prend pas en charge la modification des propriétés du default cache.

Pour comprendre les paramètres de configuration, il est utile de mettre en corrélation ces paramètres avec les options d’interface utilisateur dans Visual Studio. La capture d'écran suivante affiche une portion de l'onglet Mise en cache de la boîte de dialogue des propriétés du rôle.

Outre l’activation du cache In-Role, vous pouvez également créer un ou plusieurs caches nommés. Chaque cache spécifie ses propres propriétés. La capture d'écran suivante affiche cette portion de l'onglet des propriétés de Mise en cache.

Ces sélections d'interface utilisateur sont stockées dans des fichiers de configuration. Tout d’abord, le module de mise en cache est chargé dans la section Importations du fichier ServiceDefinition.csdef. L'extrait de code XML suivant affiche cette ligne.

<Import moduleName="Caching" />

Tous les autres paramètres de cache In-Role sont stockés dans le fichier ServiceConfiguration.cscfg. Par exemple, voici les paramètres du fichier ServiceConfiguration.cscfg pour les sélections de l'onglet Mise en cache précédemment affichées.

  <Role name="WebRole1">
    <Instances count="2" />
    <ConfigurationSettings>
      <Setting name="Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString" value="UseDevelopmentStorage=true" />
      <Setting name="Microsoft.WindowsAzure.Plugins.Caching.NamedCaches" value="{&quot;caches&quot;:[{&quot;name&quot;:&quot;NamedCache1&quot;,&quot;policy&quot;:{&quot;eviction&quot;:{&quot;type&quot;:0},&quot;expiration&quot;:{&quot;defaultTTL&quot;:20,&quot;isExpirable&quot;:true,&quot;type&quot;:2},&quot;serverNotification&quot;:{&quot;isEnabled&quot;:true}},&quot;secondaries&quot;:1},{&quot;name&quot;:&quot;NamedCache2&quot;,&quot;policy&quot;:{&quot;eviction&quot;:{&quot;type&quot;:-1},&quot;expiration&quot;:{&quot;defaultTTL&quot;:25,&quot;isExpirable&quot;:true,&quot;type&quot;:1},&quot;serverNotification&quot;:{&quot;isEnabled&quot;:false}},&quot;secondaries&quot;:0}]}" />
      <Setting name="Microsoft.WindowsAzure.Plugins.Caching.Loglevel" value="" />
      <Setting name="Microsoft.WindowsAzure.Plugins.Caching.CacheSizePercentage" value="30" />
      <Setting name="Microsoft.WindowsAzure.Plugins.Caching.ConfigStoreConnectionString" value="UseDevelopmentStorage=true" />
    </ConfigurationSettings>
  </Role>

Dans cette configuration de rôle, la plupart des paramètres de cache In-Role ont une corrélation simple aux options sous l’onglet Mise en cache . Toutefois, le Microsoft.WindowsAzure.Plugins.Caching.NamedCaches paramètre est plus difficile à lire. Il utilise la syntaxe JSON pour décrire les propriétés de chaque cache nommé et les guillemets doubles sont remplacés par ". Pour plus d’informations sur les paramètres de configuration de rôle, consultez La Paramètres de configuration du rôle dans le cache de rôle (ServiceConfiguration.cscfg).

Configuration client

Un client de cache est n’importe quel code d’application qui accède à un cache Azure. Dans le code, chaque client de cache est associé à un objet DataCacheFactory . La fabrique retourne un objet DataCache utilisé pour accéder au cache. Les paramètres réels du client de cache peuvent être chargés à partir d'un fichier de configuration web.config ou d'un fichier de configuration d'application.

L’exemple suivant illustre les sections pertinentes pour configurer une section dataCacheClient nommée default dans un fichier de configuration. Cela est spécifique au cache de In-Role basé sur les rôles.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <configSections>
    <section name="dataCacheClients" type="Microsoft.ApplicationServer.Caching.DataCacheClientsSection, Microsoft.ApplicationServer.Caching.Core" allowLocation="true" allowDefinition="Everywhere" />
  </configSections>
  <dataCacheClients>
    <tracing sinkType="DiagnosticSink" traceLevel="Error" />
    <dataCacheClient name="default">
      <autoDiscover isEnabled="true" identifier="WebRole1" />
    </dataCacheClient>
  </dataCacheClients>
</configuration>

Pour plus d’informations sur ces paramètres de configuration du client, consultez La Paramètres de configuration du client dans le cache en rôle (Web.config).. Pour obtenir une procédure pas à pas qui montre comment configurer les clients du cache de In-Role en fonction du rôle, consultez Guide pratique pour utiliser le Kit de développement logiciel (SDK) Azure In-Role Cache.

Voir aussi

Concepts

Fonctionnalités de In-Role Cache dans Azure Cache
Paramètres de configuration de rôle In-Role Cache (ServiceConfiguration.cscfg)
Paramètres de configuration de client In-Role Cache (Web.config)