Azure Cache for Redis에 대한 ASP.NET 출력 캐시 공급자

Redis 출력 캐시 공급자는 출력 캐시 데이터에 대한 out-of-process 스토리지 메커니즘입니다. 이 데이터는 완전한 HTTP 응답(페이지 출력 캐싱)에 특별히 사용됩니다. 공급자가 ASP.NET 4에 도입된 새로운 출력 캐시 공급자 확장 포인트에 연결됩니다.

ASP.NET Core 애플리케이션의 경우 .NET 8에서 Redis를 사용하여 ASP.NET Core의 출력 캐싱을 참조하세요.

Redis 출력 캐시 공급자를 사용하려면 먼저 캐시를 구성한 다음, Redis 출력 개시 공급자 NuGet 패키지를 사용하여 사용자의 ASP.NET 애플리케이션을 구성합니다. 이 문서에서는 Redis 출력 캐시 공급자를 사용할 수 있도록 애플리케이션을 구성하는 지침을 제공합니다.

ASP.NET 코어 페이지 출력을 Redis에 저장

전체 기능 사양은 ASP.NET 코어 출력 캐싱을 참조하세요.

사용법을 보여 주는 샘플 애플리케이션은 Redis 출력 캐싱 및 Azure OpenAI를 사용하는 .NET 8 웹 애플리케이션을 참조하세요.

Redis에 ASP.NET 페이지 출력 저장

Azure Cache for Redis 세션 상태 NuGet 패키지를 사용하여 Visual Studio에서 클라이언트 애플리케이션을 구성하려면 도구 메뉴에서 NuGet 패키지 관리자, 패키지 관리자 콘솔을 차례로 클릭합니다.

Package Manager Console 창에서 다음 명령을 실행합니다.

Install-Package Microsoft.Web.RedisOutputCacheProvider

Reids 출력 캐시 공급자 NuGet 패키지는 StackExchange.Redis 패키지에 종속성을 갖습니다. StackExchange.Redis 패키지가 프로젝트에 나타나지 않는 경우 설치됩니다. Redis 출력 캐시 공급자 NuGet 패키지에 대한 자세한 내용은 RedisOutputCacheProvider NuGet 패키지를 참조하세요.

NuGet 패키지에서는 필수 어셈블리 참조를 다운로드하고 추가하며 web.config 파일에 다음 섹션을 추가합니다. 이 섹션에서는 Redis 출력 캐시 공급자를 사용하기 위해 ASP.NET 애플리케이션에 필수 구성을 포함합니다.

<caching>
  <outputCache defaultProvider="MyRedisOutputCache">
    <providers>
      <add name="MyRedisOutputCache" type="Microsoft.Web.Redis.RedisOutputCacheProvider"
           host=""
           accessKey=""
           ssl="true" />
    </providers>
  </outputCache>
</caching>

Microsoft Azure Portal에서 캐시의 값을 사용하여 첫 번째 열의 특성을 구성합니다. 또한 원하는 다른 값을 구성합니다. 캐시 속성에 액세스하는 방법에 대한 지침은 Azure Cache for Redis 설정 구성을 참조하세요.

특성 정보

connectionString 설정

connectionString의 값은 이러한 문자열이 AppSettings에 있는 경우 AppSettings에서 실제 연결 문자열을 페치하는 키로 사용됩니다. AppSettings 내에서 찾을 수 없는 경우 connectionString의 값은 web.config ConnectionString 섹션(해당 섹션이 있는 경우)에서 실제 연결 문자열을 페치하는 키로 사용됩니다. AppSettings 또는 web.config ConnectionString 섹션에 연결 문자열이 없는 경우 StackExchange.Redis.ConnectionMultiplexer를 만들 때 connectionString의 리터럴 값이 연결 문자열로 사용됩니다.

다음 예제에서는 connectionString이 사용되는 방법을 보여 줍니다.

예 1

<connectionStrings>
    <add name="MyRedisConnectionString" connectionString="mycache.redis.cache.windows.net:6380,password=actual access key,ssl=True,abortConnect=False" />
</connectionStrings>

web.config에서는 실제 값 대신 키를 매개 변수 값으로 사용합니다.

<sessionState mode="Custom" customProvider="MySessionStateStore">
    <providers>
        <add type = "Microsoft.Web.Redis.RedisSessionStateProvider"
             name = "MySessionStateStore"
             connectionString = "MyRedisConnectionString"/>
    </providers>
</sessionState>

예제 2

<appSettings>
    <add key="MyRedisConnectionString" value="mycache.redis.cache.windows.net:6380,password=actual access key,ssl=True,abortConnect=False" />
</appSettings>

web.config에서는 실제 값 대신 키를 매개 변수 값으로 사용합니다.

<sessionState mode="Custom" customProvider="MySessionStateStore">
    <providers>
        <add type = "Microsoft.Web.Redis.RedisSessionStateProvider"
             name = "MySessionStateStore"
             connectionString = "MyRedisConnectionString"/>
    </providers>
</sessionState>

예 3

