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

Artigo
12/14/2024

Neste tutorial, tu aprenderás a configurar um projeto .NET Aspire com um Cache Redis para desdobramento em Azure. .NET Aspire oferece várias integrações de cache que disponibilizam diferentes serviços de Redis em Azure. Você aprenderá a:

Configurar a aplicação para provisionar um AzureAzure Cache for Redis
Configurar o aplicativo para provisionar um cache de Redis em contêiner

Observação

Este documento concentra-se especificamente nas configurações do .NET Aspire para provisionar e implantar os recursos do cache Redis no Azure. Para obter mais informações e saber mais sobre o completo processo 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 tempo de execução de contêiner compatível com OCI, como:
- Docker Ambiente de Trabalho ou Podman. Para obter mais informações, consulte Container runtime.
Um ambiente de desenvolvedor integrado (IDE) ou editor de código, como:
- Visual Studio 2022 versão 17.9 ou superior (opcional)
- Visual Studio Code (Opcional)
  - C# Dev Kit: Extensão (Opcional)
- JetBrains Rider com o plug-in .NET.NET Aspire (Opcional)

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

Criar a solução de exemplo

Siga o Tutorial: Implementar 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 Redis Cache em Azure:

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

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

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

Azure Cache for Redis
Redis Contêiner

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

dotnet add package Aspire.Hosting.Azure.Redis

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

dotnet add package Aspire.Hosting.Redis

Configurar o projeto AppHost

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

Azure Cache for Redis
Redis Contêiner

Substitua o conteúdo do arquivo no projeto AspireRedis.AppHost com o 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 o Visual Studio criem um recurso Azure Cache for Redis durante o processo de implantação.

Substitua o conteúdo do arquivo no projeto AspireRedis.AppHost com o 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 Redis Container ao seu aplicativo e configura uma conexão chamada cache. Essa configuração também garante que ferramentas como o Azure Developer CLI ou o Visual Studio criem uma instância de Redis conteinerizada durante o processo de implantação.

Implantar o aplicativo

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

Observação

Você também pode usar o CLI ou Bicep para provisionar e implantar recursos projeto. Essas opções exigem mais etapas manuais, mas fornecem um controle mais granular sobre suas implantações. .NET Aspire projetos também podem ligar-se a uma instância existente de Redis por meio de configurações manuais.

Abra uma janela de terminal na raiz do seu projeto .NET.NET Aspire.
Execute o comando azd init para inicializar o projeto com azd.
```
azd init
```
Quando for solicitado um nome de ambiente, digite 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 da sua aplicação.
Selecione o local Azure a ser usado.

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 terminar, 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 ao . AppHost configuração 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 não precisar mais dos recursos Azure criados. A exclusão do grupo de recursos também exclui os recursos contidos nele.

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

Para obter mais informações, consulte Limpar recursos no Azure.

Partilhar via