.NET Aspire Redis®^* 출력 캐싱 통합

.NET Aspire Redis 출력 캐싱 통합을 사용하는 방법을 알아봅니다. Aspire.StackExchange.Redis.OutputCaching client 통합은 Redisserver에 의해 지원되는 ASP.NET Core 출력 캐싱 공급자를 docker.io/library/redis 컨테이너 이미지와 함께 등록하는 데 사용됩니다.

.NET Aspire Redis 출력 캐싱 통합을 사용하는 방법을 알아봅니다. Aspire.StackExchange.Redis.OutputCaching client 통합은 Garnetserver에 의해 지원되는 ASP.NET Core 출력 캐싱 공급자를 ghcr.io/microsoft/garnet 컨테이너 이미지에 등록하는 데 사용됩니다.

.NET Aspire Redis 출력 캐싱 통합을 사용하는 방법을 알아봅니다. Aspire.StackExchange.Redis.OutputCaching client 통합은 docker.io/valkey/valkey 컨테이너 이미지에 Valkeyserver로 지원되는 ASP.NET Core 출력 캐싱 공급자를 등록하는 데 사용됩니다.

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 메서드는 ExampleProject에 이름이 "cache"인 연결을 구성합니다. 자세한 내용은 컨테이너 리소스 수명 주기참조하세요.

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를 영구적으로 유지합니다. 데이터 바인드 마운트는 Windows의 C:\Redis\Data 경로(또는 Unix경로의 /Redis/Data)에서 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 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 메서드는 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 매개 변수가 제공되지 않으면 이름이 임의로 생성됩니다. 데이터 볼륨과 이를바인드 마운트보다 선호하는 이유에 대한 자세한 내용은 문서, 볼륨를 확인하세요.

데이터 바인드 마운트를 통해 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.AddRedisOutputCache("cache", configureOptions: options =>
{
    options.Defaults = configurationOptions.Defaults;
});

자세한 내용은 MicrosoftAzure.StackExchangeRedis 레포지토리를 참조하세요.