Migrieren aus Shared Caching in Azure Managed Cache Service

Das Migrieren Ihrer Anwendungen, die Microsoft Azure Shared Caching verwenden, um Managed Cache Service zu Managed Cache Service, können mit minimalen Änderungen an Ihrer Anwendung erreicht werden. Da Managed Cache Service die meisten der gleichen API wie Shared Caching verwendet, können vorhandene Code, der Shared Caching zum Zugriff auf einen Cache verwendet, mit Managed Cache Service wiederverwendet werden. In diesem Thema wird gezeigt, wie Sie die erforderlichen Konfigurations- und Anwendungsänderungen vornehmen, um Ihre Shared Caching Anwendungen zu migrieren, um Managed Cache Service zu verwenden.

Schritte bei der Migration

In den folgenden Abschnitten werden die Schritte beschrieben, die zum Migrieren einer Microsoft Azure Shared Caching Anwendung erforderlich sind, um Managed Cache Service zu verwenden.

• Auswählen eines Cacheangebots

• Erstellen eines Caches

• Konfigurieren des Caches

• Konfigurieren der Cacheclients

  • Entfernen der Konfiguration für Shared Caching

  • Konfigurieren eines Cacheclients mithilfe des NuGet-Pakets Caching

• Migrieren von ASP.NET-Sitzungs- und Seitenausgabe-Caching

Auswählen eines Cacheangebots

Managed Cache Service ist in den folgenden drei Angeboten verfügbar.

• Basic: Cache mit einer Größe von 128 MB bis 1 GB, der in 128-MB-Schritten vergrößert werden kann, mit einem benannten Standardcache

• Standard – Cachegrößen von 1 GB bis zu 10 GB in Inkrementen von 1 GB mit Unterstützung für Benachrichtigungen, Hochverfügbarkeit und bis zu zehn benannten Standardcaches

• Premium: Cache mit einer Größe von 5 GB bis 150 GB, der in 5-GB-Schritten vergrößert werden kann und Benachrichtigungen, Hochverfügbarkeit sowie bis zu zehn benannte Caches unterstützt

Alle Cachefeatures von Shared Caching sind in allen drei Managed Cache Service Angeboten verfügbar, daher ist ein Ausgangspunkt für die Migration das Managed Cache Service Cacheangebot, das der Größe Ihres Shared Caching Kontos entspricht. Nachdem Sie die Anwendung bereitgestellt haben, können Sie die Leistung Ihres Caches überwachen und je nach den Anforderungen Ihrer Anwendung nach oben oder unten skalieren. Weitere Informationen zur Überwachung der Leistung und Skalierung finden Sie unter Überwachen von Azure Managed Cache Service und Skalieren eines Caches für Azure Managed Cache Service.

Erstellen eines Caches

Cacheinstanzen in Managed Cache Service werden mithilfe von PowerShell-Skripts erstellt.

So erstellen Sie eine Managed Cache Service Instanz

1. Öffnen Sie ein Azure PowerShell-Befehlsfenster.

   Hinweis

   Weitere Informationen zur Installation und Verwendung von Azure PowerShell finden Sie unter Installieren und Konfigurieren von Azure PowerShell.

2. Rufen Sie das Cmdlet Add-AzureAccount auf, und geben Sie die Ihrem Konto zugeordnete E-Mail-Adresse und Ihr Kennwort ein.

   Hinweis

   Falls Sie Azure PowerShell mit einem Zertifikat für Ihr Konto verknüpft haben, können Sie diesen Schritt überspringen. Weitere Informationen zum Herstellen einer Verbindung zwischen Azure PowerShell und Ihrem Azure-Konto finden Sie unter Installieren und Konfigurieren von Azure PowerShell.

3. Rufen Sie das Cmdlet New-AzureManagedCache auf, und geben Sie den Namen, die Region, das Cacheangebot und Größe des Caches an. Im folgenden Beispiel wird ein Cache mit 128 MB des Typs Basic mit dem Namen contosocache in der geografischen Region South Central US erstellt.

   New-AzureManagedCache -Name contosocache -Location "South Central US" -Sku Basic -Memory 128MB
   

   Hinweis

   Eine vollständige Liste der Parameter und Werte für die Erstellung von Caches finden Sie in der Dokumentation zum Cmdlet New-AzureManagedCache .

