Aspire.Hosting.Garnet

Aspire.Hosting.Garnet library

Provides extension methods and resource definitions for an Aspire AppHost to configure a Garnet cache resource.

Getting started

Install the package

In your AppHost project, install the Aspire Garnet Hosting library with NuGet:

dotnet add package Aspire.Hosting.Garnet

Usage example

Then, in the AppHost.cs file of AppHost, add a Garnet resource and consume the connection using the following methods:

var garnet = builder.AddGarnet("cache");

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

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 the client library Aspire.StackExchange.Redis:

builder.AddRedisClient("cache");

Connection Properties

When you reference a Garnet resource using WithReference, the following connection properties are made available to the consuming project:

Garnet

The Garnet resource exposes the following connection properties:

Aspire exposes each property as an environment variable named [RESOURCE]_[PROPERTY]. For instance, the Uri property of a resource called db1 becomes DB1_URI.

Additional documentation

• https://github.com/microsoft/garnet/blob/main/README.md
• https://stackexchange.github.io/StackExchange.Redis/Basics
• https://github.com/dotnet/aspire/tree/main/src/Components/README.md

Feedback & contributing

https://github.com/dotnet/aspire

*Garnet MIT License. Copyright (c) Microsoft Corporation..