Freigeben über

Lernprogramm: Bereitstellen eines .NET Aspire Projekts mit einem Redis Cache zum Azure

  • Artikel

In dieser Anleitung lernen Sie, wie Sie ein .NET Aspire Projekt mit einem Redis Cache für die Bereitstellung zu Azurekonfigurieren. .NET Aspire bietet mehrere Konfigurationen zur Cache-Integration an, die unterschiedliche Redis-Dienste in Azurebereitstellen. Hier erfahren Sie, wie Sie:

  • Konfigurieren Sie die App zur Provisionierung eines AzureAzure Cache for Redis
  • Konfigurieren Sie die App zur Bereitstellung eines containerisierten Redis-Caches.

Anmerkung

Dieses Dokument konzentriert sich speziell auf .NET Aspire Konfigurationen, um Redis Cacheressourcen in Azurebereitzustellen und bereitzustellen. Für weitere Informationen und um mehr über den vollständigen .NET.NET Aspire-Bereitstellungsprozess zu erfahren, siehe das Azure Container Apps-Bereitstellungs-Tutorial.

Voraussetzungen

Um mit .NET.NET Aspirezu arbeiten, benötigen Sie folgendes lokal installiert:

Weitere Informationen finden Sie unter .NET.NET Aspire-Setup und Toolingund .NET.NET Aspire-SDK.

Erstellen der Beispiellösung

Befolgen Sie das Tutorial: die Implementierung der Zwischenspeicherung mit .NET.NET Aspire Integrationen, um das Beispielprojekt zu erstellen.

Konfigurieren der App für die Bereitstellung des Caches Redis

.NET Aspire bietet zwei integrierte Konfigurationsoptionen, um die Redis Cache-Bereitstellung auf Azurezu optimieren.

  • Einen containerisierten Redis Cache bereitstellen mithilfe von Azure Container Apps
  • Bereitstellen einer AzureAzure Cache for Redis Instanz

Fügen Sie die .NET.NET Aspire-Integration zur App hinzu

Fügen Sie die entsprechende .NET.NET Aspire-Integration dem AspireRedis.AppHost-Projekt für den gewünschten Hostingdienst hinzu.

Fügen Sie das NuGet-Paket 📦Aspire.Hosting.Azure.Redis zum Projekt AspireRedis.AppHost hinzu.

dotnet add package Aspire.Hosting.Azure.Redis

Konfigurieren des AppHost-Projekts

Konfigurieren Sie das AspireRedis.AppHost Projekt für Ihren gewünschten Redis Dienst.

Ersetzen Sie den Inhalt der Datei Program.cs im Projekt AspireRedis.AppHost durch den folgenden 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();

Der vorangehende Code fügt Ihrer App eine AzureAzure Cache for Redis Ressource hinzu und konfiguriert eine Verbindung namens cache. Die AddAzureRedis-Methode stellt sicher, dass Tools wie die Azure Developer CLI oder Visual Studio während des Bereitstellungsprozesses eine Azure Cache for Redis Ressource erstellen.

Bereitstellen der App

Werkzeuge wie Azure Developer CLI (azd) unterstützen .NET AspireRedis Integrationskonfigurationen, um Bereitstellungen zu rationalisieren. azd nutzt diese Einstellungen und stellt entsprechend konfigurierte Ressourcen für Sie bereit.

Anmerkung

Sie können auch das Azure CLI- oder Bicep- verwenden, um .NET.NET Aspire Projektressourcen bereitzustellen und zu implementieren. Diese Optionen erfordern mehr manuelle Schritte, bieten jedoch eine genauere Kontrolle über Ihre Bereitstellungen. .NET Aspire Projekte können auch über manuelle Konfigurationen eine Verbindung mit einer vorhandenen Redis Instanz herstellen.

  1. Öffnen Sie ein Terminalfenster im Stammverzeichnis Ihres .NET.NET Aspire Projekts.

  2. Führen Sie den Befehl azd init aus, um das Projekt mit azdzu initialisieren.

    azd init

  3. Wenn Sie zur Eingabe eines Umgebungsnamens aufgefordert werden, geben Sie docs-aspireredisein.

  4. Führen Sie den Befehl azd up aus, um den Bereitstellungsprozess zu starten:

    azd up

  5. Wählen Sie das Azure-Abonnement aus, das Ihre App-Ressourcen hosten soll.

  6. Wählen Sie den zu verwendenden Azure Speicherort aus.

    Die Azure Developer CLI stellt Ihre App-Ressourcen bereit und implementiert sie. Der Vorgang kann einige Minuten dauern.

  7. Wenn die Bereitstellung abgeschlossen ist, klicken Sie in der Ausgabe auf den Link "Ressourcengruppe", um die erstellten Ressourcen im Azure-Portal anzuzeigen.

Der Bereitstellungsprozess hat eine AzureAzure Cache for Redis Ressource bereitgestellt aufgrund der von Ihnen bereitgestellten .AppHost--Konfiguration.

Ein Screenshot, der das bereitgestellte AzureAzure Cache for Rediszeigt.

Bereinigen von Ressourcen

Führen Sie den folgenden Azure CLI-Befehl aus, um die Ressourcengruppe zu löschen, wenn Sie die von Ihnen erstellten Azure Ressourcen nicht mehr benötigen. Durch das Löschen der Ressourcengruppe werden auch die darin enthaltenen Ressourcen gelöscht.

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

Weitere Informationen finden Sie unter Ressourcen bereinigen in Azure.

Siehe auch