4. Nach dem Aufrufen des PowerShell-Cmdlets dauert das Erstellen des Caches ggf. einige Minuten. Nachdem der Cache erstellt wurde, verfügt Ihr neuer Cache über einen Status "Ausführen " und ist für die Verwendung mit Standardeinstellungen bereit und kann im Azure-Verwaltungsportal angezeigt und konfiguriert werden.

   Sie können den Erstellungsstatus im Azure PowerShell-Fenster überwachen. Sobald der Cache einsatzbereit ist, zeigt das Cmdlet New-AzureManagedCache die Cacheinformationen wie im folgenden Beispiel gezeigt an.

   PS C:\> Add-AzureAccount
   VERBOSE: Account "user@domain.com" has been added.
   VERBOSE: Subscription "MySubscription" is selected as the default subscription.
   VERBOSE: To view all the subscriptions, please use Get-AzureSubscription.
   VERBOSE: To switch to a different subscription, please use Select-AzureSubscription.
   PS C:\> New-AzureManagedCache -Name contosocache -Location "South Central US" -Sku Basic -Memory 128MB
   VERBOSE: Intializing parameters...
   VERBOSE: Creating prerequisites...
   VERBOSE: Verify cache service name...
   VERBOSE: Creating cache service...
   VERBOSE: Waiting for cache service to be in ready state...
   
   
   Name     : contosocache
   Location : South Central US
   State    : Active
   Sku      : Basic
   Memory   : 128MB
   
   
   
   PS C:\>
   

Konfigurieren des Caches

Managed Cache Service unterstützt benannte Caches, die Ihnen die Flexibilität bieten, unterschiedliche Cacheoptionen für unterschiedliche Datensätze zu konfigurieren. Jeder Cache besitzt einen benannten Standardcache. In den Standard- und Premium-Cacheangeboten können bis zu neun weitere benannte Caches konfiguriert werden. Jeder benannte Cache weist jeweils eigene Einstellungen auf, z. B. Hochverfügbarkeit, Benachrichtigungen und benutzerdefinierte Entfernungs- und Ablaufrichtlinien. Die Einstellungen benannter Caches werden im Verwaltungsportal auf der Registerkarte Konfigurieren für den Cache konfiguriert.

In der folgenden Tabelle sind die Unterschiede in den Cacheeinstellungen zwischen Managed Cache Service und Shared Caching aufgeführt.

Wenn Sie Managed Cache Service Einstellungen so konfigurieren möchten, dass sie den Standardeinstellungen Shared Caching am besten entsprechen, verwenden Sie die folgenden Einstellungen.

• Ablaufrichtlinie wird auf Absolut festgelegt.

• Zeit (Min.) wird auf 1440 festgelegt.

• Benachrichtigungen wird auf Deaktiviert festgelegt (für die Standard- und Premium-Cacheangebote konfigurierbar, für das Basiscacheangebot immer deaktiviert).

• High Availability set to Disabled (Konfigurierbar für die Standard- und Premium Cacheangebote, immer deaktiviert für das Standardcacheangebot)

• Entfernung wird auf Aktiviert festgelegt.

Konfigurieren der Cacheclients

Sobald der Cache erstellt und konfiguriert wurde, besteht der nächste Schritt darin, die erforderliche Konfiguration und Verweise hinzuzufügen, damit Cacheclients auf den Cache zugreifen können. Managed Cache Service unterstützt die folgenden Clients.

• Azure-Webseiten

• Azure Cloud Services-Webrolle und -Workerrolle

• Azure Virtual Machines

Führen Sie zum Konfigurieren der Cacheclients die folgenden Schritte für jeden Cacheclient aus.

• Entfernen der Konfiguration für Shared Caching

• Konfigurieren eines Cacheclients mithilfe des NuGet-Pakets Caching

Entfernen der Konfiguration für Shared Caching

Bevor die Clientanwendungen für Managed Cache Service konfiguriert werden können, müssen die vorhandenen Shared Caching Konfigurations- und Assemblyverweise entfernt werden. Wenn Shared Caching mithilfe des Shared Caching NuGet-Pakets konfiguriert wurde, kann die Konfiguration durch Deinstallieren des Shared Caching NuGet-Pakets entfernt werden. Andernfalls muss es manuell entfernt werden.

• Deinstallieren des NuGet-Pakets für Shared Caching

• Manuelles Entfernen der Konfiguration für Shared Caching

