.NET Aspire Redis® 分散キャッシュ統合^*

.NET Aspire Redis 分散キャッシュ統合を使用する方法について説明します。 Aspire.StackExchange.Redis.DistributedCaching ライブラリは、 サーバーによってサポートされる Redis プロバイダーを、docker.io/library/redis コンテナー イメージに登録するために使用されます。

.NET Aspire Redis 分散キャッシュ統合を使用する方法について説明します。 Aspire.StackExchange.Redis.DistributedCaching ライブラリは、Garnet サーバーによってサポートされる IDistributedCache プロバイダーを、ghcr.io/microsoft/garnet コンテナー イメージに登録するために使用されます。

.NET Aspire Redis 分散キャッシュ統合を使用する方法について説明します。 Aspire.StackExchange.Redis.DistributedCaching ライブラリは、Valkey サーバーによってサポートされる IDistributedCache プロバイダーを、docker.io/valkey/valkey コンテナー イメージに登録するために使用されます。

Redis ホスティング統合は、Redis の種類として RedisResource リソースをモデル化します。 アプリ ホスト プロジェクト内のリソースとして表現するために、この種類と API にアクセスするには、📦Aspireホスティング.Redis NuGet パッケージを追加します。

dotnet add package Aspire.Hosting.Redis

<PackageReference Include="Aspire.Hosting.Redis"
                  Version="*" />

詳細については、「dotnet パッケージ の追加」または「.NET アプリケーションでのパッケージの依存関係の管理」を参照してください。

リソース Redis を追加する

アプリ ホスト プロジェクトで、AddRedis インスタンスの builder を呼び出して、Redis リソースを追加します。

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddRedis("cache");

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

.NET .NET Aspire 前の例で示したように、docker.io/Redis/Redis イメージでコンテナー イメージをアプリ ホストに追加すると、ローカル コンピューターに新しい Redis インスタンスが作成されます。 Redis リソース (cache 変数) への参照が ExampleProjectに追加されます。

WithReference メソッドは、ExampleProjectという名前の "cache" で接続を構成します。 詳細については、「コンテナー リソースのライフサイクルの」を参照してください。

Redis Insights を使用してリソース Redis 追加する

Redis Insights を Redis リソースに追加するには、WithRedisInsight メソッドを呼び出します。

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddRedis("cache")
                   .WithRedisInsight();

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Redis Insights は、AI アシスタントである Copilot Redis の助けを借りて、すべてのオペレーティング システムと Redis デプロイの Redis データを分析するための無料のグラフィカル インターフェイスです。 .NET .NET Aspire は、コマンダー アプリを実行する別のコンテナー イメージ docker.io/redis/redisinsight をアプリ ホストに追加します。

Redis リソースに Redis コマンダーを追加する

Redis リソースに を追加するには、Redis メソッドを呼び出します。

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddRedis("cache")
                   .WithRedisCommander();

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Redis Commander は、Node.js データベースの表示、編集、管理に使用される Redis Web アプリケーションです。 .NET .NET Aspire は、コマンダー アプリを実行する別のコンテナー イメージ docker.io/rediscommander/redis-commander をアプリ ホストに追加します。

リソースRedisをデータ ボリュームで追加する

Redis リソースにデータ ボリュームを追加するには、WithDataVolume リソースで Redis メソッドを呼び出します。

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddRedis("cache")
                   .WithDataVolume(isReadOnly: false);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

データ ボリュームは、Redis データをコンテナーのライフサイクル外に保持するために使用されます。 データ ボリュームは、/data コンテナー内の Redis パスにマウントされ、name パラメーターが指定されていない場合、名前はランダムに生成されます。 データボリュームの詳細およびそれがバインドマウントよりも優先される理由についての情報は、Dockerドキュメント: ボリュームを参照してください。

データバインドマウント付きのRedisリソースを追加する

