Quickstart: Azure Redis gebruiken met een ASP.NET Core-web-app

In deze quickstart neemt u Azure Cache voor Redis op in een ASP.NET Core-webtoepassing die verbinding maakt met Azure Cache voor Redis om gegevens op te slaan en op te halen uit de cache.

Er zijn ook cachingproviders in .NET Core. Als u redis snel wilt gaan gebruiken met minimale wijzigingen in uw bestaande code, raadpleegt u:

• ASP.NET core-cacheprovider voor uitvoer
• ASP.NET kernprovider voor gedistribueerde caching
• ASP.NET core Redis-sessieprovider

Ga naar de code op GitHub

Kloon de https://github.com/Azure-Samples/azure-cache-redis-samples GitHub-opslagplaats en navigeer naar de quickstart/aspnet-core map om de voltooide broncode weer te geven voor de volgende stappen.

De quickstart/aspnet-core map is ook geconfigureerd als een Azure Developer CLI-sjabloon (azd). Gebruik het opensource-hulpprogramma azd om de inrichting en implementatie van een lokale omgeving naar Azure te stroomlijnen. Voer desgewenst de azd up opdracht uit om automatisch een Azure Cache voor Redis exemplaar in te richten en om de lokale voorbeeld-app te configureren om er verbinding mee te maken:

azd up

Vereiste voorwaarden

• Azure-abonnement: u kunt een gratis abonnement nemen
• .NET Core SDK

Een Azure Managed Redis-exemplaar maken

1. Als u een Azure Managed Redis-exemplaar wilt maken, meldt u zich aan bij Azure Portal en selecteert u Een resource maken.

2. Typ op de pagina Nieuw in het zoekvak Azure Cache voor Redis.

