.NET Aspire Redis분산 캐싱 통합^* ®

.NET Aspire Redis 분산 캐싱 통합을 사용하는 방법을 알아봅니다. Aspire.StackExchange.Redis.DistributedCaching 라이브러리는 Redisserver에 의해 지원되는 IDistributedCache 공급자를 docker.io/library/redis 컨테이너 이미지에 등록하는 데 사용됩니다.

.NET Aspire Redis 분산 캐싱 통합을 사용하는 방법을 알아봅니다. Aspire.StackExchange.Redis.DistributedCaching 라이브러리는 Garnetserver에 의해 지원되는 IDistributedCache 공급자를 ghcr.io/microsoft/garnet 컨테이너 이미지에 등록하는 데 사용됩니다.

.NET Aspire Redis 분산 캐싱 통합을 사용하는 방법을 알아봅니다. Aspire.StackExchange.Redis.DistributedCaching 라이브러리는 docker.io/valkey/valkey 컨테이너 이미지으로 지원되는 Valkeyserver에 의해 IDistributedCache 공급자를 등록하는 데 사용됩니다.

Redis 호스팅 통합은 Redis 리소스를 RedisResource 형식으로 모델화합니다. 이 형식 및 API에 액세스하여 📦Aspire.호스팅에 추가하려면, 앱 호스트 프로젝트에서Redis NuGet 패키지를 사용해야 합니다.

dotnet add package Aspire.Hosting.Redis

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

자세한 내용을 보려면 dotnet add package 또는 .NET 응용 프로그램에서 패키지 종속성 관리를 참조하세요.

Redis 리소스 추가

앱 호스트 프로젝트에서 builder 인스턴스에서 AddRedis 호출하여 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 메서드는 "cache"라는 이름의 ExampleProject에서 연결을 구성합니다. 자세한 내용은 컨테이너 리소스 수명 주기참조하세요.

Redis Insights를 사용하여 Redis 리소스 추가

Redis InsightsRedis 리소스에 추가하려면 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 도우미인 Redis Copilot의 도움을 받아 모든 운영 체제 및 Redis 배포에서 Redis 데이터를 분석하기 위한 무료 그래픽 인터페이스입니다. .NET .NET Aspire은 사령관 앱을 실행하는 앱 호스트에 또 다른 컨테이너 이미지 docker.io/redis/redisinsight를 추가합니다.

Redis Commander를 사용하여 Redis 리소스 추가

Redis 사령관Redis 리소스에 추가하려면 WithRedisCommander 메서드를 호출합니다.

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는 Redis 데이터베이스를 보고 편집하고 관리하는 데 사용되는 Node.js 웹 애플리케이션입니다. .NET .NET Aspire 앱 호스트에 다른 컨테이너 이미지 docker.io/rediscommander/redis-commander를 추가하며, 이 호스트는 사령관 앱을 실행합니다.

Redis 리소스를 데이터 볼륨과 함께 추가

Redis 리소스에 데이터 볼륨을 추가하려면 Redis 리소스에서 WithDataVolume 메서드를 호출합니다.

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 데이터를 유지하는 데 사용됩니다. 데이터 볼륨은 Redis 컨테이너의 /data 경로에 탑재되고 name 매개 변수가 제공되지 않으면 이름이 임의로 생성됩니다. 데이터 볼륨에 대한 자세한 정보 및에서 바인드 마운트보다 선호되는 이유에 대해 알고 싶다면, 문서, 즉 볼륨를 확인하세요.

데이터 바인드 마운트를 사용하여 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 데이터를 지속적으로 유지합니다. 데이터 바인드 마운트는 Redis 컨테이너 내의 호스트 컴퓨터에서 Windows의 C:\Redis\Data 경로에 (또는 Unix의 /Redis/Data 경로에) 마운트됩니다. 데이터 바인드 마운트에 대한 자세한 내용은 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에 추가하려면 NuGet 패키지을/를 앱 호스트 프로젝트의 Hosting.Garnet에서 사용하세요.