Redis リソースにデータ バインド マウントを追加するには、WithDataBindMount メソッドを呼び出します。

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddRedis("cache")
                   .WithDataBindMount(
                       source: @"C:\Redis\Data",
                       isReadOnly: false);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

データ バインド マウントは、ホスト マシンのファイルシステムに依存して、コンテナーの再起動間に Redis データを保持します。 データ バインド マウントは、C:\Redis\Data コンテナー内のホスト コンピューター上の Windows 上の /Redis/Data (または Unixの Redis) パスにマウントされます。 データバインドマウントの詳細については、Docker ドキュメント: バインドマウントを参照してください。

永続性のあるRedisリソースを追加する

Redis リソースに永続化を追加するには、データ ボリュームまたはデータ バインド マウントを使用して WithPersistence メソッドを呼び出します。

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddRedis("cache")
                   .WithDataVolume()
                   .WithPersistence(
                       interval: TimeSpan.FromMinutes(5),
                       keysChangedThreshold: 100);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

上記のコードでは、指定した間隔としきい値で Redis データのスナップショットを取得することで、Redis リソースに永続化を追加します。 interval はスナップショットのエクスポートから keysChangedThreshold までの時間であり、スナップショットのトリガーに必要なキー変更操作の数です。 永続化の詳細については、「Redis ドキュメント: 永続化の」を参照してください。

Garnet ホスティング統合では、Garnet リソースが GarnetResource の種類としてモデル化されます。 この型とAPIにアクセスし、それを📦Aspireに追加するには、アプリホストプロジェクトでHosting.Garnet NuGetパッケージを利用してください。

dotnet add package Aspire.Hosting.Garnet

<PackageReference Include="Aspire.Hosting.Garnet"
                  Version="*" />

詳細については、「dotnet パッケージ の追加」または「.NET アプリケーションでのパッケージの依存関係の管理」を参照してください。

Garnet リソースの追加

アプリ ホスト プロジェクトで、AddGarnet インスタンスの builder を呼び出して、Garnet リソースを追加します。

var builder = DistributedApplication.CreateBuilder(args);

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

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

.NET .NET Aspire 前の例で示したように、ghcr.io/microsoft/garnet イメージを使用してコンテナー イメージをアプリ ホストに追加すると、ローカル コンピューターに新しい Garnet インスタンスが作成されます。 Garnet リソース (cache 変数) への参照が ExampleProjectに追加されます。

WithReference メソッドは、ExampleProjectという名前の "cache" で接続を構成します。 詳細については、「コンテナー リソースのライフサイクルの」を参照してください。

データ ボリュームを使用して Garnet リソースを追加する

Garnet リソースにデータ ボリュームを追加するには、Garnet リソースで AddGarnet メソッドを呼び出します。

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddGarnet("cache")
                   .WithDataVolume(isReadOnly: false);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

データ ボリュームは、コンテナーのライフサイクル外に Garnet データを保持するために使用されます。 データ ボリュームは Garnet コンテナーの /data パスにマウントされ、name パラメーターが指定されていない場合、名前はランダムに生成されます。 データボリュームの詳細およびそれがバインドマウントよりも優先される理由についての情報は、Dockerドキュメント: ボリュームを参照してください。

データ バインド マウントを使用して Garnet リソースを追加する

Garnet リソースにデータ バインド マウントを追加するには、WithDataBindMount メソッドを呼び出します。

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddGarnet("cache")
                   .WithDataBindMount(
                       source: @"C:\Garnet\Data",
                       isReadOnly: false);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

データ バインド マウントは、コンテナーの再起動の間に Garnet データを保持するために、ホスト マシンのファイルシステムに依存します。 データ バインド マウントは、Garnet コンテナー内のホスト コンピューター上の Windows 上の C:\Garnet\Data (または /Garnet/Dataの Unix) パスにマウントされます。 データバインドマウントの詳細については、Docker ドキュメント: バインドマウントを参照してください。

永続化を使用して Garnet リソースを追加する

