Share via


GarnetBuilderExtensions.AddGarnet Method

Definition

Overloads

AddGarnet(IDistributedApplicationBuilder, String, Nullable<Int32>)

Source:
GarnetBuilderExtensions.cs
Source:
GarnetBuilderExtensions.cs
Source:
GarnetBuilderExtensions.cs
Source:
GarnetBuilderExtensions.cs

Adds a Garnet container to the application model.

public static Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.ApplicationModel.GarnetResource> AddGarnet(this Aspire.Hosting.IDistributedApplicationBuilder builder, string name, int? port = default);
public static Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.ApplicationModel.GarnetResource> AddGarnet(this Aspire.Hosting.IDistributedApplicationBuilder builder, string name, int? port);
static member AddGarnet : Aspire.Hosting.IDistributedApplicationBuilder * string * Nullable<int> -> Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.ApplicationModel.GarnetResource>
<Extension()>
Public Function AddGarnet (builder As IDistributedApplicationBuilder, name As String, Optional port As Nullable(Of Integer) = Nothing) As IResourceBuilder(Of GarnetResource)
<Extension()>
Public Function AddGarnet (builder As IDistributedApplicationBuilder, name As String, port As Nullable(Of Integer)) As IResourceBuilder(Of GarnetResource)

Parameters

name
String

The name of the resource. This name will be used as the connection string name when referenced in a dependency.

port
Nullable<Int32>

The host port to bind the underlying container to.

Returns

A reference to the IResourceBuilder<T>.

Examples

Use in application host

var builder = DistributedApplication.CreateBuilder(args);

var garnet = builder.AddGarnet("garnet");
var api = builder.AddProject<Projects.Api>("api)
                 .WithReference(garnet);

builder.Build().Run();

Use in Api with Aspire.StackExchange.Redis

var builder = WebApplication.CreateBuilder(args);
builder.AddRedisClient("garnet");

var multiplexer = builder.Services.BuildServiceProvider()
                                  .GetRequiredService<IConnectionMultiplexer>();

var db = multiplexer.GetDatabase();
db.HashSet("key", [new HashEntry("hash", "value")]);
var value = db.HashGet("key", "hash");

Remarks

This version of the package defaults to the tag of the / container image.

Use in application host
var builder = DistributedApplication.CreateBuilder(args);

var garnet = builder.AddGarnet("garnet");
var api = builder.AddProject<Projects.Api>("api)
                 .WithReference(garnet);

builder.Build().Run();
Use in Api with Aspire.StackExchange.Redis
var builder = WebApplication.CreateBuilder(args);
builder.AddRedisClient("garnet");

var multiplexer = builder.Services.BuildServiceProvider()
                                  .GetRequiredService<IConnectionMultiplexer>();

var db = multiplexer.GetDatabase();
db.HashSet("key", [new HashEntry("hash", "value")]);
var value = db.HashGet("key", "hash");

Applies to

AddGarnet(IDistributedApplicationBuilder, String, Nullable<Int32>, IResourceBuilder<ParameterResource>)

Source:
GarnetBuilderExtensions.cs

Adds a Garnet container to the application model.

public static Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.ApplicationModel.GarnetResource> AddGarnet(this Aspire.Hosting.IDistributedApplicationBuilder builder, string name, int? port = default, Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.ApplicationModel.ParameterResource>? password = default);
static member AddGarnet : Aspire.Hosting.IDistributedApplicationBuilder * string * Nullable<int> * Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.ApplicationModel.ParameterResource> -> Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.ApplicationModel.GarnetResource>
<Extension()>
Public Function AddGarnet (builder As IDistributedApplicationBuilder, name As String, Optional port As Nullable(Of Integer) = Nothing, Optional password As IResourceBuilder(Of ParameterResource) = Nothing) As IResourceBuilder(Of GarnetResource)

Parameters

name
String

The name of the resource. This name will be used as the connection string name when referenced in a dependency.

port
Nullable<Int32>

The host port to bind the underlying container to.

password
IResourceBuilder<ParameterResource>

The parameter used to provide the password for the Redis resource. If null a random password will be generated.

Returns

A reference to the IResourceBuilder<T>.

Remarks

This version of the package defaults to the tag of the / container image.

Use in application host
var builder = DistributedApplication.CreateBuilder(args);

var garnet = builder.AddGarnet("garnet");
var api = builder.AddProject<Projects.Api>("api)
                 .WithReference(garnet);

builder.Build().Run();
Use in Api with Aspire.StackExchange.Redis
var builder = WebApplication.CreateBuilder(args);
builder.AddRedisClient("garnet");

var multiplexer = builder.Services.BuildServiceProvider()
                                  .GetRequiredService<IConnectionMultiplexer>();

var db = multiplexer.GetDatabase();
db.HashSet("key", [new HashEntry("hash", "value")]);
var value = db.HashGet("key", "hash");

Applies to