3. Configureer op het tabblad Nieuwe Redis Cache de instellingen voor uw nieuwe cache bij Basisinstellingen.

   Configuratie	Een waarde kiezen	Beschrijving
   Abonnement	Kies uit de vervolgkeuzelijst en selecteer uw abonnement.	Het abonnement waaronder u dit nieuwe Azure Managed Redis-exemplaar wilt maken.
   Resourcegroep	Klap het menu uit en selecteer een resourcegroep, of kies Nieuwe maken en geef een nieuwe resourcegroepnaam in.	Naam voor de resourcegroep waarin de cache en andere resources moeten worden gemaakt. Door al uw app-resources in één resourcegroep te plaatsen, kunt u ze eenvoudig beheren of verwijderen.
   Naam	Voer een naam in die uniek is in de regio.	De cachenaam moet een tekenreeks tussen 1 en 63 tekens zijn in combinatie met de regionaam van de cache die alleen cijfers, letters of afbreekstreepjes bevat. (Als de cachenaam minder dan 45 tekens lang is, moet deze in alle momenteel beschikbare regio's werken.) De naam moet beginnen en eindigen met een getal of letter en mag geen opeenvolgende afbreekstreepjes bevatten. De hostnaam van uw cache-exemplaar is \<DNS name\>.\<Azure region\>.redis.azure.net.
   Regio	Open de vervolgkeuzelijst en selecteer een locatie.	Azure Managed Redis is beschikbaar in geselecteerde Azure-regio's.
   Gegevenslaag	Selecteer in-memory voor hoge prestaties of Flash voor lagere prestatiecaches	De lagen in het geheugen zijn evenwichtig, geoptimaliseerd voor geheugen en geoptimaliseerd voor rekenkracht. Gebruik de Flash-laag om gegevensopslag in het geheugen (RAM) en ssd(on-disk) te gebruiken.
   Cachegrootte	Open de vervolgkeuzelijst en selecteer een grootte.	De cachegrootte is afhankelijk van de laag. De kleinste grootte is een gebalanceerd niveau. De grootste in-memory laag is een Geheugen Geoptimaliseerde laag.
   prestatie	Klap het menu uit en selecteer een prestatievoorkeur.	De prestaties zijn afhankelijk van het aantal vCPU's. Het aantal vCPU's verschilt per laag. Compute Optimized heeft de meeste vCPU's.

   Zie De juiste laag kiezen voor hulp bij het kiezen van de juiste prestatielaag.

   Belangrijk

   Alle in-memory lagen die meer dan 120 GB aan opslagruimte gebruiken, zijn in publieke preview, inclusief Geheugen Geoptimaliseerde M150 en hoger; Gebalanceerde B150 en hoger; en Rekenkracht Geoptimaliseerde X150 en hoger. Al deze lagen en hoger bevinden zich in openbare preview.

   Alle voor Flash geoptimaliseerde lagen bevinden zich in openbare preview.

4. Selecteer Volgende: Netwerken en selecteer een openbaar eindpunt of een privé-eindpunt.

5. Selecteer Volgende: Actieve geo-replicatie. Als u actieve geo-replicatie wilt gebruiken, moet deze worden ingeschakeld tijdens het inrichten. Caches zonder actieve geo-replicatie kunnen later niet worden toegevoegd aan of deelnemen aan actieve geo-replicatiegroepen. Zie Actieve geo-replicatie configureren voor Azure Managed Redis-exemplaren voor meer informatie.

6. Selecteer het tabblad Volgende: Geavanceerd .

   Configureer alle Redis-modules die u wilt toevoegen aan het exemplaar.

   Standaard voor een nieuwe beheerde cache:

   • Microsoft Entra-id is ingeschakeld.
   • Verificatie van toegangssleutels is uitgeschakeld om veiligheidsredenen.

   Belangrijk

   Voor optimale beveiliging wordt u aangeraden Microsoft Entra ID met beheerde identiteiten te gebruiken om aanvragen tegen uw cache te autoriseren, indien mogelijk. Autorisatie met behulp van Microsoft Entra ID en beheerde identiteiten biedt superieure beveiliging en gebruiksgemak ten opzichte van autorisatie van gedeelde toegangssleutels. Zie Microsoft Entra ID gebruiken voor cacheverificatievoor meer informatie over het gebruik van beheerde identiteiten met uw cache.

   Clusteringbeleid instellen:

   • Enterprise gebruiken om RedisSearch of andere modules te gebruiken
   • GEBRUIK OSS voor een geclusterde cache.
   • Gebruik niet-geclusterde (preview) voor een niet-geclusterde cache.

   Zie Clusterbeleid voor meer informatie over het kiezen van Clusterbeleid.

   Belangrijk

   U kunt het clusteringsbeleid van een Azure Managed Redis-exemplaar niet wijzigen nadat u het hebt gemaakt. Als u RediSearch gebruikt , is het clusterbeleid voor ondernemingen vereist en NoEviction wordt het enige verwijderingsbeleid ondersteund.

   Belangrijk

   Als u dit cache-exemplaar in een geo-replicatiegroep gebruikt, kan verwijderingsbeleid niet worden gewijzigd nadat het exemplaar is gemaakt. Zorg ervoor dat u het verwijderingsbeleid van uw primaire knooppunten kent voordat u de cache maakt. Zie Vereisten voor actieve geo-replicatie voor meer informatie over actieve geo-replicatie.

   Belangrijk

   U kunt modules niet wijzigen nadat u een cache-exemplaar hebt gemaakt. Modules moeten zijn ingeschakeld op het moment dat u een Azure Cache voor Redis exemplaar maakt. Er is geen optie om de configuratie van een module in te schakelen nadat u een cache hebt gemaakt.

7. Selecteer Volgende: Tags en overslaan.

8. Selecteer Volgende: Beoordelen en maken.

9. Controleer de instellingen en selecteer Maken.

   Het duurt enkele minuten voordat het Redis-exemplaar is gemaakt. U kunt de voortgang controleren op de overzichtspagina van Azure Managed Redis. Wanneer Status als Wordt uitgevoerd verschijnt, is de cache klaar voor gebruik.

Een Azure Cache voor Redis-instantie maken

1. Zoek en selecteer Azure Cache voor Redis in Azure Portal.

2. Op de pagina Azure Cache voor Redis selecteer je Maken>Azure Cache voor Redis.

3. Configureer op het tabblad Basis van de pagina Nieuwe Redis Cache de volgende instellingen:

   • Abonnement: selecteer het abonnement dat u wilt gebruiken.
   • Resourcegroep: Selecteer een resourcegroep of selecteer Nieuwe maken en voer een nieuwe resourcegroepnaam in. Door al uw app-resources in dezelfde resourcegroep te plaatsen, kunt u ze eenvoudig beheren of verwijderen.
   • Naam: Voer een cachenaam in die uniek is in de regio. De naam moet:
     • Wees een tekenreeks van 1 tot 63 tekens.
     • Alleen cijfers, letters en afbreekstreepjes bevatten.
     • Begin en eindig met een getal of letter.
     • Geen opeenvolgende afbreekstreepjes bevatten.
   • Regio: Selecteer een Azure-regio in de buurt van andere services die gebruikmaken van uw cache.
   • Cache-SKU: selecteer een SKU om de beschikbare grootten, prestaties en functies voor uw cache te bepalen.
   • Cachegrootte: Selecteer een cachegrootte. Zie het overzicht van Azure Cache voor Redis voor meer informatie.

   

4. Selecteer het tabblad Netwerken of selecteer Volgende: Netwerken.

5. Selecteer op het tabblad Netwerken een connectiviteitsmethode die u voor de cache wilt gebruiken. Privé-eindpunt wordt aanbevolen voor beveiliging. Als u Privé-eindpunt selecteert, selecteert u Privé-eindpunt toevoegen en maakt u het privé-eindpunt.

6. Selecteer het tabblad Geavanceerd of selecteer Volgende: Geavanceerd.

7. Configureer in het deelvenster Geavanceerd de volgende opties:

   • Selecteer Microsoft Entra-verificatie of verificatie met toegangssleutels. Microsoft Entra-verificatie is standaard ingeschakeld.
   • Kies of u de niet-TLS-poort wilt inschakelen .
   • Voor een Premium-cache kunt u beschikbaarheidszones configureren of uitschakelen. U kunt beschikbaarheidszones niet uitschakelen nadat de cache is gemaakt. Voor een Standard-cache worden beschikbaarheidszones automatisch toegewezen. Beschikbaarheidszones zijn niet beschikbaar voor de Basic-SKU.
   • Voor een Premium-cache configureert u de instellingen voor het aantal replica's, clustering en Shard count, door het systeem toegewezen beheerde identiteit en gegevenspersistentie.

   In de volgende afbeelding ziet u het tabblad Geavanceerd voor de Standard-SKU.

   

   Belangrijk

   Gebruik Microsoft Entra ID met beheerde identiteiten om aanvragen voor uw cache te autoriseren, indien mogelijk. Autorisatie met Behulp van Microsoft Entra ID en beheerde identiteit biedt betere beveiliging en is eenvoudiger te gebruiken dan autorisatie van gedeelde toegangssleutels. Zie Microsoft Entra ID gebruiken voor cacheverificatievoor meer informatie over het gebruik van beheerde identiteiten met uw cache.

8. Selecteer eventueel het tabblad Tags of selecteer Volgende: Tags en voer tagnamen en waarden in om uw cachebronnen te categoriseren.

9. Selecteer Beoordelen en maken en zodra de validatie is geslaagd, selecteert u Maken.

De implementatie van de nieuwe cache duurt enkele minuten. U kunt de voortgang van de implementatie controleren op de pagina Azure Cache voor Redis in de portal. Wanneer de cachestatusActief is, is de cache gereed voor gebruik.

Microsoft Entra ID-verificatie (aanbevolen)

Microsoft Entra ID-verificatie gebruiken in uw cache

Voor Azure Managed Redis-caches is Microsoft Entra-verificatie standaard ingeschakeld.

1. Selecteer in Azure Portal de cache waar u verificatie op basis van Microsoft Entra-tokens wilt gebruiken.

2. Selecteer Verificatie in het menu Resource.

3. Selecteer Lid selecteren en voer de naam in van een geldige gebruiker. De gebruiker die u invoert, krijgt standaard automatisch de toegangspolicy voor gegevenseigenaar toegewezen wanneer u Opslaan selecteert. U kunt ook een beheerde identiteit of service-principal invoeren om verbinding te maken met uw cache-exemplaar.

   

Zie de referentiepagina's voor identiteit voor informatie over het gebruik van Microsoft Entra ID met Azure CLI.

De bibliotheek installeren voor het gebruik van Microsoft Entra ID-verificatie

De bibliotheek Azure.StackExchange.Redis bevat de verificatiemethode Microsoft Entra ID voor het maken van verbinding met Azure Redis-services met behulp van Microsoft Entra ID. Deze is van toepassing op alle Azure Cache voor Redis, Azure Cache voor Redis Enterprise en Azure Managed Redis.

dotnet add package Microsoft.Azure.StackExchangeRedis

Verbinding maken met de cache met behulp van Microsoft Entra-id

1. De bibliotheken in uw code opnemen

   using Azure.Identity;
   using StackExchange.Redis
   

2. Gebruik de standaardReferenties van Azure om de clientverbinding te verifiëren. Hierdoor kan uw code de aanmeldingsgegevens van de aangemelde gebruiker gebruiken bij lokaal uitvoeren en een door Azure beheerde identiteit wanneer deze wordt uitgevoerd in Azure zonder codewijziging.

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

Het appsettings.json-bestand bewerken

1. Bewerk het bestand appsettings.json. Voeg nu de volgende inhoud toe:

   "_redisHostName":"<cache-hostname>"
   

2. Vervang door <cache-hostname> de hostnaam van uw cache, zoals deze wordt weergegeven op de blade Overzicht van Azure Portal.

   Bijvoorbeeld met Azure Managed Redis of de Enterprise-lagen: my-redis.eastus.azure.net:10000

3. Sla het bestand op.

Zie StackExchange.Redis en de code in een GitHub-opslagplaats voor meer informatie.

Het appsettings.json-bestand bewerken

1. Bewerk het bestand appsettings.json. Voeg nu de volgende inhoud toe:

   "_redisHostName":"<cache-hostname>"
   

2. Vervang door <cache-hostname> de hostnaam van uw cache, zoals deze wordt weergegeven op de blade Overzicht van Azure Portal.

   Bijvoorbeeld met Azure Cache voor Redis: my-redis.eastus.azure.net:6380

3. Sla het bestand op.

Zie StackExchange.Redis en de code in een GitHub-opslagplaats voor meer informatie.

De app lokaal uitvoeren

1. Voer de volgende opdracht in het opdrachtvenster uit om de app te compileren:

   dotnet build
   

2. Voer daarna de app uit met de volgende opdracht:

   dotnet run
   

3. Blader naar https://localhost:5001 in uw webbrowser.

4. Selecteer Azure Cache voor Redis Testen in de navigatiebalk van de webpagina om de toegang tot de cache te testen.

   

De hulpbronnen opschonen

Als u de resources wilt blijven gebruiken die u in dit artikel hebt gemaakt, moet u de resourcegroep behouden.

Als u klaar bent met de resources, kunt u de Azure-resourcegroep verwijderen die u hebt gemaakt om kosten te voorkomen.

Belangrijk

Het verwijderen van een resourcegroep kan niet ongedaan worden gemaakt. Wanneer u een resourcegroep verwijdert, worden alle resources in de groep definitief verwijderd. Zorg ervoor dat u niet per ongeluk de verkeerde bron of bronngroep verwijdert. Als u de resources in een bestaande resourcegroep hebt gemaakt die resources bevat die u wilt behouden, kunt u elke resource afzonderlijk verwijderen in plaats van de resourcegroep te verwijderen.

Een resourcegroep verwijderen

1. Meld u aan bij Azure Portal en selecteer vervolgens Resourcegroepen.

2. Selecteer de resourcegroep die u wilt verwijderen.

   Als er veel resourcegroepen zijn, gebruikt u het vak Filter voor een veld... en typt u de naam van de resourcegroep die u voor dit artikel hebt gemaakt. Selecteer de bronnen groep in de lijst met resultaten.

   

3. Selecteer Resourcegroep verwijderen.

4. U wordt gevraagd om het verwijderen van de resourcegroep te bevestigen. Typ ter bevestiging de naam van de resourcegroep. Selecteer vervolgens Verwijderen.

   

Na enkele ogenblikken worden de resourcegroep en alle bijbehorende resources verwijderd.

Verwante inhoud

• Verbindingstolerantie
• Ontwikkeling van best practices