Dela via

Självstudie: Distribuera ett Aspire projekt med en Redis cache till Azure

I denna guide lär du dig att konfigurera ett Aspire Projekt med en Redis Cachen för distribution till Azure. Aspire tillhandahåller flera konfigurationer för cachelagringsintegrering som etablerar olika Redis tjänster i Azure. Du får lära dig att:

  • Konfigurera appen för att etablera en AzureAzure Cache for Redis
  • Konfigurera appen för att etablera en containerbaserad Redis cache

Anmärkning

Det här dokumentet fokuserar specifikt på Aspire konfigurationer för att etablera och distribuera Redis cacheresurser i Azure. Mer information och för att lära dig mer om den fullständiga Aspire distributionsprocessen finns i Azure Container Apps.

Förutsättningar

För att arbeta med Aspirebehöver du följande installerat lokalt:

För mer information, se Aspire konfiguration och verktyg och Aspire SDK.

Skapa exempellösningen

Följ handledningen: Implementera cachelagring med Aspire integrationer för att skapa exempelprojektet.

Konfigurera appen för Redis cachedistribution

Aspire innehåller två inbyggda konfigurationsalternativ för att effektivisera Redis cachedistributionen på Azure:

  • Etablera en containerbaserad Redis cache med hjälp av Azure Container Apps
  • Etablera en AzureAzure Cache for Redis instans

Lägga till integreringen Aspire i appen

Lägg till lämplig Aspire integrering i projektet AspireRedis.AppHost för önskad värdtjänst.

📦 AspireLägg till . Hosting.Azure.Redis NuGet-paketet till projektet AspireRedis.AppHost:

dotnet add package Aspire.Hosting.Azure.Redis

Konfigurera AppHost-projektet

Konfigurera Projektet AspireRedis.AppHost för önskad Redis tjänst.

Ersätt innehållet Program.cs i filen i projektet AspireRedis.AppHost med följande kod:

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();

Föregående kod lägger till en AzureAzure Cache for Redis resurs i din app och konfigurerar en anslutning med namnet cache. Metoden AddAzureRedis säkerställer att verktyg som Azure Developer CLI eller Visual Studio skapar en Azure Cache for Redis resurs under distributionsprocessen.

Driftsätt appen

Kommandot aspire deploy stöder AspireRedis integreringskonfigurationer för att effektivisera distributioner. Kommandot använder dessa inställningar och etablerar korrekt konfigurerade resurser åt dig.

Anmärkning

Du kan också använda Azure CLI eller Bicep för att etablera och distribuera Aspire projektresurser. De här alternativen kräver fler manuella steg, men ger mer detaljerad kontroll över dina distributioner. Aspire projekt kan också ansluta till en befintlig Redis instans via manuella konfigurationer.

Om du vill distribuera din app till Azure Container Appskör du följande kommando från katalogen AspireRedis.AppHost :

aspire deploy

När du kör aspire deploy kommandot för första gången uppmanas du att:

  1. Logga in Azurepå : Följ anvisningarna för autentisering för att logga in på ditt Azure konto.
  2. Välj en prenumeration: Välj den Azure prenumeration som du vill använda för distribution.
  3. Välj eller skapa en resursgrupp: Välj en befintlig resursgrupp eller skapa en ny.
  4. Välj en plats: Välj den Azure region där du vill distribuera dina resurser.

Distributionsprocessen etablerar nödvändiga Azure resurser och distribuerar din Aspire app. Processen kan ta några minuter att slutföra.

När distributionen är klar ger kommandoutdata information om de distribuerade resurser som du kan visa i portalen Azure .

Implementeringsprocessen etablerade en AzureAzure Cache for Redis resurs på grund av .AppHost-konfigurationen som du angav.

En skärmbild som visar den distribuerade AzureAzure Cache for Redis.

Rensa resurser

Kör följande Azure CLI-kommando för att ta bort resursgruppen när du inte längre behöver de Azure resurser som du skapade. Om du tar bort resursgruppen tas även de resurser som ingår i den bort.

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

Mer information finns i Rensa resurser i Azure.

Se även