빠른 시작: .NET Core에서 Azure Cache for Redis 사용

아티클
11/19/2024

이 빠른 시작에서는 Azure 내 모든 애플리케이션에서 액세스할 수 있는 안전한 전용 캐시에 액세스할 수 있도록 Azure Cache for Redis를 .NET Core 앱에 통합합니다. 구체적으로 .NET Core 콘솔 앱에서 C# 코드를 통해 StackExchange.Redis 클라이언트를 사용합니다.

GitHub에서 리포지토리 https://github.com/Azure-Samples/azure-cache-redis-samples/tree/main/quickstart/dotnet-core를 복제합니다.

필수 조건

Azure 구독 - 체험 구독 만들기
.NET Core SDK

캐시 만들기

캐시를 만들려면 Azure Portal에 로그인합니다. 포털 메뉴에서 리소스 만들기를 선택합니다.
시작 창의 검색 창에서 Aure Cache for Redis를 입력합니다. 검색 결과에서 Azure Cache for Redis를 찾은 다음, 만들기를 선택합니다.

새 Redis Cache 창의 기본 탭에서 캐시에 대해 다음 설정을 구성합니다.

설정	작업	설명
구독	Azure 구독을 선택합니다.	Azure Cache for Redis의 새 인스턴스를 만드는 데 사용할 구독.
리소스 그룹	리소스 그룹을 선택하거나 새로 만들기를 선택하고 새 리소스 그룹 이름을 입력합니다.	캐시 및 기타 리소스를 만들 리소스 그룹의 이름. 모든 앱 리소스를 하나의 리소스 그룹에 배치하면 앱 리소스를 쉽게 관리하거나 삭제할 수 있습니다.
DNS 이름	고유한 이름을 입력합니다.	캐시 이름은 숫자, 문자 및 하이픈만 포함하는 1~63자의 문자열이어야 합니다. 이름은 숫자 또는 문자로 시작하고 끝나야 하며 연속 하이픈을 포함할 수 없습니다. 캐시 인스턴스의 호스트 이름은 `\<DNS name>.redis.cache.windows.net`입니다.
위치	위치를 선택합니다.	캐시를 사용하는 다른 서비스 근처에 있는 Azure 지역.
캐시 SKU	SKU를 선택합니다.	SKU는 캐시에 사용할 수 있는 크기, 성능 및 기능 매개 변수를 결정합니다. 자세한 내용은 Azure Cache for Redis 개요를 참조하세요.
캐시 크기	캐시 크기를 선택합니다.	자세한 내용은 Azure Cache for Redis 개요를 참조하세요.

네트워킹 탭을 선택하거나 다음: 네트워킹을 선택합니다.
네트워킹 탭에서 캐시에 사용할 연결 방법을 선택합니다.
고급 탭을 선택하거나 다음: 고급을 선택합니다.
고급 창에서 다음 정보에 따라 인증 방법을 확인하거나 선택합니다.
- 기본적으로 새 기본, 표준 또는 프리미엄 캐시의 경우 Microsoft Entra 인증이 활성화되고 액세스 키 인증이 비활성화됩니다.
- 기본 또는 표준 캐시의 경우 비 TLS 포트 선택 영역을 선택/해제할 수 있습니다.
- 표준 및 프리미엄 캐시의 경우 가용성 영역을 사용하도록 선택할 수 있습니다. 캐시를 만든 후에는 가용성 영역을 비활성화할 수 없습니다.
- 프리미엄 캐시의 경우 비 TLS 포트, 클러스터링, 관리 ID 및 데이터 지속성에 대한 설정을 구성합니다.
Important

최적의 보안을 위해 관리 ID와 함께 Microsoft Entra ID를 사용하여 가능한 경우 캐시에 대한 요청에 권한을 부여하는 것이 좋습니다. Microsoft Entra ID 및 관리 ID를 사용한 인증은 공유 액세스 키 인증에 비해 뛰어난 보안과 사용 편의성을 제공합니다. 캐시에서 관리 ID를 사용하는 방법에 대한 자세한 내용은 캐시 인증을 위한 Microsoft Entra ID 사용을 참조하세요.
(선택 사항) 태그 탭을 선택하거나 다음: 태그를 선택합니다.
(선택 사항) 태그 탭에서 캐시 리소스를 분류하려는 경우 태그 이름과 값을 입력합니다.
검토 + 만들기 단추를 선택합니다.

검토 + 만들기 탭에서 Azure는 자동으로 구성의 유효성을 검사합니다.
녹색 유효성 검사 통과 메시지가 표시되면 만들기를 선택합니다.

새 캐시 배포는 몇 분 동안 발생합니다. Azure Cache for Redis 개요 창에서 배포 진행률을 모니터링할 수 있습니다. 상태가 실행 중으로 표시되면 캐시를 사용할 준비가 된 것입니다.

캐시에서 Microsoft Entra ID 인증 사용

