방법: Azure In-Role Cache를 사용하도록 Visual Studio 준비

중요

Microsoft는 모든 새 개발에서 Azure Redis Cache를 사용하는 것이 좋습니다. Azure Cache 제품 선택에 대한 현재 설명서 및 지침 은 나에게 적합한 Azure Cache 제품을 참조하세요.

이 항목에서는 Microsoft Azure Cache를 사용하도록 Visual Studio 프로젝트를 준비하는 방법을 설명합니다. 여기에는 다음 작업이 포함됩니다.

  • 올바른 버전의 .NET Framework가 대상으로 지정되어 있는지 확인합니다.

  • 캐싱 어셈블리를 참조합니다.

이러한 작업 후에는 애플리케이션 또는 web.config 파일의 dataCacheClient 섹션에서 캐시 클라이언트를 구성할 수 있습니다. 이렇게 하면 Microsoft.ApplicationServer.Caching 네임스페이스에서 캐싱 메서드를 사용할 수 있습니다.

경고

동일한 컴퓨터에 Microsoft Windows Server용 AppFabric 1.1 및 Microsoft Azure Cache를 설치하면 안 됩니다. 여기에는 제품 및 SDK가 모두 포함됩니다. 전역 어셈블리 캐시에서 일부 Microsoft Windows Server용 AppFabric 1.1 어셈블리를 실수로 참조할 수 있습니다. 잘못된 동작이나 예기치 않은 동작이 발생할 수 있습니다.

올바른 .NET Framework 버전을 대상으로 지정하려면

  1. Visual Studio 프로젝트를 엽니다.

  2. 솔루션 탐색기에서 프로젝트 이름을 마우스 오른쪽 단추로 클릭한 다음 속성을 선택합니다.

  3. Visual C# 프로젝트의 경우에는 다음 단계를 사용합니다.

    1. 프로젝트 속성 대화 상자의 응용 프로그램 탭을 선택합니다.

    2. 대상 Framework 버전이 .NET Framework 2.0 이상(비 클라이언트 프로필)인지 확인합니다.

  4. Visual Basic 프로젝트의 경우에는 다음 단계를 사용합니다.

    1. 프로젝트 속성 페이지의 컴파일 섹션을 선택합니다.

    2. 컴파일 페이지 아래쪽의 고급 컴파일 옵션 단추를 클릭합니다.

    3. 대상 Framework 버전이 .NET Framework 2.0 이상(비 클라이언트 프로필)인지 확인합니다.

중요

대상 Framework 버전에 클라이언트 프로필을 사용하지 마세요. Visual Studio "클라이언트 프로필"을 지정하지 않는 .NET Framework 버전을 선택합니다.

역할에서 캐싱용 프로젝트 구성

어셈블리 참조를 추가하려면 컴퓨터에 Azure SDK가 설치되어 있어야 합니다. 자세한 내용은 Azure SDK 다운로드를 참조하세요.

다음 단계에서는 NuGet 패키지를 사용하여 필수 어셈블리 참조와 구성 변경 사항을 추가합니다. 이러한 단계는 동일한 배포에서 Azure 역할에 호스트되는 In-Role Cache를 사용하는 것과 관련이 있습니다.

  1. 솔루션 탐색기에서 프로젝트 이름을 마우스 오른쪽 단추로 클릭한 다음 라이브러리 패키지 참조 추가(NuGet 1.2) 또는 NuGet 패키지 관리(NuGet 2.0 이상)를 선택합니다.

  2. 왼쪽 창에서 온라인 범주를 선택합니다.

  3. WindowsAzure.Caching을 검색합니다.

  4. Microsoft.WindowsAzure.Caching(NuGet 1.2) 또는 Azure 캐싱(NuGet 2.0 이상)이라는 In-Role Cache 패키지를 설치합니다.

    Screenshot of Caching Preview Package (NuGet 1.2)

    Screenshot of Caching Preview Package (NuGet 2.0)

이 패키지는 해당 어셈블리 참조를 추가할 뿐만 아니라 대상 프로젝트의 구성 파일(app.config 또는 web.config)도 수정합니다. 다음과 유사한 상용구 dataCacheClient 섹션을 추가합니다.

<dataCacheClients>
  <dataCacheClient name="default">
    <autoDiscover isEnabled="true" identifier="[cache cluster role name]" />
    <!--<localCache isEnabled="true" sync="TimeoutBased" objectCount="100000" ttlValue="300" />-->
  </dataCacheClient>
</dataCacheClients>

마지막 단계는 식별자 특성을 "[cache cluster role name]" In-Role 캐시를 사용하도록 설정한 역할의 실제 이름으로 변경하는 것입니다. 같은 위치에 배치된 토폴로지에서는 "WebRole1"과 같이 동일한 역할의 이름을 사용할 수 있습니다. 전용 토폴로지에서는 다음과 같은 "CacheWorkerRole1"다른 역할이 될 수 있습니다. 두 토폴로지의 샘플은 Azure In-Role Cache 샘플을 참조하세요.

참고

NuGet 패키지를 제거해도 해당 섹션이 사용자 지정된 경우 dataCacheClients 섹션이 제거되지 않습니다. 수동으로 제거해야 합니다.

NuGet 패키지는 다음 어셈블리에 대한 참조를 추가합니다.

  • Microsoft.ApplicationServer.Caching.AzureClientHelper

  • Microsoft.ApplicationServer.Caching.AzureCommon

  • Microsoft.ApplicationServer.Caching.Client

  • Microsoft.ApplicationServer.Caching.Core

  • Microsoft.Web.DistributedCache

  • Microsoft.WindowsFabric.Common

  • Microsoft.WindowsFabric.Data.Common

참고

NuGet 패키지를 사용하지 않고 이러한 어셈블리를 수동으로 참조할 수 있습니다. 기본적으로 C:\Program Files\Microsoft SDKs\Azure\.NET SDK&lt;current version>\ref\Caching에 설치됩니다.

참고 항목

개념

Azure In-Role Cache 개발
Azure 역할 내 캐시용 ASP.NET 4 캐시 공급자