Migrieren aus dem Rollencache in Azure Managed Cache Service

Die Migration Ihrer Microsoft Azure Cacheanwendungen, die In-Role Cache zu Azure Managed Cache Service verwenden, können mit minimalen Änderungen an Ihrer Anwendung erreicht werden. Da Managed Cache Service dieselbe API wie In-Role Cache verwendet, können vorhandene Code, der In-Role Cache verwendet, um auf einen Cache zuzugreifen, mit Managed Cache Service wiederverwendet werden können. In diesem Thema wird gezeigt, wie Sie die erforderlichen Konfigurations- und Anwendungsänderungen vornehmen, um Ihre In-Role Cacheanwendungen zu migrieren, um Managed Cache Service zu verwenden.

Schritte bei der Migration

In den folgenden Abschnitten werden die Schritte beschrieben, die zum Migrieren einer In-Role Cacheanwendung erforderlich sind, um Managed Cache Service zu verwenden.

• Auswählen eines Cacheangebots

• Erstellen eines Caches

• Konfigurieren des Caches

• Außerbetriebsetzen des Rollencacheclusters

• Konfigurieren der Cacheclients

  • Deinstallieren des NuGet-Pakets für den rolleninternen Cache

  • 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 In-Role Cache sind in den verschiedenen Cacheangeboten für Managed Cache Service verfügbar. Wenn Ihre Anwendung Benachrichtigungen verwendet, sollten Sie sich für das Standard- oder Basic-Cacheangebot entscheiden. Wenn für Ihren Cache Hochverfügbarkeit aktiviert ist, sollten Sie das Premium-Cacheangebot verwenden. Ein Ausgangspunkt für die Migration ist die Auswahl des Managed Cache Service Cacheangebots, das die Cachefeatures enthält, die Ihre Anwendung benötigt, und entspricht den Kapazitätsanforderungen Ihrer In-Role Cacheanwendung.

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 Ausführungsstatus 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

Sowohl In-Role Cache als auch Managed Cache Service benannte Caches unterstützen, wodurch Sie die Flexibilität bieten, verschiedene Cacheoptionen für verschiedene Datensätze zu konfigurieren. Jeder Managed Cache Service-Cache verfügt über einen standardmäßigen benannten Cache, und in den Standard- und Premium Cacheangeboten können bis zu neun zusätzliche 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.

Während In-Role Cache und Managed Cache Service dieselben Cachefeatures haben, gibt es geringfügige Unterschiede, die in der folgenden Tabelle aufgeführt sind.

Um von In-Role Cache zu Managed Cache Service zu migrieren, erstellen Sie alle benannten Caches aus Ihrem In-Role Cachecachecluster in Ihrem neuen Managed Cache Service cache neu.

Außerbetriebsetzen des Rollencacheclusters

Nachdem Sie den neuen Managed Cache Service-Cache konfiguriert haben, muss der nächste Schritt die Zwischenspeicherung aus der Rolle entfernen, die In-Role Cache gehostet wird. Diese Schritte unterscheiden sich je nach Cacheclustertopologie für den In-Role Cache.

• Dedizierter Rollencachecluster

• Zusammengestellter Rollencachecluster

Dedizierter Rollencachecluster

Um einen dedizierten Rollencachecluster zu entfernen, müssen Sie das Cache-Worker-Rollenprojekt aus der Visual Studio-Lösung und aus dem Rollenordner im Clouddienste-Projekt entfernen.

1. Klicken Sie mit der rechten Maustaste auf die Cachemitarbeiterrolle im Ordner "Rollen" im Clouddienste-Projekt in Projektmappen-Explorer, und wählen Sie "Entfernen" aus.

   

2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Workerrollenprojekt, und wählen Sie dann Entfernen aus.

Zusammengestellter Rollencachecluster

Wenn Sie zusammengestelltes Rollencaching in einer Web- oder Workerrolle deaktivieren möchten, müssen Sie die Einstellung Caching auf der Registerkarte Caching in den Rolleneigenschaften deaktivieren.

