Udostępnij za pośrednictwem

Samouczek: wdrażanie projektu .NET Aspire przy użyciu pamięci podręcznej Redis do Azure

  • Artykuł

Z tego samouczka dowiesz się, jak skonfigurować projekt .NET Aspire za pomocą usługi Redis Cache do wdrożenia na Azure. .NET Aspire udostępnia wiele konfiguracji integracji buforowania, które oferują różne usługi Redis w ramach Azure. Dowiesz się, jak wykonywać następujące działania:

  • Skonfiguruj aplikację w celu udostępnienia AzureAzure Cache for Redis
  • Skonfiguruj aplikację, aby przygotować konteneryzowaną pamięć podręczną Redis Cache

Notatka

Ten dokument koncentruje się specjalnie na konfiguracjach .NET Aspire w celu aprowizowania i wdrażania zasobów usługi Redis Cache w Azure. Aby uzyskać więcej informacji na temat pełnego procesu wdrażania .NET.NET Aspire, zobacz samouczek wdrażania Azure Container Apps.

Warunki wstępne

Aby pracować z .NET.NET Aspire, należy zainstalować lokalnie następujące rzeczy:

Aby uzyskać więcej informacji, zobacz .NET.NET Aspire setup and toolingi .NET.NET Aspire SDK.

Tworzenie przykładowego rozwiązania

Postępuj zgodnie z instrukcjami Samouczek: implementowanie buforowania przy użyciu integracji .NET.NET Aspire, aby utworzyć przykładowy projekt.

Konfigurowanie aplikacji na potrzeby wdrażania pamięci podręcznej Redis

.NET Aspire udostępnia dwie wbudowane opcje konfiguracji, aby usprawnić wdrażanie pamięci podręcznej systemu Redis w Azure:

  • Przygotuj kontenerową pamięć podręczną Redis używając Azure Container Apps
  • Przydziel instancję AzureAzure Cache for Redis

Dodawanie integracji .NET.NET Aspire do aplikacji

Dodaj odpowiednią integrację do projektu AspireRedis.AppHost dla żądanej usługi hostingu.

Dodaj 📦Aspire.Hosting.Azure.Redis pakiet NuGet do projektu AspireRedis.AppHost:

dotnet add package Aspire.Hosting.Azure.Redis

Konfigurowanie projektu AppHost

Skonfiguruj projekt AspireRedis.AppHost dla żądanej usługi .

Zastąp zawartość pliku w projekcie AspireRedis.AppHost następującym kodem:

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

Powyższy kod dodaje do aplikacji zasób AzureAzure Cache for Redis i konfiguruje połączenie o nazwie cache. Metoda AddAzureRedis zapewnia, że narzędzia, takie jak Azure Developer CLI lub Visual Studio, tworzą zasób Azure Cache for Redis podczas procesu wdrażania.

Wdrażanie aplikacji

Narzędzia takie jak Azure Developer CLI (azd) obsługują konfiguracje integracji .NET AspireRedis w celu usprawnienia wdrożeń. azd używa tych ustawień i udostępnia prawidłowo skonfigurowane zasoby.

Notatka

Możesz również użyć interfejsu wiersza polecenia platformy Azure lub Bicep, aby aprowizować i wdrażać zasoby projektu .NET.NET Aspire. Te opcje wymagają bardziej ręcznych kroków, ale zapewniają bardziej szczegółową kontrolę nad wdrożeniami. .NET Aspire projekty mogą również łączyć się z istniejącym wystąpieniem Redis za pomocą konfiguracji ręcznych.

  1. Otwórz okno terminalu w katalogu głównym projektu .NET.NET Aspire.

  2. Uruchom polecenie azd init, aby zainicjować projekt przy użyciu azd.

    azd init

  3. Po wyświetleniu monitu o nazwę środowiska wprowadź docs-aspireredis.

  4. Uruchom polecenie azd up, aby rozpocząć proces wdrażania:

    azd up

  5. Wybierz subskrypcję Azure, która powinna hostować zasoby aplikacji.

  6. Wybierz lokalizację Azure do użycia.

    Azure Developer CLI przydziela i wdraża zasoby aplikacji. Ukończenie procesu może potrwać kilka minut.

  7. Po zakończeniu wdrażania kliknij link „grupa zasobów” w wynikach, aby wyświetlić utworzone zasoby w portalu Azure.

Proces wdrażania przydzielił zasób AzureAzure Cache for Redis z powodu podanej konfiguracji .AppHost.

Zrzut ekranu przedstawiający wdrożony AzureAzure Cache for Redis.

Czyszczenie zasobów

Uruchom następujące polecenie w wierszu poleceń Azure, aby usunąć grupę zasobów, gdy nie potrzebujesz już zasobów Azure, które utworzyłeś. Usunięcie grupy zasobów powoduje również usunięcie zawartych w niej zasobów.

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

Aby uzyskać więcej informacji, zobacz Czyszczenie zasobów w Azure.

Zobacz też