Deinstallieren des NuGet-Pakets für Shared Caching

Um das Shared Caching NuGet-Paket zu deinstallieren, klicken Sie mit der rechten Maustaste auf das Clientprojekt in Projektmappen-Explorer, und wählen Sie "NuGet Pakete verwalten" aus. Wählen Sie den Knoten Installierte Pakete aus, und geben Sie dann Caching in das Feld Installierte Pakete suchen ein. Wählen Sie Azure Shared Caching aus, klicken Sie auf Deinstallieren, und klicken Sie dann auf Schließen.

Durch die Deinstallation des Shared Caching NuGet-Pakets werden die Shared Caching Assemblys und die Shared Caching Einträge in der app.config Clientanwendung web.config entfernt. Da einige angepasste Einstellungen ggf. bei der Deinstallation des NuGet-Pakets nicht entfernt werden, öffnen Sie die Datei web.config oder app.config, und stellen Sie sicher, dass die folgenden Elemente vollständig entfernt wurden.

• Vergewissern Sie sich, dass der Eintrag dataCacheClients aus dem Element configSections entfernt wurde. Entfernen Sie nicht das gesamte Element configSections, sondern nur den Eintrag dataCacheClients, falls vorhanden.

  <configSections>
    <!-- Existing sections omitted for clarity. -->
    <section name="dataCacheClients" type="Microsoft.ApplicationServer.Caching.DataCacheClientsSection, Microsoft.ApplicationServer.Caching.Core" allowLocation="true" allowDefinition="Everywhere" />
  </configSections>
  

• Vergewissern Sie sich, dass der Abschnitt dataCacheClients entfernt wurde. Der Abschnitt dataCacheClients sieht etwa wie im folgenden Beispiel aus.

  <dataCacheClients>
    <dataCacheClient name="default">
      <hosts>
        <host name="MyCacheNamespace.cache.windows.net" cachePort="22233" />
      </hosts>
  
      <securityProperties mode="Message">
        <messageSecurity 
          authorizationInfo="Your authorization token will be here.">
        </messageSecurity>
      </securityProperties>
    </dataCacheClient>
  </dataCacheClients>
  

Nachdem die Shared Caching Konfiguration entfernt wurde, können Sie den Cacheclient konfigurieren, wie im folgenden Abschnitt zum Konfigurieren eines Cacheclients mithilfe des Abschnitts "Zwischenspeichern NuGet Paket" beschrieben.

Manuelles Entfernen der Konfiguration für Shared Caching

Um die Shared Caching Konfiguration manuell zu entfernen, müssen Sie die Shared Caching Assemblyverweise und die Shared Caching Konfiguration aus app.config oder web.configentfernen.

Um die Shared Caching Assemblyverweise zu entfernen, wählen Sie das Cacheclientprojekt in Projektmappen-Explorer aus, und erweitern Sie den Ordner "Verweise". Klicken Sie für jede der Assemblys in der folgenden Liste im Projektmappen-Explorer mit der rechten Maustaste auf die Assembly im Ordner Verweise, und wählen Sie dann Entfernen aus. Wenn es sich bei dem Client um ein Webprojekt handelt, entfernen Sie auch Microsoft.Web.DistributedCache.

• Microsoft.ApplicationServer.Caching.Client

• Microsoft.ApplicationServer.Caching.Core

• Microsoft.WindowsFabric.Common

• Microsoft.WindowsFabric.Data.Common

Um die Shared Caching-Konfiguration zu entfernen, öffnen Sie das web.config Projekt app.config oder das Cacheclientprojekt, und entfernen Sie die folgenden beiden Elemente.

• Entfernen Sie den Eintrag dataCacheClients aus dem Element configSections. Entfernen Sie nicht das gesamte Element configSections, sondern nur den Eintrag dataCacheClients, falls vorhanden.

  <configSections>
    <!-- Existing sections omitted for clarity. -->
    <section name="dataCacheClients" type="Microsoft.ApplicationServer.Caching.DataCacheClientsSection, Microsoft.ApplicationServer.Caching.Core" allowLocation="true" allowDefinition="Everywhere" />
  </configSections>
  

