Eseguire la migrazione da Shared Caching al Servizio cache gestito di Azure

La migrazione delle applicazioni che usano Memorizzazione nella cache condivisa di Microsoft Azure per Servizio cache gestita può essere eseguita con modifiche minime all'applicazione. Poiché Servizio cache gestita usa la maggior parte delle stesse API di Memorizzazione nella cache condivisa, il codice esistente che usa Memorizzazione nella cache condivisa per accedere a una cache può essere riutilizzato con Servizio cache gestita. In questo argomento viene illustrato come apportare le modifiche necessarie alla configurazione e all'applicazione per eseguire la migrazione delle applicazioni Memorizzazione nella cache condivisa da usare Servizio cache gestita.

Passaggi della migrazione

Le sezioni seguenti descrivono i passaggi necessari per eseguire la migrazione di un'applicazione Memorizzazione nella cache condivisa di Microsoft Azure da usare Servizio cache gestita.

• Scegliere un'offerta per il servizio cache

• Creare una cache

• Configurare la cache

• Configurare i client della cache

  • Rimuovere la configurazione di Shared Caching

  • Configurare un client della cache mediante il pacchetto NuGet di Caching

• Eseguire la migrazione della memorizzazione nella cache dell'output delle pagine e dello stato della sessione ASP.NET

Scegliere un'offerta per il servizio cache

Servizio cache gestita è disponibile nelle tre offerte seguenti.

• Base: la cache è disponibile in dimensioni comprese tra 128 MB e 1 GB, con incrementi di 128 MB e una cache denominata predefinita.

• Standard: la cache è disponibile in dimensioni che vanno da 1 GB a 10 GB con incrementi di 1 GB e supporto di notifiche, disponibilità elevata e cache denominate fino a un massimo di dieci.

• Premium: la cache è disponibile in dimensioni comprese tra 5 GB e 150 GB con incrementi di 5 GB e il supporto delle notifiche, della disponibilità elevata e di fino a dieci cache denominate.

Tutte le funzionalità della cache di Memorizzazione nella cache condivisa sono disponibili in tutte e tre le offerte Servizio cache gestita, quindi un punto di partenza per la migrazione consiste nel selezionare l'offerta di cache Servizio cache gestita corrispondente alle dimensioni dell'utente Memorizzazione nella cache condivisa account. Dopo aver distribuito l'applicazione, è possibile monitorare le prestazioni della cache e aumentare o ridurre in base ai requisiti dell'applicazione. Per altre informazioni sul monitoraggio delle prestazioni e sulla scalabilità, vedere Monitorare azure Servizio cache gestita e ridimensionare una cache per Azure Servizio cache gestita.

Creare una cache

Le istanze della cache in Servizio cache gestita vengono create usando script di PowerShell.

Per creare un'istanza di Servizio cache gestita

1. Aprire la finestra dei comandi di Azure PowerShell.

   Nota

   Per istruzioni sull'installazione e sull'uso di Azure PowerShell, vedere Come installare e configurare Azure PowerShell.

2. Richiamare il cmdlet Add-AzureAccount, quindi immettere l'indirizzo di posta elettronica e la password associati al proprio account.

   Nota

   Se Azure PowerShell è stato configurato con un certificato per l'account personale, è possibile ignorare questo passaggio. Per altre informazioni sulla connessione di Azure PowerShell all'account Azure, vedere Come installare e configurare Azure PowerShell.

3. Richiamare il cmdlet New-AzureManagedCache e specificare il nome, l'area, nonché l'offerta e la dimensione della cache. Nel seguente esempio è stata creata una cache Basic di 128 MB denominata contosocache, nell'area geografica South Central US.

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

   Nota

   Per un elenco completo dei parametri e dei valori che è possibile usare durante la creazione di una cache, vedere la documentazione del cmdlet New-AzureManagedCache .

4. Dopo aver richiamato il cmdlet PowerShell, la creazione della cache può richiedere alcuni minuti. Dopo aver creato la cache, la nuova cache ha uno stato in esecuzione ed è pronta per l'uso con le impostazioni predefinite e può essere visualizzata e configurata nel portale di gestione di Azure.

   È possibile monitorare l'avanzamento del processo di creazione nella finestra Azure PowerShell. Una volta che la cache è pronta per essere usata, il cmdlet New-AzureManagedCache ne visualizza le informazioni, come mostrato nel seguente esempio.

   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:\>
   

Configurare la cache

Servizio cache gestita supporta cache denominate, che consentono di configurare diverse opzioni di cache per set di dati diversi. Ogni cache include una cache denominata predefinita. Nelle offerte di Cache Standard e Premium è possibile configurare fino a nove cache denominate aggiuntive. Ogni cache denominata include specifiche impostazioni individuali, ad esempio disponibilità elevata, notifiche, rimozione personalizzata e criteri di scadenza. Le impostazioni delle cache denominate vengono configurate nel portale di gestione, nella scheda Configura relativa alla cache.