캐시가 있는 경우 Microsoft Entra 인증이 사용하도록 설정되었는지 확인합니다. 그렇지 않은 경우 사용하도록 설정합니다. 앱에는 Microsoft Entra ID를 사용하는 것이 좋습니다.

Azure Portal에서 Microsoft Entra 토큰 기반 인증을 사용하려는 Azure Cache for Redis 인스턴스를 선택합니다.
리소스 메뉴에서 인증을 선택합니다.
작업 창에서 Microsoft Entra 인증 사용이 선택되어 있는지 확인합니다. 그렇다면 계속 진행할 수 있습니다.
Microsoft Entra 인증 사용을 선택하고 유효한 사용자 이름을 입력합니다. 입력한 사용자에게는 저장을 선택하면 기본적으로 데이터 소유자 액세스 정책이 자동으로 할당됩니다. 관리 ID 또는 서비스 주체를 입력하여 캐시 인스턴스에 연결할 수도 있습니다.
구성을 업데이트할지 묻는 팝업 대화 상자가 표시되고, 업데이트하는 데 몇 분이 걸린다는 사실을 알려 줍니다. 예를 선택합니다.

Important

사용 작업이 완료되면 캐시 인스턴스의 노드가 다시 부팅되어 새 구성을 로드합니다. 이 작업은 유지 관리 기간 동안에 수행하거나 가장 바쁜 업무 시간을 피해 수행하는 것이 좋습니다. 이 작업은 최대 30분이 걸릴 수 있습니다.

Azure CLI에서 Microsoft Entra ID를 사용하는 방법에 대한 자세한 내용은 ID 참조 페이지를 참조하세요.

호스트 이름을 기록해 둡다. 이러한 값은 나중에 appsettings.json 데 사용합니다.

연결 문자열에 대한 로컬 비밀 추가

appsettings.json 파일에 다음을 추가합니다.

{
  "RedisHostName": "your_Azure_Redis_hostname"
}

"your_Azure_Redis_hostname"을 Azure Redis 호스트 이름 및 포트 번호로 대체합니다. 예: cache-name.region.redis.azure.net:10000 Azure Managed Redis(미리 보기) 및 cache-name.redis.cache.windows.net:6380 Azure Cache for Redis 서비스의 경우.
파일을 저장합니다.

RedisConnection을 사용하여 캐시에 연결

RedisConnection.cs에서 StackExchange.Redis 네임스페이스가 코드에 추가된 것을 볼 수 있습니다. 이는 RedisConnection 클래스에 필요합니다.

using StackExchange.Redis;

RedisConnection 코드는 StackExchange.Redis에서 ConnectionMultiplexer 인스턴스를 관리하여 항상 정상 캐시 연결이 있도록 보장합니다. RedisConnection 클래스는 연결이 손실되고 자동으로 다시 연결할 수 없을 때 연결을 다시 만듭니다.

자세한 내용은 StackExchange.Redis 및 GitHub 리포지토리의 코드를 참조하세요.

캐시 명령 실행

program.cs에서는 콘솔 애플리케이션의 Program 클래스에 있는 RunRedisCommandsAsync 메서드에 대한 다음 코드가 표시됩니다.

private static async Task RunRedisCommandsAsync(string prefix)
    {
        // Simple PING command
        Console.WriteLine($"{Environment.NewLine}{prefix}: Cache command: PING");
        RedisResult pingResult = await _redisConnection.BasicRetryAsync(async (db) => await db.ExecuteAsync("PING"));
        Console.WriteLine($"{prefix}: Cache response: {pingResult}");

        // Simple get and put of integral data types into the cache
        string key = "Message";
        string value = "Hello! The cache is working from a .NET console app!";

        Console.WriteLine($"{Environment.NewLine}{prefix}: Cache command: GET {key} via StringGetAsync()");
        RedisValue getMessageResult = await _redisConnection.BasicRetryAsync(async (db) => await db.StringGetAsync(key));
        Console.WriteLine($"{prefix}: Cache response: {getMessageResult}");

        Console.WriteLine($"{Environment.NewLine}{prefix}: Cache command: SET {key} \"{value}\" via StringSetAsync()");
        bool stringSetResult = await _redisConnection.BasicRetryAsync(async (db) => await db.StringSetAsync(key, value));
        Console.WriteLine($"{prefix}: Cache response: {stringSetResult}");

        Console.WriteLine($"{Environment.NewLine}{prefix}: Cache command: GET {key} via StringGetAsync()");
        getMessageResult = await _redisConnection.BasicRetryAsync(async (db) => await db.StringGetAsync(key));
        Console.WriteLine($"{prefix}: Cache response: {getMessageResult}");

        // Store serialized object to cache
        Employee e007 = new Employee("007", "Davide Columbo", 100);
        stringSetResult = await _redisConnection.BasicRetryAsync(async (db) => await db.StringSetAsync("e007", JsonSerializer.Serialize(e007)));
        Console.WriteLine($"{Environment.NewLine}{prefix}: Cache response from storing serialized Employee object: {stringSetResult}");

        // Retrieve serialized object from cache
        getMessageResult = await _redisConnection.BasicRetryAsync(async (db) => await db.StringGetAsync("e007"));
        Employee e007FromCache = JsonSerializer.Deserialize<Employee>(getMessageResult);
        Console.WriteLine($"{prefix}: Deserialized Employee .NET object:{Environment.NewLine}");
        Console.WriteLine($"{prefix}: Employee.Name : {e007FromCache.Name}");
        Console.WriteLine($"{prefix}: Employee.Id   : {e007FromCache.Id}");
        Console.WriteLine($"{prefix}: Employee.Age  : {e007FromCache.Age}{Environment.NewLine}");
    }