• Entfernen Sie den Abschnitt dataCacheClients, der dem folgenden Beispiel ähnelt.

  <dataCacheClients>
    <dataCacheClient name="default">
      <hosts>
        <host name="MyCacheNamespace.cache.windows.net" cachePort="22233" />
      </hosts>
  
      <securityProperties mode="Message">
        <messageSecurity 
          authorizationInfo="Your authorization token will be here.">
        </messageSecurity>
      </securityProperties>
    </dataCacheClient>
  </dataCacheClients>
  

Nachdem diese Elemente entfernt wurden, können Sie die im nächsten Abschnitt beschriebenen Schritte ausführen, um den Cacheclient zu konfigurieren.

Konfigurieren eines Cacheclients mithilfe des NuGet-Pakets Caching

Managed Cache Service bietet ein NuGet Paket, um die erforderlichen Konfigurations- und Assemblyverweise hinzuzufügen, damit Cacheclients auf einen Cache zugreifen können.

Um das Managed Cache Service NuGet-Paket zu verwenden, klicken Sie mit der rechten Maustaste auf das Clientprojekt in Projektmappen-Explorer, und wählen Sie "NuGet Pakete verwalten" aus.

Wählen Sie Azure Caching aus, klicken Sie auf Installieren, und klicken Sie dann auf Ich stimme zu. Nachdem das Paket für das Clientprojekt installiert wurde, klicken Sie auf Schließen, um das Fenster NuGet-Pakete verwalten zu schließen.

Wenn das Managed Cache Service NuGet-Paket in einem Clientprojekt installiert ist, fügt es die erforderlichen Konfigurations- und Assemblyverweise hinzu, damit die Clientanwendung auf den Cache zugreifen kann.

In der Datei web.config oder app.config für das Clientprojekt werden mehrere Elemente hinzugefügt.

1. configSections werden zwei Abschnitte namens dataCacheClients und cacheDiagnostics hinzugefügt.

   <!-- Non-cache sections omitted for space -->
     <configSections>
       <section name="dataCacheClients" 
           type="Microsoft.ApplicationServer.Caching.DataCacheClientsSection, Microsoft.ApplicationServer.Caching.Core" 
           allowLocation="true" 
           allowDefinition="Everywhere" />
   
       <section name="cacheDiagnostics" 
           type="Microsoft.ApplicationServer.Caching.AzureCommon.DiagnosticsConfigurationSection, Microsoft.ApplicationServer.Caching.AzureCommon" 
           allowLocation="true" 
           allowDefinition="Everywhere" />
     </configSections>
   

2. Ein Abschnitt dataCacheClients wird dem Abschnitt configuration hinzugefügt.

   <!-- Non-cache sections omitted for space -->
     <dataCacheClients>
       <dataCacheClient name="default">
         <!--To use the in-role flavor of Azure Caching, set identifier to be the cache cluster role name -->
         <!--To use the Azure Caching Service, set identifier to be the endpoint of the cache cluster -->
         <autoDiscover
           isEnabled="true" 
           identifier="[Cache role name or Service Endpoint]" />
         <!--<localCache isEnabled="true" sync="TimeoutBased" objectCount="100000" ttlValue="300" />-->
         <!--Use this section to specify security settings for connecting to your cache. 
             This section is not required if your cache is hosted on a role that is a part 
             of your cloud service. -->
         <!--<securityProperties mode="Message" sslEnabled="false">
           <messageSecurity authorizationInfo="[Authentication Key]" />
         </securityProperties>-->
       </dataCacheClient>
     </dataCacheClients>
   

   Ersetzen Sie [Cacherollenname oder Dienstendpunkt] durch die Endpunkt-URL, die im Cachedashboard im Verwaltungsportal angezeigt wird.

   
   In diesem Beispiel wird der Cache mit dem Namen "applicationcache" bezeichnet, und die Endpunkt-URL wird applicationcache.cache.windows.net.

   <autoDiscover isEnabled="true" identifier="applicationcache.cache.windows.net" />
   

   Heben Sie die Kommentare des Abschnitts securityProperties auf, und ersetzen Sie [Authentifizierungsschlüssel] durch den Authentifizierungsschlüssel .

   <!--Use this section to specify security settings for connecting to your cache. 
       This section is not required if your cache is hosted on a role that is a part 
       of your cloud service. -->
   <!--<securityProperties mode="Message" sslEnabled="false">
     <messageSecurity authorizationInfo="[Authentication Key]" />
   </securityProperties>-->
   

   Sie ermitteln den Authentifizierungsschlüssel, indem Sie im Verwaltungsportal im Cachedashboard auf Schlüssel verwalten klicken.

   

   Warnung

   Diese Einstellungen müssen ordnungsgemäß konfiguriert werden, ansonsten kann von den Clients nicht auf den Cache zugegriffen werden.