dotnet add package Aspire.Hosting.Garnet

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

자세한 내용은 dotnet add package 또는 .NET 애플리케이션에서 패키지 종속성을 관리하기를 참조하세요.

Garnet 리소스 추가

앱 호스트 프로젝트에서 builder 인스턴스에서 AddGarnet 호출하여 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 메서드는 "cache"라는 이름의 ExampleProject 연결을 구성합니다. 자세한 내용은 컨테이너 리소스 수명 주기참조하세요.

데이터 볼륨을 사용하여 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 매개 변수가 제공되지 않으면 이름이 임의로 생성됩니다. 데이터 볼륨 및바인드 마운트보다 선호하는 이유에 대한 자세한 내용은 문서: 볼륨를 참조하세요.

데이터 바인드 마운트를 사용하여 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 경로(또는 Unix의 /Garnet/Data 경로)에 마운트됩니다. 데이터 바인드 마운트에 대한 자세한 내용은 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 형식으로 모델화합니다. 이 형식과 API에 액세스하여 📦Aspire에 추가하려면 앱 호스트 프로젝트에서 Hosting.Valkey NuGet 패키지를 사용하십시오.

dotnet add package Aspire.Hosting.Valkey

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

자세한 내용은 dotnet add package 또는 .NET 애플리케이션에서 패키지 종속성을 관리하기.

Valkey 리소스 추가

앱 호스트 프로젝트에서 builder 인스턴스에서 AddValkey 호출하여 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 매개 변수가 제공되지 않으면 이름이 임의로 생성됩니다. 데이터 볼륨에 대한 정보와바인드 마운트보다 선호되는 이유는 문서의 '볼륨'에서 참조하시기 바랍니다.

데이터 바인드 마운트를 사용하여 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 경로(또는 Unix의 /Valkey/Data 경로)에 데이터 바인드 탑재가 이루어집니다. 자세한 내용을 원하시면 데이터 바인드 마운트에 대한 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 문서: 지속성참조하세요.

Azure Redis 호스팅 통합

Redis 리소스를 Azure에 배포하려면 📦Aspire호스팅 설치 후Azure.Redis NuGet 패키지를 사용하십시오.

dotnet add package Aspire.Hosting.Azure.Redis

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

Azure Cache for Redis server 리소스 추가

.NET Aspire 호스팅 AzureRedis 패키지를 설치한 후 앱 호스트 프로젝트에서 AddAzureRedis 확장 메서드를 호출합니다.

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddAzureRedis("azcache")

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

이전에 AddAzureRedis에 대한 호출은 Redisserver 리소스를 Azure Cache for Redis로 배포하기 위해 구성합니다.

Azure Cache for Redis 분산 client 추가

기본적으로 Redis 호스팅 통합에서 AddAzureRedis를 호출하면 Microsoft의 📦를 구성합니다. 이때Azure.StackExchangeRedis NuGet 패키지를 사용하여 인증이 활성화됩니다.

dotnet add package Microsoft.Azure.StackExchangeRedis

<PackageReference Include="Microsoft.Azure.StackExchangeRedis"
                  Version="*" />

Redis 연결은 client 통합 및 Microsoft.Azure.StackExchangeRedis를 사용하여 구현할 수 있습니다. 다음 구성 코드를 고려합니다.

var azureOptionsProvider = new AzureOptionsProvider();

var configurationOptions = ConfigurationOptions.Parse(
    builder.Configuration.GetConnectionString("cache") ?? 
    throw new InvalidOperationException("Could not find a 'cache' connection string."));

if (configurationOptions.EndPoints.Any(azureOptionsProvider.IsMatch))
{
    await configurationOptions.ConfigureForAzureWithTokenCredentialAsync(
        new DefaultAzureCredential());
}

builder.AddRedisDistributedCache("cache", configureOptions: options =>
{
    options.Defaults = configurationOptions.Defaults;
});

자세한 내용은 Microsoft를 참조하세요.Azure. StackExchangeRedis 리포지토리입니다.