Nella tabella seguente sono elencate le differenze nelle impostazioni della cache tra Servizio cache gestita e Memorizzazione nella cache condivisa.

Per configurare le impostazioni Servizio cache gestita in modo che corrispondano più strettamente alle impostazioni predefinite Memorizzazione nella cache condivisa, usare le impostazioni seguenti.

• Criterio di scadenza impostato su Assoluta

• Durata (min) impostata su 1440

• Notifiche impostata su Disabilitato (opzione configurabile per le offerte di Cache Standard e Premium; sempre disabilitata per le offerte di Cache Basic)

• Disponibilità elevata impostata su Disabilitato (configurabile per le offerte di cache Standard e Premium, sempre disabilitate per l'offerta di cache di base)

• Rimozione impostata su Abilitata

Configurare i client della cache

Dopo aver creato e configurato la cache, il passaggio successivo consiste nell'aggiungere la configurazione e i riferimenti necessari in modo che i client della cache possano accedere alla cache. Servizio cache gestita supporta i client seguenti.

• Siti Web di Azure

• Ruolo Web e ruolo di lavoro di Servizi cloud di Azure

• Macchine virtuali di Azure

Per configurare i client della cache, completare la seguente procedura per ciascuno di essi.

• Rimuovere la configurazione di Shared Caching

• Configurare un client della cache mediante il pacchetto NuGet di Caching

Rimuovere la configurazione di Shared Caching

Prima che le applicazioni client possano essere configurate per Servizio cache gestita, è necessario rimuovere i riferimenti di configurazione e assembly esistenti Memorizzazione nella cache condivisa. Se Memorizzazione nella cache condivisa è stato configurato usando il pacchetto Memorizzazione nella cache condivisa NuGet, la configurazione può essere rimossa disinstallando il Memorizzazione nella cache condivisa NuGet pacchetto; in caso contrario, deve essere rimosso manualmente.

• Disinstallare il pacchetto NuGet di Shared Caching

• Rimuovere manualmente la configurazione di Shared Caching

Disinstallare il pacchetto NuGet di Shared Caching

Per disinstallare il pacchetto Memorizzazione nella cache condivisa NuGet, fare clic con il pulsante destro del mouse sul progetto client in Esplora soluzioni e scegliere Gestisci pacchetti NuGet. Selezionare il nodo Pacchetti installati, digitare Caching nella casella Cerca in pacchetti installati. Selezionare Shared Caching di Azure, fare clic su Disinstalla, quindi su Chiudi.

La disinstallazione del pacchetto Memorizzazione nella cache condivisa NuGet rimuove gli assembly di Memorizzazione nella cache condivisa e le voci Memorizzazione nella cache condivisa nell'applicazione app.config client oweb.config. Poiché quando si disinstalla il pacchetto NuGet alcune impostazioni personalizzate potrebbero non essere rimosse, aprire il file web.config o app.config e assicurarsi che i seguenti elementi siano stati completamente rimossi.

• Verificare che la voce dataCacheClients sia stata rimossa dall'elemento configSections. Non rimuovere l'intero elemento configSections, ma solo la voce dataCacheClients, se presente.

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

• Verificare che la sezione dataCacheClients sia stata rimossa. La sezione dataCacheClients sarà simile all'esempio seguente.

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

Dopo aver rimosso la configurazione di Memorizzazione nella cache condivisa, è possibile configurare il client della cache come descritto nella sezione Configurare un client della cache usando la sezione Caching NuGet Package.

Rimuovere manualmente la configurazione di Shared Caching

Per rimuovere manualmente la configurazione Memorizzazione nella cache condivisa, è necessario rimuovere i riferimenti all'assembly Memorizzazione nella cache condivisa e la configurazione Memorizzazione nella cache condivisa da app.config o web.config.

Per rimuovere i riferimenti all'assembly Memorizzazione nella cache condivisa, selezionare il progetto client della cache in Esplora soluzioni e espandere la cartella Riferimenti. Per ciascun assembly incluso nel seguente elenco, fare clic con il pulsante destro del mouse nella cartella Riferimenti in Esplora soluzioni e scegliere Rimuovi. Se il client è un progetto Web, rimuovere anche Microsoft.Web.DistributedCache.

• Microsoft.ApplicationServer.Caching.Client

• Microsoft.ApplicationServer.Caching.Core

• Microsoft.WindowsFabric.Common

• Microsoft.WindowsFabric.Data.Common

Per rimuovere la configurazione Memorizzazione nella cache condivisa, aprire o web.configapp.config del progetto client della cache e rimuovere i due elementi seguenti.

• Rimuovere la voce dataCacheClients dall'elemento configSections. Non rimuovere l'intero elemento configSections, ma solo la voce dataCacheClients, se presente.

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

• Rimuovere la sezione dataCacheClients che sarà simile a quella riportata nel seguente esempio.

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

Dopo aver rimosso questi elementi, si possono eseguire i passaggi riportati nella sezione successiva per configurare il client della cache.

Configurare un client della cache mediante il pacchetto NuGet di Caching

Servizio cache gestita fornisce un pacchetto NuGet per aggiungere le informazioni di configurazione e assembly necessarie per consentire ai client della cache di accedere a una cache.

Per usare il pacchetto Servizio cache gestita NuGet, fare clic con il pulsante destro del mouse sul progetto client in Esplora soluzioni e scegliere Gestisci pacchetti NuGet.

Selezionare Caching di Azure, fare clic su Installa e quindi su Accetto. Una volta installato il pacchetto nel progetto client, fare clic su Chiudi per chiudere la finestra Gestisci pacchetti NuGet.

Quando il pacchetto Servizio cache gestita NuGet viene installato in un progetto client, aggiunge i riferimenti di configurazione e assembly necessari in modo che l'applicazione client possa accedere alla cache.

In web.config o app.config per il progetto client vengono aggiunti diversi elementi.

1. A configSections vengono aggiunte due sezioni, denominate dataCacheClients e cacheDiagnostics.

   <!-- 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. Viene aggiunta una sezione dataCacheClients alla sezione configuration.

   <!-- 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>
   

   Sostituire [Nome ruolo cache o Endpoint servizio] con l'URL dell'endpoint visualizzato nel dashboard della cache nel portale di gestione.

   
   In questo esempio la cache è denominata applicationcache e l'URL dell'endpoint è applicationcache.cache.windows.net.

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

   Annullare ilcommentazione della sezione SecurityProperties e sostituire [Authentication Key] con la chiave di autenticazione.

   <!--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>-->
   

   La chiave di autenticazione è disponibile nel portale di gestione facendo clic su Gestisci chiavi dal dashboard della cache.

   

   Avviso

   Questa impostazione deve essere configurata in modo corretto, altrimenti i client non saranno in grado di accedere alla cache.

Per i progetti di servizi cloud, il pacchetto Servizio cache gestita NuGet aggiunge anche un'impostazione ConfigurationSettingsClientDiagnosticLevel al ruolo client della cache in ServiceConfiguration.cscfg. L'esempio seguente è la WebRole1 sezione di un ServiceConfiguration.cscfg file con clientDiagnosticLevel di 1, ovvero il clientDiagnosticLevel predefinito.

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

Oltre ad aggiungere la configurazione necessaria, il pacchetto Servizio cache gestita NuGet aggiunge anche i riferimenti all'assembly seguenti.

• 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

Se il progetto è un progetto Web, viene aggiunto anche il riferimento al seguente assembly.

• Microsoft.Web.DistributedCache.dll

Eseguire la migrazione della memorizzazione nella cache dell'output delle pagine e dello stato della sessione ASP.NET

Dopo aver eseguito la migrazione dei progetti Web ASP.NET da Memorizzazione nella cache condivisa di Microsoft Azure a Servizio cache gestita come descritto in Configurare i client della cache, sono necessarie solo modifiche minime per abilitare l'archiviazione ASP.NET stato sessione o Output pagina Caching nella cache. Per consentire la memorizzazione dello stato della sessione ASP.NET nella cache, aggiungere la seguente sezione a system.web nel file web.config.

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

Aggiornare cacheName per specificare la cache contenente lo stato della sessione. Usare default per specificare la cache predefinita.

Per abilitare la memorizzazione nella cache dell'output delle pagine, aggiungere la seguente sezione a system.web.

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

Aggiornare cacheName per specificare la cache contenente lo stato della sessione. Usare default per specificare la cache predefinita.

Aggiungere una direttiva OutputCache a ogni pagina per cui si desidera memorizzare l'output nella cache.

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

In questo esempio i dati delle pagine rimangono memorizzati nella cache per 60 secondi e per ogni combinazione di parametri viene memorizzata nella cache una versione diversa della pagina. Per altre informazioni sulle opzioni disponibili, vedere Direttiva OutputCache.

Vedere anche

Concetti

Offerte di cache per il Servizio cache gestita di Azure
Pianificazione della capacità per il Servizio cache gestita di Azure
Provider di stato della sessione per il Servizio cache gestito di Azure
Provider di cache di output delle pagine per il Servizio cache gestito di Azure

Risorse aggiuntive

Servizio cache gestita di Azure