Für Clouddiensteprojekte fügt das Managed Cache Service NuGet-Paket auch eine ClientDiagnosticLevel-Einstellung zur ConfigurationSettings Cacheclientrolle in ServiceConfiguration.cscfg. Das folgende Beispiel ist der WebRole1 Abschnitt aus einer ServiceConfiguration.cscfg Datei mit einem ClientDiagnosticLevel von 1, der der StandardclientDiagnosticLevel ist.

<Role name="WebRole1">
  <Instances count="1" />
  <ConfigurationSettings>
    <!-- Other settings omitted for space... -->
    <Setting name="Microsoft.WindowsAzure.Plugins.Caching.ClientDiagnosticLevel" value="1" />
  </ConfigurationSettings>
</Role>

Zusätzlich zum Hinzufügen der erforderlichen Konfiguration fügt das Managed Cache Service NuGet-Paket auch die folgenden Assemblyverweise hinzu.

• Microsoft.ApplicationServer.Caching.Client.dll

• Microsoft.ApplicationServer.Caching.Core.dll

• Microsoft.ApplicationServer.Caching.AzureCommon.dll

• Microsoft.ApplicationServer.Caching.AzureClientHelper.dll

• Microsoft.WindowsFabric.Common.dll

• Microsoft.WindowsFabric.Data.Common.dll

Wenn es sich bei dem Projekt um eine Webprojekt handelt, wird der folgende Assemblyverweis ebenfalls hinzugefügt.

• Microsoft.Web.DistributedCache.dll

Migrieren von ASP.NET-Sitzungs- und Seitenausgabe-Caching

Sobald Ihre ASP.NET Webprojekte von Microsoft Azure Shared Caching zu Managed Cache Service migriert werden, wie unter "Konfigurieren der Cacheclients" beschrieben, sind nur minimale Änderungen erforderlich, um ASP.NET Sitzungszustand oder Seitenausgabecache im Cache zu speichern. Fügen Sie den folgenden Abschnitt system.web in der Datei web.config hinzu, um die Speicherung des ASP.NET-Sitzungsstatus im Cache zu aktivieren.

<sessionState mode="Custom" customProvider="AppFabricCacheSessionStoreProvider">
  <providers>
    <add name="AppFabricCacheSessionStoreProvider" type="Microsoft.Web.DistributedCache.DistributedCacheSessionStateStoreProvider, Microsoft.Web.DistributedCache" cacheName="default" useBlobMode="true" dataCacheClientName="default" />
  </providers>
</sessionState>

Aktualisieren Sie cacheName, um den Cache anzugeben, der den Sitzungsstatus enthält. Verwenden Sie default, um den Standardcache anzugeben.

Fügen Sie den folgenden Abschnitt system.web hinzu, um die Speicherung des Seitenausgabecaches im Cache zu aktivieren.

<caching>
  <outputCache defaultProvider="DistributedCache">
    <providers>
      <add name="DistributedCache" type="Microsoft.Web.DistributedCache.DistributedCacheOutputCacheProvider, Microsoft.Web.DistributedCache" cacheName="default" dataCacheClientName="default" />
    </providers>
  </outputCache>
</caching>

Aktualisieren Sie cacheName, um den Cache anzugeben, der den Sitzungsstatus enthält. Verwenden Sie default, um den Standardcache anzugeben.

Fügen Sie jeder Seite, für die die Ausgabe zwischengespeichert werden soll, eine Direktive OutputCache hinzu.

<%@ OutputCache Duration="60" VaryByParam="*" %>

In diesem Beispiel bleibt die zwischengespeicherte Seitendaten für 60 Sekunden im Cache, und eine andere Version der Seite wird für jede Parameterkombination zwischengespeichert. Weitere Informationen zu den verfügbaren Optionen finden Sie in der OutputCache-Direktive.

Weitere Informationen

Konzepte

Cacheangebote für Azure Managed Cache Service
Kapazitätsplanung für Azure Managed Cache Service
Sitzungsstatusanbieter für Azure Managed Cache Service
Seitenausgabeanbieter des Caches für Azure Managed Cache Service

Weitere Ressourcen

Azure Managed Cache Service