Condividi tramite

Guida introduttiva: Usare una cache Redis di Azure in .NET Framework

  • Si applica a: ✅ Azure Cache for Redis, ✅ Azure Managed Redis

In questa guida di avvio rapido si incorpora Azure Cache for Redis in un'app .NET Framework per accedere a una cache sicura e dedicata accessibile da qualsiasi applicazione in Azure. Si usa specificamente il client StackExchange.Redis con codice C# in un'app console .NET.

Passare al codice in GitHub

Clonare il repository da Azure-Samples/azure-cache-redis-samples in GitHub.

Prerequisiti

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.

    Screenshot che mostra la scheda Informazioni di base della pagina Nuova cache Redis.

  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.

    Screenshot che mostra il riquadro Avanzate per una cache 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.

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.

    Screenshot che mostra l'opzione di autenticazione selezionata nel menu della risorsa e l'opzione con cui abilitare l'autenticazione di Microsoft Entra selezionata.

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 l'ID di Microsoft Entra

La libreria Azure.StackExchange.Redis contiene il metodo di autenticazione microsoft Entra ID per la connessione ai servizi Di Azure Redis tramite l'ID Microsoft Entra. È 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 app.config

  1. Modificare il file app.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 visualizzato in Panoramica dal 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 app.config

  1. Modificare il file app.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 visualizzato in Panoramica dal 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.

Esegui l'esempio

Premere CTRL+F5 per compilare ed eseguire l'app console per testare la serializzazione degli oggetti .NET.

App console completata

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.

    Screenshot che mostra nel riquadro di lavoro un elenco dei gruppi di risorse da eliminare.

  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.

    Screenshot che mostra un modulo richiedente il nome della risorsa per confermare l'eliminazione.

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

Contenuti correlati