Guida introduttiva: Usare Azure Redis con un'app Web ASP.NET

In questa guida di avvio rapido si usa Visual Studio 2019 per creare un'applicazione Web ASP.NET che si connette ad Azure Cache for Redis per archiviare e recuperare i dati dalla cache. Si distribuisce quindi l'app nel Servizio app di Azure.

Passare al codice in GitHub

Clonare il repository https://github.com/Azure-Samples/azure-cache-redis-samples/tree/main/quickstart/aspnet in GitHub.

Prerequisiti

• Sottoscrizione di Azure: crearne una gratuitamente
• Visual Studio 2019 con i carichi di lavoro Sviluppo ASP.NET e Web e Sviluppo di Azure.
• .NET Framework 4 o versione successiva è richiesto dal client StackExchange.Redis.

Creare un'istanza di Redis gestita di Azure

1. Per creare un'istanza di Redis gestita di Azure, accedere al portale di Azure e selezionare Crea una risorsa.

2. Nella casella di ricerca della pagina Nuovo digitare cache di Azure per Redis.

3. Nella scheda Nuova cache Redis configurare le impostazioni per la nuova cache in Informazioni di base.

   Impostazione	Scegliere un valore	Descrizione
   Abbonamento	Nell'elenco a discesa selezionare la sottoscrizione.	Sottoscrizione in cui creare questa nuova istanza di Redis gestita di Azure.
   Gruppo di risorse	Nell'elenco a discesa selezionare un gruppo di risorse oppure scegliere Crea nuovo e immettere il nome di un nuovo gruppo di risorse.	Nome del gruppo di risorse in cui creare la cache e altre risorse. L'inserimento di tutte le risorse di un'app in un unico gruppo di risorse ne semplifica la gestione o l'eliminazione.
   Nome	Immettere un nome univoco nell'area.	Il nome della cache deve essere una stringa compresa tra 1 e 63 caratteri in combinazione con il nome dell'area della cache che contiene solo numeri, lettere o trattini. Se il nome della cache è composto da meno di 45 caratteri, deve funzionare in tutte le aree attualmente disponibili. Il nome deve iniziare e terminare con un numero o una lettera e non può contenere trattini consecutivi. Il nome host dell'istanza della cache è \<DNS name\>.\<Azure region\>.redis.azure.net.
   Regione	Nell'elenco a discesa selezionare una località.	Redis gestito di Azure è disponibile nelle aree di Azure selezionate.
   Livello dati	Selezionare In memoria per prestazioni elevate o Flash per le cache con prestazioni inferiori	I livelli in memoria includono Bilanciato, Ottimizzato per la memoria e Ottimizzato per il calcolo. Usare il livello Flash per usare l'archiviazione dati in memoria (RAM) e su disco (SSD).
   Dimensioni cache	Apri il menu a tendina e seleziona una dimensione.	Le dimensioni della cache dipendono dal livello. La dimensione più piccola è un livello bilanciato. La dimensione massima del livello in memoria è il livello Ottimizzato per la Memoria.
   Prestazioni	Apri il menu a tendina e seleziona una preferenza per le prestazioni.	Le prestazioni dipendono dal numero di vCPU. Il numero di vCPU varia a seconda del livello. Compute ottimizzato ha il maggior numero di vCPU.

   Per indicazioni sulla scelta del livello di prestazioni corretto, vedere Scelta del livello corretto.

   Importante

   Tutti i livelli in memoria che usano più di 120 GB di spazio di archiviazione sono disponibili in anteprima pubblica, inclusi M150 ottimizzati per la memoria e superiori; B150 bilanciati e superiori; X150 ottimizzati per il calcolo e superiori. Tutti questi livelli e versioni successive sono disponibili in anteprima pubblica.

   Tutti i livelli con ottimizzazione flash sono disponibili in anteprima pubblica.

4. Selezionare Avanti: Rete e selezionare un endpoint pubblico o un endpoint privato.

5. Selezionare Avanti: Replica geografica attiva. Per usare la replica geografica attiva, è necessario abilitarla durante il provisioning. Le cache senza replica geografica attiva non possono essere aggiunte o aggiunte a gruppi di replica geografica attiva in un secondo momento. Per altre informazioni, vedere Configurare la replica geografica attiva per le istanze di Redis gestite di Azure.

