Tutorial: Implantar um projeto de .NET Aspire com um Cache Redis para Azure

Artigo
12/16/2024

Neste tutorial, você aprenderá a configurar um projeto de .NET Aspire com um Cache Redis para implantação para Azure. .NET Aspire fornece várias configurações de integração de cache que provisionam diferentes serviços de Redis no Azure. Você aprenderá a:

Configure o aplicativo para provisionar um AzureAzure Cache for Redis
Configurar o aplicativo para provisionar um cache de Redis em contêineres

Nota

Este documento se concentra especificamente nas configurações de .NET Aspire para provisionar e implantar recursos do Cache Redis no Azure. Para obter mais informações e saber mais sobre o processo completo de implantação de .NET.NET Aspire, consulte o tutorial de implantação Azure Container Apps.

Pré-requisitos

Para trabalhar com .NET.NET Aspire, você precisa do seguinte instalado localmente:

.NET 8.0 ou .NET 9.0
Um runtime de contêiner compatível com OCI, como:
- Docker Desktop ou Podman. Para obter mais informações, consulte o runtime do contêiner .
Um IDE (Ambiente de Desenvolvedor Integrado) ou um editor de código, como:
- Visual Studio 2022 versão 17.9 ou superior (opcional)
- Visual Studio Code (opcional)
  - C# Dev Kit: de extensão (opcional)
- JetBrains Rider com .NET.NET Aspire plug-in (opcional)

Para obter mais informações, consulte .NET.NET Aspirede instalação e ferramentas e .NET.NET Aspiredo SDK.

Criar a solução de exemplo

Siga o tutorial : implementar o cache com integrações .NET.NET Aspire para criar o projeto de exemplo.

Configurar o aplicativo para implantação de cache Redis

.NET Aspire fornece duas opções de configuração internas para simplificar a implantação do Cache Redis em Azure:

Provisionar um Cache de Redis em contêineres usando Azure Container Apps
Provisionar uma instância de AzureAzure Cache for Redis

Adicionar a integração .NET.NET Aspire ao aplicativo

Adicione a integração apropriada .NET.NET Aspire ao projeto AspireRedis.AppHost para o serviço de hospedagem desejado.

Azure Cache for Redis
Redis contêiner

Adicione o pacote NuGet 📦Aspire.Hosting.Azure.Redis no projeto AspireRedis.AppHost.

dotnet add package Aspire.Hosting.Azure.Redis

Adicione o 📦Aspire.Hosting.Redis pacote NuGet ao AspireRedis.AppHost projeto:

dotnet add package Aspire.Hosting.Redis

Configurar o projeto AppHost

Configure o projeto AspireRedis.AppHost para o serviço de desejado.

Azure Cache for Redis
Redis contêiner

Substitua o conteúdo do arquivo Program.cs no projeto AspireRedis.AppHost pelo seguinte código:

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

O código anterior adiciona um recurso AzureAzure Cache for Redis ao seu aplicativo e configura uma conexão chamada cache. O método AddAzureRedis garante que ferramentas como o Azure Developer CLI ou Visual Studio criem um recurso de Azure Cache for Redis durante o processo de implantação.

Substitua o conteúdo do arquivo Program.cs no projeto AspireRedis.AppHost pelo seguinte código:

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

O código anterior adiciona um recurso de contêiner Redis ao seu aplicativo e configura uma conexão chamada cache. Essa configuração também garante que ferramentas como o Azure Developer CLI ou Visual Studio criem uma instância de Redis em contêineres durante o processo de implantação.

Implantar o aplicativo

Ferramentas como o Azure Developer CLI (azd) suportam as configurações de integração .NET AspireRedis para simplificar as implantações. azd consome essas configurações e provisiona recursos configurados corretamente para você.

Nota

Você também pode usar a CLI Azure ou Bicep para provisionar e implantar recursos de projeto .NET.NET Aspire. Essas opções exigem etapas mais manuais, mas fornecem controle mais granular sobre suas implantações. Projetos .NET Aspire também podem se conectar a uma instância de Redis existente através de configurações manuais.

Abra uma janela de terminal na raiz do seu projeto de .NET.NET Aspire.
Execute o comando azd init para inicializar o projeto com azd.
```
azd init
```
Quando solicitado a fornecer um nome de ambiente, insira docs-aspireredis.
Execute o comando azd up para iniciar o processo de implantação:
```
azd up
```
Selecione a assinatura Azure que deve hospedar os recursos do aplicativo.
Selecione o local Azure para usar.

O Azure Developer CLI provisiona e implanta os recursos do aplicativo. O processo pode levar alguns minutos para ser concluído.
Quando a implantação for concluída, clique no link do grupo de recursos na saída para exibir os recursos criados no portal Azure.

Azure Cache for Redis
Redis contêiner

O processo de implantação provisionou um recurso de AzureAzure Cache for Redis devido à configuração do .AppHost que você forneceu.

Uma captura de tela mostrando o AzureAzure Cache for Redisimplantado.

Limpar recursos

Execute o seguinte comando Azure CLI para excluir o grupo de recursos quando você não precisar mais dos recursos de Azure que você criou. Excluir o grupo de recursos também exclui os recursos contidos nele.

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

Para mais informações, consulte Limpeza de recursos em Azure.

Compartilhar via