Sdílet prostřednictvím

Kurz: Nasazení projektu .NET Aspire s mezipamětí Redis do Azure

  • Článek

V tomto kurzu se naučíte nakonfigurovat projekt .NET Aspire s Redis Cache pro nasazení do Azure. .NET Aspire poskytuje několik konfigurací pro integraci ukládání do mezipaměti, které zřizují různé služby Redis v Azure. Naučíte se:

  • Nakonfigurujte aplikaci pro zřízení AzureAzure Cache for Redis
  • Konfigurace aplikace pro zřízení kontejnerizované mezipaměti Redis

Poznámka

Tento dokument se zaměřuje konkrétně na konfigurace .NET Aspire pro zřizování a nasazování prostředků Redis Cache v Azure. Další informace a více se o úplném procesu nasazení .NET.NET Aspire dozvíte v návodu na nasazení Azure Container Apps.

Požadavky

Pokud chcete pracovat s .NET.NET Aspire, potřebujete místně nainstalovat následující:

Další informace najdete v tématu .NET.NET Aspire nastavení a nástrojea .NET.NET Aspire SDK.

Vytvoření ukázkového řešení

Postupujte podle kurzu : Implementujte ukládání do mezipaměti s integracemi .NET.NET Aspire pro vytvoření ukázkového projektu.

Konfigurace aplikace pro nasazení mezipaměti Redis

.NET Aspire nabízí dvě integrované možnosti konfigurace, které zjednoduší nasazení mezipaměti Redis na Azure:

  • Zřízení kontejnerizované mezipaměti Redis pomocí Azure Container Apps
  • Zřízení instance AzureAzure Cache for Redis

Přidání integrace .NET.NET Aspire do aplikace

Přidejte odpovídající .NET.NET Aspire integraci do projektu AspireRedis.AppHost pro vaši požadovanou hostingovou službu.

Přidejte 📦Aspire.Hosting.Azure.Redis balíček NuGet do projektu AspireRedis.AppHost

dotnet add package Aspire.Hosting.Azure.Redis

Konfigurace projektu AppHost

Nakonfigurujte projekt AspireRedis.AppHost pro požadovanou službu Redis.

Obsah souboru Program.cs v projektu AspireRedis.App Host nahraďte následujícím kódem:

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

Předchozí kód přidá do aplikace AzureAzure Cache for Redis prostředek a nakonfiguruje připojení s názvem cache. Metoda AddAzureRedis zajišťuje, že nástroje, jako je Azure Developer CLI nebo Visual Studio, během procesu nasazení vytvoří prostředek Azure Cache for Redis.

Nasazení aplikace

Nástroje, jako je Azure Developer CLI (azd), podporují konfigurace integrace .NET AspireRedis, aby se zjednodušila nasazení. azd tato nastavení využívá a zřídí správně nakonfigurované prostředky za vás.

Poznámka

K zřizování a nasazování prostředků projektu rozhraní příkazového řádku nebo Bicep. Tyto možnosti vyžadují více ručních kroků, ale poskytují podrobnější kontrolu nad nasazeními. .NET Aspire projekty se také můžou připojit k existující instanci Redis prostřednictvím ručních konfigurací.

  1. Otevřete okno terminálu v kořenovém adresáři projektu .NET.NET Aspire.

  2. Spusťte příkaz azd init pro inicializaci projektu s azd.

    azd init

  3. Po zobrazení výzvy k zadání názvu prostředí zadejte docs-aspireredis.

  4. Spuštěním příkazu azd up zahajte proces nasazení:

    azd up

  5. Vyberte Azure předplatné, které by mělo hostovat prostředky vaší aplikace.

  6. Vyberte umístění Azure, které chcete použít.

    Azure Developer CLI zřídí a nasadí prostředky vaší aplikace. Dokončení procesu může trvat několik minut.

  7. Po dokončení nasazení klikněte na odkaz skupiny prostředků ve výstupu a zobrazte vytvořené prostředky na portálu Azure.

Proces nasazení zřídil prostředek AzureAzure Cache for Redis kvůli . AppHost konfiguraci, kterou jste zadali.

snímek obrazovky s nasazeným AzureAzure Cache for Redis.

Vyčištění prostředků

Spuštěním následujícího příkazu rozhraní příkazového řádku Azure odstraňte skupinu prostředků, pokud už nepotřebujete Azure prostředky, které jste vytvořili. Odstraněním skupiny prostředků se odstraní také prostředky obsažené v této skupině.

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

Další informace najdete v tématu Vyčištění prostředků v Azure.

Viz také