Aspire.Microsoft.Azure.StackExchangeRedis 13.0.0-preview.1.25560.3

Aspire.Microsoft.Azure.StackExchangeRedis library

Configures the Aspire.StackExchange.Redis package with Azure AD authentication when connecting to an Azure Cache for Redis instance.

Getting started

Prerequisites

• Azure Cache for Redis instance, learn more about how to Create an Azure Cache for Redis resource or Use the Aspire Azure Redis hosting integration.

Differences with Aspire.StackExchange.Redis

The Aspire.Microsoft.Azure.StackExchangeRedis library is a wrapper around the Aspire.StackExchange.Redis library that provides additional features for connecting to Azure Cache for Redis with Azure AD authentication. If you don't need these features, you can use the Aspire.StackExchange.Redis library instead.

At runtime the client integration will use Azure AD authentication when a credential is configured, allowing passwordless authentication with Azure Cache for Redis.

Install the package

Install the Aspire Azure StackExchange.Redis library with NuGet:

dotnet add package Aspire.Microsoft.Azure.StackExchangeRedis

Usage example

In the Program.cs file of your project, use the AddRedisClientBuilder extension method with WithAzureAuthentication to register a IConnectionMultiplexer for use via the dependency injection container. The method takes a connection name parameter.

builder.AddRedisClientBuilder("cache")
    .WithAzureAuthentication();

You can then retrieve the IConnectionMultiplexer instance using dependency injection. For example, to retrieve the connection from a Web API controller:

private readonly IConnectionMultiplexer _cache;

public ProductsController(IConnectionMultiplexer cache)
{
    _cache = cache;
}

Using keyed services

You can also register keyed Redis clients using the keyed services pattern:

builder.AddKeyedRedisClientBuilder("cache")
    .WithAzureAuthentication();

Then retrieve the keyed service:

public ProductsController([FromKeyedServices("cache")] IConnectionMultiplexer cache)
{
    _cache = cache;
}

Adding distributed caching and output caching

You can add distributed caching and output caching to the Redis client by chaining additional methods:

builder.AddRedisClientBuilder("cache")
    .WithAzureAuthentication()
    .WithDistributedCache()
    .WithOutputCache();

Configure Azure AD authentication

Use the WithAzureAuthentication method to establish a connection using Azure AD authentication. If no credential is provided, the DefaultAzureCredential is used.

builder.AddRedisClientBuilder("cache")
    .WithAzureAuthentication(new ManagedIdentityCredential());

AppHost extensions

In your AppHost project, install the Aspire.Hosting.Azure.Redis library with NuGet:

dotnet add package Aspire.Hosting.Azure.Redis

Then, in the Program.cs file of AppHost, register an Azure Cache for Redis instance and consume the connection using the following methods:

var redis = builder.AddAzureRedis("cache");

var myService = builder.AddProject<Projects.MyService>()
                       .WithReference(redis);

The WithReference method configures a connection in the MyService project named cache. In the Program.cs file of MyService, the Redis connection can be consumed using:

builder.AddRedisClientBuilder("cache")
    .WithAzureAuthentication();

This will also require your Azure environment to be configured by following these instructions.

Additional documentation

• https://stackexchange.github.io/StackExchange.Redis/
• https://github.com/Azure/Microsoft.Azure.StackExchangeRedis

Feedback & contributing

https://github.com/dotnet/aspire

*Redis is a registered trademark of Redis Ltd. Any rights therein are reserved to Redis Ltd.