<sessionState mode="Custom" customProvider="MySessionStateStore">
    <providers>
        <add type = "Microsoft.Web.Redis.RedisSessionStateProvider"
             name = "MySessionStateStore"
             connectionString = "mycache.redis.cache.windows.net:6380,password=actual access key,ssl=True,abortConnect=False"/>
    </providers>
</sessionState>

throwOnError에 대한 참고 사항

현재 세션 작업 중에 오류가 발생하는 경우 세션 상태 제공자가 예외를 발생시킵니다. 예외를 발생시키면 애플리케이션이 종료됩니다.

이 동작은 기존 ASP.NET 세션 상태 제공자 사용자의 기대 사항을 지원하는 방식으로 수정되었으며, 예외에 대한 작업 또한 수행할 수 있도록 합니다. 다른 ASP.NET 세션 상태 제공자와 일치하는 오류가 발생하는 경우 기본 동작은 여전히 예외를 발생시킵니다. 기존 코드는 이전과 동일하게 작동해야 합니다.

throwOnError를 false로 설정하는 경우 오류가 발생할 때 예외를 발생시키는 대신 자동으로 실패합니다. 오류가 있었는지 확인하고 오류가 있는 경우 예외를 확인하고, 정적 속성 Microsoft.Web.Redis.RedisSessionStateProvider.LastException을 확인합니다.

retryTimeoutInMilliseconds에 대한 참고 사항

retryTimeoutInMilliseconds 설정은 네트워크 결함 또는 다른 항목으로 인한 실패 시 세션 작업을 다시 시도해야 하는 경우를 간소화하는 몇 가지 논리를 제공합니다. retryTimeoutInMilliseconds 설정을 사용하여 재시도 시간 제한을 제어하거나 재시도를 완전히 옵트아웃할 수도 있습니다.

retryTimeoutInMilliseconds를 숫자(예: 2000)로 설정하는 경우, 세션 작업이 실패하면 이를 오류로 처리하기 전에 2,000밀리초 동안 다시 시도합니다. 따라서 세션 상태 제공자가 이 재시도 논리를 적용하도록 하려면 시간 제한을 구성하면 됩니다. 첫 번째 다시 시도는 20밀리초 후에 수행되며, 네트워크 결함이 발생하는 경우 대부분의 경우에서 충분합니다. 그런 다음 시간이 초과될 때까지 매초마다 다시 시도합니다. 시간 제한 직후에는 다시 한번 더 시도하여 시간 제한을 최대 1초까지 단축하지 않도록 합니다.

다시 시도해야 한다고 생각되지 않거나 또는 다시 시도 논리를 직접 처리하려는 경우 retryTimeoutInMilliseconds를 0으로 설정합니다. 예를 들어 애플리케이션과 동일한 머신에서 Redis 서버를 실행하는 경우 재시도를 원하지 않을 수 있습니다.

redisSerializerType 정보

Redis에 값을 저장하는 serialization은 기본값으로 BinaryFormatter 클래스에서 제공하는 이진 형식으로 수행됩니다. redisSerializerType을 사용하여 Microsoft.Web.Redis.ISerializer를 구현하는 클래스의 정규화된 어셈블리 형식 이름을 지정하고, 값을 직렬화 및 역직렬화할 수 있는 사용자 지정 논리를 사용합니다. 예를 들어 다음은 JSON.NET을 사용하는 Json 직렬 변환기 클래스입니다.

namespace MyCompany.Redis
{
    public class JsonSerializer : ISerializer
    {
        private static JsonSerializerSettings _settings = new JsonSerializerSettings() { TypeNameHandling = TypeNameHandling.All };

        public byte[] Serialize(object data)
        {
            return Encoding.UTF8.GetBytes(JsonConvert.SerializeObject(data, _settings));
        }

        public object Deserialize(byte[] data)
        {
            if (data == null)
            {
                return null;
            }
            return JsonConvert.DeserializeObject(Encoding.UTF8.GetString(data), _settings);
        }
    }
}

이 클래스가 이름이 MyCompanyDll인 어셈블리에 정의된 것으로 가정하여 redisSerializerType 매개 변수를 사용하도록 설정할 수 있습니다.

<sessionState mode="Custom" customProvider="MySessionStateStore">
    <providers>
        <add type = "Microsoft.Web.Redis.RedisSessionStateProvider"
             name = "MySessionStateStore"
             redisSerializerType = "MyCompany.Redis.JsonSerializer,MyCompanyDll"
             ... />
    </providers>
</sessionState>

출력 캐시 지시문

출력을 캐시하고자 하는 각 페이지에 OutputCache 지시문을 추가합니다.

<%@ OutputCache Duration="60" VaryByParam="*" %>

이전 예제에서는 캐시된 페이지 데이터가 캐시에 60초 동안 머물게 되며, 각 매개 변수 조합에 따라 페이지의 다른 버전이 캐시됩니다. 출력 캐시 지시문에 대한 자세한 내용은 @OutputCache를 참조하세요.

이 단계를 수행하고 나면, 애플리케이션은 Redis 출력 캐시 공급자를 사용하도록 구성됩니다.

타사 출력 캐시 공급자

• NCache
• Apache Ignite

관련 콘텐츠

Azure Cache for Redis에 대한 ASP.NET 세션 상태 제공자를 살펴봅니다.