Garnet リソースに永続化を追加するには、データ ボリュームまたはデータ バインド マウントを使用して WithPersistence メソッドを呼び出します。

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddGarnet("cache")
                   .WithDataVolume()
                   .WithPersistence(
                       interval: TimeSpan.FromMinutes(5),
                       keysChangedThreshold: 100);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

上記のコードでは、指定された間隔としきい値で Garnet データのスナップショットを取得することで、Redis リソースに永続化を追加します。 interval はスナップショットのエクスポートから keysChangedThreshold までの時間であり、スナップショットのトリガーに必要なキー変更操作の数です。 永続化の詳細については、「Redis ドキュメント: 永続化の」を参照してください。

Valkey ホスティング統合では、Valkey リソースが ValkeyResource の種類としてモデル化されます。 この型や、📦Aspireに追加できる API にアクセスするには、Hosting.Valkey NuGet パッケージを アプリホスト プロジェクト内で利用してください。

dotnet add package Aspire.Hosting.Valkey

<PackageReference Include="Aspire.Hosting.Valkey"
                  Version="*" />

詳細については、「dotnet パッケージ の追加」または「.NET アプリケーションでのパッケージの依存関係の管理」を参照してください。

Valkey リソースの追加

アプリ ホスト プロジェクトで、AddValkey インスタンスの builder を呼び出して Valkey リソースを追加します。

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddValkey("cache");

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

.NET .NET Aspire 前の例で示したように、docker.io/valkey/valkey イメージを使用してコンテナー イメージをアプリ ホストに追加すると、ローカル コンピューターに新しい Valkey インスタンスが作成されます。 Valkey リソース (cache 変数) への参照が ExampleProjectに追加されます。

WithReference メソッドは、ExampleProjectという名前の "cache" で接続を構成します。 詳細については、「コンテナー リソースのライフサイクルの」を参照してください。

データ ボリュームを使用して Valkey リソースを追加する

Valkey リソースにデータ ボリュームを追加するには、Valkey リソースで AddValkey メソッドを呼び出します。

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddValkey("cache")
                   .WithDataVolume(isReadOnly: false);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

データ ボリュームは、コンテナーのライフサイクル外に Valkey データを保持するために使用されます。 データ ボリュームは Valkey コンテナーの /data パスにマウントされ、name パラメーターが指定されていない場合、名前はランダムに生成されます。 データボリュームの詳細およびそれがバインドマウントよりも優先される理由についての情報は、Dockerドキュメント: ボリュームを参照してください。

データ バインド マウントを使用して Valkey リソースを追加する

Valkey リソースにデータ バインド マウントを追加するには、WithDataBindMount メソッドを呼び出します。

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddValkey("cache")
                   .WithDataBindMount(
                       source: @"C:\Valkey\Data",
                       isReadOnly: false);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

データ バインド マウントは、コンテナーの再起動の間に Valkey データを保持するために、ホスト マシンのファイルシステムに依存します。 データ バインド マウントは、Valkey コンテナー内のホスト コンピューター上の Windows 上の C:\Valkey\Data (または /Valkey/Data上の Unix) パスにマウントされます。 データバインドマウントの詳細については、Docker ドキュメント: バインドマウントを参照してください。

永続性を持つValkeyリソースを追加する

Valkey リソースに永続化を追加するには、データ ボリュームまたはデータ バインド マウントを使用して WithPersistence メソッドを呼び出します。

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddValkey("cache")
                   .WithDataVolume()
                   .WithPersistence(
                       interval: TimeSpan.FromMinutes(5),
                       keysChangedThreshold: 100);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

上記のコードでは、指定した間隔としきい値で Valkey データのスナップショットを取得することで、Redis リソースに永続化を追加します。 interval はスナップショットのエクスポートから keysChangedThreshold までの時間であり、スナップショットのトリガーに必要なキー変更操作の数です。 永続化の詳細については、「Redis ドキュメント: 永続化の」を参照してください。