6. Selezionare la scheda Avanti: Avanzate .

   Configurare tutti i moduli Redis da aggiungere all'istanza di .

   Per impostazione predefinita, per una nuova cache gestita:

   • L'ID Microsoft Entra è abilitato.
   • L'autenticazione delle chiavi di accesso è disabilitata per motivi di sicurezza.

   Importante

   Per una protezione ottimale, è consigliabile usare Microsoft Entra ID con identità gestite per autorizzare le richieste nella cache ogni volta che è possibile. L'autorizzazione tramite l'ID e le identità gestite di Microsoft Entra offre sicurezza e facilità d'uso superiori rispetto all'autorizzazione della chiave di accesso condiviso. Per altre informazioni sull'uso di identità gestite con la cache, vedere Usare l'ID Microsoft Entra per l'autenticazione della cache.

   Impostare i criteri di clustering:

   • Usare Enterprise per usare RedisSearch o altri moduli
   • Usare OSS per una cache in cluster.
   • Utilizzare non-cluster (Anteprima) per una cache non-cluster.

   Per altre informazioni sulla scelta dei criteri di clustering, vedere Criteri del cluster.

   Importante

   Non è possibile modificare i criteri di clustering di un'istanza di Redis gestita di Azure dopo averlo creato. Se si usa RediSearch, è necessario il criterio cluster Enterprise ed NoEviction è l'unico criterio di rimozione supportato.

   Importante

   Se si usa questa istanza della cache in un gruppo di replica geografica, non è possibile modificare i criteri di rimozione dopo la creazione dell'istanza. Assicurarsi di conoscere i criteri di rimozione dei nodi primari prima di creare la cache. Per altre informazioni sulla replica geografica attiva, vedere Prerequisiti per la replica geografica attiva.

   Importante

   Non è possibile modificare i moduli dopo aver creato un'istanza della cache. I moduli devono essere abilitati al momento della creazione di un'istanza di cache di Azure per Redis. Non è possibile abilitare la configurazione di un modulo dopo la creazione di una cache.

7. Selezionare Avanti: Tag e ignorare.

8. Selezionare Avanti: Revisiona e crea.

9. Rivedere le impostazioni e selezionare Crea.

   La creazione dell'istanza di Redis richiede alcuni minuti. È possibile monitorare lo stato di avanzamento nella pagina Panoramica di Redis gestita di Azure. Quando l'elemento Stato indica In esecuzione, la cache è pronta per l'uso.

Creare un'istanza di Azure Cache per Redis

1. Nel portale di Azure, cerca e seleziona Azure Cache per Redis.

2. Nella pagina Cache Redis di Azure selezionare Crea>Cache Redis di Azure.

3. Nella scheda Informazioni di base della pagina Nuova cache Redis configurare le impostazioni seguenti:

   • Sottoscrizione: selezionare la sottoscrizione da usare.
   • Gruppo di risorse: selezionare un gruppo di risorse oppure selezionare Crea nuovo e immettere un nuovo nome del gruppo di risorse. L'inserimento di tutte le risorse dell'app nello stesso gruppo di risorse consente di gestirle o eliminarle facilmente.
   • Nome: immettere un nome di cache univoco nell'area. Il nome deve:
     • Essere una stringa da 1 a 63 caratteri.
     • Contengono solo numeri, lettere e trattini.
     • Iniziare e terminare con un numero o una lettera.
     • Non contenere trattini consecutivi.
   • Area: selezionare un'area di Azure vicino ad altri servizi che usano la cache.
   • SKU cache: selezionare uno SKU per determinare le dimensioni, le prestazioni e le funzionalità disponibili per la cache.
   • Dimensioni cache: selezionare una dimensione della cache. Per altre informazioni, vedere la panoramica su Cache Redis di Azure.

   

4. Selezionare la scheda Rete oppure Avanti: Rete.

5. Nella scheda Rete selezionare un metodo di connettività da usare per la cache. L'endpoint privato è consigliato per la sicurezza. Se si seleziona Endpoint privato, selezionare Aggiungi endpoint privato e creare l'endpoint privato.

6. Selezionare la scheda Avanzate oppure Avanti: Avanzate.

7. Nel riquadro Avanzate configurare le opzioni seguenti:

   • Selezionare Autenticazione di Microsoft Entra o Autenticazione delle chiavi di accesso. L'autenticazione di Microsoft Entra è abilitata per impostazione predefinita.
   • Scegliere se abilitare la porta non TLS.
   • Per una cache Premium, è possibile configurare o disabilitare le zone di disponibilità. Non è possibile disabilitare le zone di disponibilità dopo la creazione della cache. Per una cache Standard, le zone di disponibilità vengono allocate automaticamente. Le zone di disponibilità non sono disponibili per lo SKU Basic.
   • Per una cache Premium, configurare le impostazioni per il numero di repliche, la funzionalità di clustering, il numero di partizioni, l'identità gestita assegnata dal sistema e la persistenza dei dati.

   L'immagine seguente mostra la scheda Avanzate per lo SKU Standard.

   

   Importante

   Usare Microsoft Entra ID con identità gestite per autorizzare le richieste nella cache, se possibile. L'autorizzazione con l'ID e l'identità gestita di Microsoft Entra garantisce una maggiore sicurezza ed è più facile da usare rispetto all'autorizzazione della chiave di accesso condiviso. Per altre informazioni sull'uso di identità gestite con la cache, vedere Usare l'ID Microsoft Entra per l'autenticazione della cache.