1. Klicken Sie im Cloud Services-Projekt im Projektmappen-Explorer mit der rechten Maustaste auf die Rolle, und wählen Sie dann Eigenschaften aus.

   

2. Wechseln Sie auf die Registerkarte Caching, und deaktivieren Sie das Kontrollkästchen Caching aktivieren. Drücken Sie dann STRG+S, um die Änderung zu speichern.

   

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

Wenn das In-Role Cacheprojekt Azure SDK 1.8 - 2.0 verwendet, müssen Sie das Cache-NuGet-Paket entfernen, alle verbleibenden Cacheclientkonfiguration entfernen und dann das neueste Azure SDK (derzeit 2.1) installieren. Nachdem Sie ein Upgrade des SDKs ausgeführt haben, installieren und konfigurieren Sie das aktuellste NuGet-Paket Caching. Führen Sie zum Konfigurieren der Cacheclients die folgenden Schritte für jeden Cacheclient aus.

• Deinstallieren des NuGet-Pakets für den rolleninternen Cache

• Konfigurieren eines Cacheclients mithilfe des NuGet-Pakets Caching

Deinstallieren des NuGet-Pakets für den rolleninternen Cache

Bevor die Clientanwendungen für Managed Cache Service konfiguriert werden können, müssen die vorhandenen In-Role Cachekonfigurations- und Assemblyverweise entfernt werden. Deinstallieren Sie zu diesem Zweck das NuGet-Paket Caching.

Zum Deinstallieren des In-Role Cache-NuGet-Pakets 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 Windows Azure-Zwischenspeicherung aus, klicken Sie auf "Deinstallieren", und klicken Sie dann auf "Schließen".

Durch die Deinstallation des In-Role Cache-NuGet Pakets werden die In-Role Cacheassemblys und die In-Role Cacheeinträ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" channelOpenTimeout="0">
      <autoDiscover isEnabled="true" identifier="CacheWorker" />
    </dataCacheClient>
  </dataCacheClients>
  

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

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 Projekt 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 primären 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. Weitere Informationen zu Zugriffsschlüsseln und zum Sichern der Cachekommunikation mit dem sslEnabled Attribut finden Sie unter Security Model for Azure Managed Cache Service.

   

   Warnung

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

Für Clouddienstprojekte 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

Aktualisieren der Cacheclientkonfiguration für die Verwendung von Cache Service

Wenn das In-Role Cacheprojekt bereits das neueste Azure SDK verwendet, müssen Sie die Cacheclientkonfiguration aktualisieren, um auf den neuen Managed Cache Service-Cache zu verweisen.

1. Öffnen Sie die Datei web.config oder app.config des Cacheclientprojekts, und suchen Sie nach dem Abschnitt dataCacheClients.

   <!-- Non-cache sections omitted for space -->
     <dataCacheClients>
       <dataCacheClient name="default">
         <!--To use the in-role flavor of Windows Azure Caching, set identifier to be the cache cluster role name -->
         <!--To use the Windows Azure Caching Service, set identifier to be the endpoint of the cache cluster -->
         <autoDiscover
           isEnabled="true" 
           identifier="MyCacheWorkerRole" />
         <!--<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>
   

2. Ersetzen Sie im autoDiscover Abschnitt den Rollennamen des In-Role Cacheclusters durch den Namen der Endpunkt-URL für den Managed Cache Service Cache im identifier Attribut. Die Endpunkt-URL wird auf dem Cachedashboard im Verwaltungsportal angezeigt.

   
   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" />
   

3. 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 Zugriffsschlüssel klicken.

   

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

Sobald Ihre ASP.NET Webprojekte von In-Role Cache migriert werden, um Managed Cache Service zu Managed Cache Service, wie unter "Konfigurieren der Cacheclients" beschrieben, sind nur minimale Änderungen erforderlich, um das Speichern ASP.NET Sitzungszustands oder Seitenausgabecaches im Cache zu ermöglichen. 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