Zelfstudie: Een .NET Aspire-project met een Redis Cache implementeren in Azure

Artikel
12/14/2024

In deze zelfstudie leert u hoe u een .NET Aspire project configureert met een Redis Cache voor implementatie naar Azure. .NET Aspire biedt meerdere configuraties voor cachingintegratie waarmee verschillende Redis-services in Azureworden ingericht. U leert het volgende:

De app configureren om een AzureAzure Cache for Redis in te richten
Configureer de app om te voorzien van een gecontaineriseerde Redis-cache.

Notitie

Dit document is specifiek gericht op .NET Aspire configuraties voor het inrichten en implementeren van Redis Cache-resources in Azure. Raadpleeg de .NET Aspire zelfstudie voor meer informatie over het volledige implementatieproces van Azure Container Apps.

Voorwaarden

Als u met .NET.NET Aspirewilt werken, hebt u het volgende lokaal geïnstalleerd:

.NET 8,0 of .NET 9,0
Een OCI-compatibele containerruntime, zoals:
- Docker Desktop of Podman. Voor meer informatie, zie Container runtime.
Een IDE (Integrated Developer Environment) of code-editor, zoals:
- Visual Studio 2022 versie 17.9 of hoger (optioneel)
- Visual Studio Code (optioneel)
  - C# Dev Kit: extensie- (optioneel)
- JetBrains Rider met .NET.NET Aspire plug-in (optioneel)

Zie .NET.NET Aspire setup en hulpprogramma'sen .NET.NET Aspire SDK-voor meer informatie.

De voorbeeldoplossing maken

Volg de Zelfstudie: Caching implementeren met .NET.NET Aspire integraties om het voorbeeldproject te maken.

De app configureren voor Redis cache-implementatie

.NET Aspire biedt twee ingebouwde configuratieopties voor het stroomlijnen van Redis cache-implementatie op Azure:

Een container Redis Cache inrichten met behulp van Azure Container Apps
Een AzureAzure Cache for Redis-exemplaar voorzien

De .NET.NET Aspire-integratie toevoegen aan de app

Voeg de juiste .NET.NET Aspire-integratie toe aan het project AspireRedis.AppHost voor de gewenste hostingservice.

Azure Cache for Redis
Redis Container

Voeg het 📦Aspire.Hosting.Azure.Redis NuGet-pakket aan het AspireRedis.AppHost project toe.

dotnet add package Aspire.Hosting.Azure.Redis

Voeg het NuGet-pakket 📦Aspire.Hosting.Redis toe aan het project AspireRedis.AppHost.

dotnet add package Aspire.Hosting.Redis

Het AppHost-project configureren

Configureer het AspireRedis.AppHost--project voor uw gewenste Redis-service.

Azure Cache for Redis
Redis Container

Vervang de inhoud van het bestand Program.cs in het project AspireRedis.AppHost door de volgende code:

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddAzureRedis("cache");

var apiService = builder.AddProject<Projects.AspireRedis_ApiService>("apiservice")
                        .WithReference(cache);

builder.AddProject<Projects.AspireRedis_Web>("webfrontend")
    .WithExternalHttpEndpoints()
    .WithReference(cache)
    .WaitFor(cache)
    .WithReference(apiService)
    .WaitFor(apiService);

builder.Build().Run();

Met de voorgaande code wordt een AzureAzure Cache for Redis resource aan uw app toegevoegd en wordt een verbinding met de naam cachegeconfigureerd. De methode AddAzureRedis zorgt ervoor dat hulpprogramma's zoals de Azure Developer CLI of Visual Studio tijdens het implementatieproces een Azure Cache for Redis resource maken.

Vervang de inhoud van het bestand Program.cs in het project AspireRedis.AppHost door de volgende code:

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddRedis("cache");

var apiService = builder.AddProject<Projects.RedisSample_ApiService>("apiservice")
                        .WithReference(cache);

builder.AddProject<Projects.RedisSample_Web>("webfrontend")
    .WithExternalHttpEndpoints()
    .WithReference(cache)
    .WaitFor(cache)
    .WithReference(apiService)
    .WaitFor(apiService);

builder.Build().Run();

De voorgaande code voegt een Redis containerresource toe aan uw app en configureert een verbinding met de naam cache. Deze configuratie zorgt er ook voor dat hulpprogramma's zoals de Azure Developer CLI of Visual Studio een container-Redis-exemplaar maken tijdens het implementatieproces.

De app implementeren

Hulpprogramma's zoals de Azure Developer CLI (azd) ondersteunen .NET AspireRedis integratieconfiguraties om implementaties te stroomlijnen. azd gebruikt deze instellingen en richt correct geconfigureerde resources voor u in.

Notitie

U kunt ook de Azure CLI- of Bicep- gebruiken om .NET.NET Aspire projectbronnen in te richten en te implementeren. Deze opties vereisen meer handmatige stappen, maar bieden meer gedetailleerde controle over uw implementaties. .NET Aspire projecten kunnen ook verbinding maken met een bestaand Redis exemplaar via handmatige configuraties.

Open een terminalvenster in de hoofdmap van uw .NET.NET Aspire project.
Voer de opdracht azd init uit om het project te initialiseren met azd.
```
azd init
```
Wanneer u wordt gevraagd om een omgevingsnaam, voert u docs-aspireredisin.
Voer de opdracht azd up uit om het implementatieproces te starten:
```
azd up
```
Selecteer het Azure-abonnement dat uw app-resources moet hosten.
Selecteer de Azure locatie die u wilt gebruiken.

De Azure Developer CLI richt uw app-resources in en implementeert deze. Het kan enkele minuten duren voordat het proces is voltooid.
Wanneer de implementatie is voltooid, klikt u op de koppeling naar de resourcegroep in de uitvoer om de gemaakte resources in de Azure-portal weer te geven.

Azure Cache for Redis
Redis Container

Het implementatieproces heeft een AzureAzure Cache for Redis resource ingericht vanwege de AppHost configuratie die u hebt opgegeven.

Een schermopname met de geïmplementeerde AzureAzure Cache for Redis.

Middelen opschonen

Voer de volgende Azure CLI-opdracht uit om de resourcegroep te verwijderen wanneer u de Azure resources die u hebt gemaakt niet meer nodig hebt. Als u de resourcegroep verwijdert, worden ook de resources in de resourcegroep verwijderd.

az group delete --name <your-resource-group-name>

Zie Resources opschonen in Azurevoor meer informatie.

Delen via