캐시 항목은 StringSetAsync 및 StringGetAsync 메서드를 사용하여 저장하고 검색할 수 있습니다.

이 예제에서는 Message 키에 값이 설정된 것을 볼 수 있습니다. 앱에서 캐시된 값을 업데이트했습니다. 또한 앱에서 PING 및 명령을 실행했습니다.

캐시의 .NET 개체 사용

Redis 서버는 대부분의 데이터를 문자열로 저장하지만, 이 문자열은 캐시에 .NET 개체를 저장할 때 사용할 수 있는 직렬화된 이진 데이터를 포함하여 다양한 데이터 유형을 포함할 수 있습니다.

Azure Cache for Redis는 .NET 개체 및 기본 데이터 유형을 캐시할 수 있지만 .NET 개체를 캐시하려면 먼저 직렬화해야 합니다.

.NET 개체 직렬화는 애플리케이션 개발자의 책임이며 개발자는 유연하게 직렬 변환기를 선택할 수 있습니다.

다음 Employee 클래스가 Program.cs에 정의되어 있으므로, 샘플에 직렬화된 개체를 가져오고 설정하는 방법도 표시될 수 있습니다.

class Employee
    {
        public string Id { get; set; }
        public string Name { get; set; }
        public int Age { get; set; }

        public Employee(string id, string name, int age)
        {
            Id = id;
            Name = name;
            Age = age;
        }
    }

샘플 실행

파일을 연 경우 파일을 저장하고 다음 명령을 사용하여 앱을 빌드합니다.

dotnet build

다음 명령으로 앱을 실행하여 .NET 개체의 직렬화를 테스트합니다.

dotnet run

완료된 콘솔 앱 파종 스크린샷

리소스 정리

이 문서에서 만든 리소스를 계속 사용하려면 리소스 그룹을 유지합니다.

그렇지 않고 리소스 사용을 완료하는 경우 요금이 부과되지 않도록 하려면 만든 Azure 리소스 그룹을 삭제하면 됩니다.

Important

리소스 그룹을 삭제하면 다시 되돌릴 수 없습니다. 리소스 그룹을 삭제하는 경우 그 안의 모든 리소스가 영구적으로 삭제됩니다. 잘못된 리소스 그룹 또는 리소스를 자동으로 삭제하지 않도록 해야 합니다. 유지하려는 리소스가 포함된 기존 리소스 그룹 내에서 리소스를 만든 경우 리소스 그룹을 삭제하는 대신 각 리소스를 개별적으로 삭제할 수 있습니다.

리소스 그룹을 삭제하려면

Azure Portal에 로그인한 다음, 리소스 그룹을 선택합니다.
삭제하려는 리소스 그룹을 선택합니다.

리소스 그룹이 많은 경우 필드 필터링... 상자를 사용하여 이 문서에 대해 만든 리소스 그룹의 이름을 입력합니다. 결과 목록에서 리소스 그룹을 선택합니다.
리소스 그룹 삭제를 선택합니다.
리소스 그룹 삭제를 확인하는 메시지가 표시됩니다. 리소스 그룹의 이름을 입력하여 확인한 다음, 삭제를 선택합니다.

잠시 후, 리소스 그룹 및 모든 해당 리소스가 삭제됩니다.

다음을 통해 공유

빠른 시작: .NET Core에서 Azure Cache for Redis 사용

필수 조건

캐시 만들기

캐시에서 Microsoft Entra ID 인증 사용

연결 문자열에 대한 로컬 비밀 추가

RedisConnection을 사용하여 캐시에 연결

캐시 명령 실행

캐시의 .NET 개체 사용

샘플 실행

리소스 정리

리소스 그룹을 삭제하려면

다음 단계

피드백

추가 리소스

다음을 통해 공유

빠른 시작: .NET Core에서 Azure Cache for Redis 사용

GitHub의 코드로 건너뛰기

필수 조건

캐시 만들기

캐시에서 Microsoft Entra ID 인증 사용

연결 문자열에 대한 로컬 비밀 추가

RedisConnection을 사용하여 캐시에 연결

캐시 명령 실행

캐시의 .NET 개체 사용

샘플 실행

리소스 정리

리소스 그룹을 삭제하려면

다음 단계

피드백

추가 리소스