8. Facoltativamente, selezionare la scheda Tag o selezionare Avanti: Tag e immettere i nomi e i valori dei tag per classificare le risorse della cache.

9. Selezionare Rivedi e crea e una volta superata la convalida selezionare Crea.

La nuova distribuzione della cache richiede alcuni minuti. È possibile monitorare lo stato di avanzamento della distribuzione nella pagina Cache Redis di Azure del portale. Quando lo stato della cache viene visualizzato In esecuzione, la cache è pronta per l'uso.

Autenticazione Microsoft Entra ID (scelta consigliata)

Usare l'autenticazione di Microsoft Entra ID nella cache

Per impostazione predefinita, le cache Redis gestite di Azure dispongono dell'autenticazione di Microsoft Entra authentication abilitata.

1. Nella portale di Azure selezionare la cache in cui si vuole usare l'autenticazione basata su token di Microsoft Entra.

2. Selezionare Autenticazione dal menu Risorsa.

3. Selezionare Seleziona membro e immettere il nome di un utente valido. All'utente immesso viene assegnato automaticamente il criterio di accesso Proprietario dei dati per impostazione predefinita quando si seleziona Salva. È anche possibile immettere un'identità gestita o un'entità servizio per connettersi all'istanza della cache.

   

Per informazioni sull'uso di Microsoft Entra ID con l'interfaccia della riga di comando di Azure, vedere le pagine di riferimento per l'identità.

Installare la libreria per l'uso dell'autenticazione CON ID Entra di Microsoft

La libreria Azure.StackExchange.Redis contiene il metodo di autenticazione Microsoft Entra ID per la connessione ai servizi Redis di Azure tramite Microsoft Entra ID. È applicabile a tutte le versioni di Azure Cache for Redis, Azure Cache for Redis Enterprise e Azure Managed Redis.

1. Aprire il progetto in Visual Studio

2. Fare clic con il pulsante destro del mouse sul progetto, scegliere Gestisci pacchetti NuGet...

3. Cercare Microsoft.Azure.StackExchangeRedis

4. Fare clic sul pulsante Installa per installare

5. Accettare tutto il contenuto richiesto per completare l'installazione

Connettersi alla cache usando Microsoft Entra ID

1. Includere le librerie nel codice

   using Azure.Identity;
   using StackExchange.Redis
   

2. Uso delle credenziali di Azure predefinite per autenticare la connessione client. In questo modo il codice può usare le credenziali utente connesso durante l'esecuzione in locale e un'identità gestita di Azure durante l'esecuzione in Azure senza modifiche al codice.

var configurationOptions = await ConfigurationOptions.Parse($"{_redisHostName}").ConfigureForAzureWithTokenCredentialAsync(new DefaultAzureCredential());
ConnectionMultiplexer _newConnection = await ConnectionMultiplexer.ConnectAsync(configurationOptions);
IDatabase Database = _newConnection.GetDatabase();

Per modificare il file web.config

1. Modificare il file Web.config aggiungendo il contenuto seguente:

   <appSettings>
       <add key="RedisHostName" value="<cache-hostname-with-portnumber>"/>
   </appSettings>
   

2. Sostituire <cache-hostname> con il nome host della cache così come viene visualizzato nel menu Panoramica del menu Risorsa in portale di Azure.

   Ad esempio, con Azure Managed Redis o i livelli Enterprise: *my-redis.eastus.azure.net:10000_

3. Salva il file.

Per altre informazioni, vedere StackExchange.Redis e il codice in un repository GitHub.

Per modificare il file web.config

1. Modificare il file Web.config aggiungendo il contenuto seguente:

   <appSettings>
       <add key="RedisHostName" value="<cache-hostname-with-portnumber>"/>
   </appSettings>
   

2. Sostituire <cache-hostname> con il nome host della cache così come viene visualizzato nel menu Panoramica del menu Risorsa in portale di Azure.

   Ad esempio con cache di Azure per Redis, my-redis.eastus.azure.net:6380

3. Salva il file.

Per altre informazioni, vedere StackExchange.Redis e il codice in un repository GitHub.

Eseguire l'app localmente

Per impostazione predefinita, il progetto è configurato per ospitare l'app in locale in IIS Express per i test e il debug.

Per eseguire l'app in locale

1. In Visual Studio, selezionare Debug>Avvia debug per compilare e avviare l'app in locale per i test e il debug.

2. Nel browser selezionare Azure Cache for Redis Test (Test di Cache Redis di Azure) sulla barra di spostamento.

3. Nell'esempio seguente la chiave Message in precedenza aveva un valore memorizzato nella cache, impostato usando la console di Cache Redis di Azure nel portale. L'app ha aggiornato questo valore memorizzato nella cache. L'app ha anche eseguito i comandi PING e CLIENT LIST.

   

Pubblicare ed eseguire l'app in Azure

Dopo avere testato correttamente l'app in locale, è possibile distribuirla in Azure ed eseguirla nel cloud.

Per pubblicare l'app in Azure

1. In Visual Studio fare clic con il pulsante destro del mouse sul nodo di progetto in Esplora soluzioni. Scegliere quindi Pubblica.

   

2. Selezionare Servizio app di Microsoft Azure, quindi Crea nuovo e infine Pubblica.

   

3. Nella finestra di dialogo Crea servizio app apportare le modifiche seguenti:

   Impostazione	Valore consigliato	Descrizione
   Nome app	Usare quello predefinito.	Il nome dell'app è il nome host per l'app quando viene distribuito in Azure. Se necessario, per rendere il nome univoco è possibile aggiungere un suffisso timestamp.
   Abbonamento	Scegliere la sottoscrizione di Azure.	Eventuali costi di hosting correlati vengono addebitati in questa sottoscrizione. Se si hanno più sottoscrizioni di Azure, verificare che sia selezionata la sottoscrizione desiderata.
   Gruppo di risorse	Usare lo stesso gruppo di risorse in cui è stata creata la cache, ad esempio TestResourceGroup.	Il gruppo di risorse consente di gestire tutte le risorse come gruppo. Successivamente, quando si vuole eliminare l'app, è sufficiente eliminare il gruppo.
   Piano di servizio app	Selezionare Nuovo e quindi creare un nuovo piano di servizio app denominato TestingPlan. Usare lo stesso percorso usato durante la creazione della cache. Scegliere il livello Gratuito per le dimensioni.	Un piano di servizio app definisce un set di risorse di calcolo per l'esecuzione di un'app Web.

   

4. Dopo aver configurato le impostazioni di hosting del servizio app, selezionare Crea.

5. Monitorare la finestra Output in Visual Studio per esaminare lo stato della pubblicazione. Dopo la pubblicazione dell'app, viene registrato l'URL per l'app:

   

Aggiungere l'impostazione dell'app per la cache

Dopo la pubblicazione della nuova app, aggiungere una nuova impostazione dell'app. Questa impostazione viene usata per archiviare le informazioni di connessione alla cache.

Per aggiungere l'impostazione dell'app

1. Per trovare la nuova app creata, digitare il nome dell'app nella barra di ricerca nella parte superiore del portale di Azure.

   

2. Aggiungere una nuova impostazione dell'app denominata CacheConnection per l'app da usare per connettersi alla cache. Usare lo stesso valore configurato per RedisHostName nel file web.config .

Eseguire l'app in Azure

1. Nel browser passare all'URL per l'app. L'URL viene visualizzato nei risultati dell'operazione di pubblicazione nella finestra dell'output di Visual Studio. L'URL viene fornito anche nella portale di Azure nella pagina di panoramica dell'app creata.

2. Selezionare Test della cache di Azure per Redis sulla barra di spostamento per testare l'accesso alla cache come è stato fatto con la versione locale.

Pulire le risorse

Per continuare a usare le risorse create in questo articolo, mantenere il gruppo di risorse.

In caso contrario, se le risorse sono state completate, per evitare addebiti è possibile eliminare il gruppo di risorse di Azure creato.

Importante

L'eliminazione di un gruppo di risorse è irreversibile. Quando si elimina un gruppo di risorse, tutte le risorse in esso contenute vengono eliminate in modo permanente. Assicurarsi di non eliminare accidentalmente il gruppo di risorse sbagliato o le risorse errate. Se le risorse sono state create all'interno di un gruppo di risorse esistente che contiene anche elementi da mantenere, è possibile eliminare ogni singolo elemento a sinistra anziché eliminare il gruppo di risorse.

Per eliminare un gruppo di risorse

1. Accedere al portale di Azure e selezionare Gruppi di risorse.

2. Scegliere il gruppo di risorse da eliminare.

   Se sono presenti molti gruppi di risorse, usare la casella Filtro per qualsiasi campo... e digitare il nome del gruppo di risorse creato per questo articolo. Nell’elenco dei risultati selezionare il gruppo di risorse.

   

3. Selezionare Elimina gruppo di risorse.

4. Verrà chiesto di confermare l'eliminazione del gruppo di risorse. Digitare il nome del gruppo di risorse per confermare e quindi selezionare Elimina.

   

Dopo qualche istante, il gruppo di risorse e tutte le risorse che contiene vengono eliminati.

Contenuti correlati

• Resilienza della connessione
• Sviluppo di procedure consigliate