다음을 통해 공유

Azure Managed Redis와 함께 Redis 명령줄 도구 사용(미리 보기)

  • 아티클

redis-cli 명령줄 도구를 사용하여 Azure Managed Redis(미리 보기)와 클라이언트로 상호 작용합니다. 이 도구를 사용하여 Azure Managed Redis 인스턴스와 직접 상호 작용하고 디버깅 및 문제 해결을 수행할 수 있습니다.

redis-cli 설치

redis-cli 도구는 여러 운영 체제에서 사용할 수 있는 Redis 패키지와 함께 자동으로 설치됩니다. 선호하는 운영 체제에 대한 가장 자세한 설명서는 오픈 소스 Redis 설치 가이드를 참조하세요.

Linux

redis-cli는 기본적으로 Linux에서 실행되며 대부분의 배포에는 redis-cli 도구가 포함된 Redis 패키지가 있습니다. 예를 들어 Ubuntu에서는 다음 명령을 사용하여 Redis 패키지를 설치합니다.

sudo apt-get update
sudo apt-get install redis

Windows

Windows 컴퓨터에서 redis-cli를 사용하는 가장 좋은 방법은 WSL(Linux용 Windows 하위 시스템)을 설치하는 것입니다. Linux 하위 시스템을 사용하면 Windows에서 Linux 도구를 직접 실행할 수 있습니다. WSL을 설치하려면 WSL 설치 지침에 따릅니다.

WSL이 설치되면 WSL에 대해 선택한 Linux Distro에서 사용 가능한 패키지 관리를 사용하여 redis-cli를 설치할 수 있습니다.

캐시 액세스 정보 수집

캐시에 액세스하는 데 필요한 정보는 다음 세 가지 방법으로 수집할 수 있습니다.

  • az redisenterprise database list-keys를 사용하는 Azure CLI
  • Get-AzRedisEnterpriseCacheKey를 사용하는 Azure PowerShell
  • Azure 포털 사용하기

이 섹션에서는 Azure Portal에서 키를 검색합니다.

Azure Portal에서 호스트 이름, 포트 및 액세스 키를 검색합니다.

Azure Cache for Redis 서버를 연결하려면 캐시 클라이언트에 캐시에 대한 호스트 이름, 포트 및 키가 필요합니다. 일부 클라이언트는 약간 다른 이름으로 이러한 항목을 참조할 수 있습니다. Azure Portal에서 호스트 이름, 포트 및 키를 가져올 수 있습니다.

  • 액세스 키를 가져오려면 리소스 메뉴에서 인증을 선택합니다. 그런 다음 액세스 키 탭을 선택합니다.

    Azure Cache for Redis 액세스 키를 보여 주는 스크린샷

  • 캐시의 호스트 이름과 포트를 확인하려면 리소스 메뉴에서 개요를 선택합니다. 호스트 이름은 <DNS name>.redis.cache.windows.net 형식입니다.

    Azure Cache for Redis 속성을 보여 주는 스크린샷

redis-cli를 사용하여 연결

Redis 패키지가 설치된 컴퓨터에서 셸 또는 터미널을 엽니다. WSL을 사용하는 경우 Windows 터미널을 사용하여 Linux 명령줄을 열 수 있습니다. redis-cli로 연결하기 전에 다음을 확인합니다.

  1. TLS 액세스가 필요한지 여부 - 기본적으로 Azure Managed Redis 인스턴스는 연결에 TLS 암호화를 사용합니다. 서버 쪽에서 TLS를 사용할 때마다 --tls 옵션을 사용하여 redis-cli의 TLS를 사용하도록 설정해야 합니다.
  2. 사용된 포트 - 모든 Azure Managed Redis 인스턴스는 포트 10000를 사용합니다. Redis Community Edition의 기본값인 6379.
  3. 캐시 인스턴스에서 OSS 클러스터 정책을 사용하는지 여부 - OSS 클러스터 정책을 사용하는 경우 모든 분할된 데이터베이스에 액세스할 수 있도록 하는 옵션을 추가 -c합니다.

예제

  1. TLS에서 엔터프라이즈 클러스터 정책을 사용하여 Azure Managed Redis 인스턴스에 연결합니다.

    redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tls

  2. OSS 클러스터 정책 및 TLS를 사용하여 Azure Managed Redis 인스턴스에 연결합니다.

    redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tls -c

연결 테스트

연결이 설정되면 Azure Managed Redis 인스턴스에 명령을 실행할 수 있습니다. 연결을 테스트하는 쉬운 방법 중 하나는 PING 명령의 사용입니다. 이 명령은 콘솔에서 PONG을(를) 반환합니다.

yourcachename.region.redis.azure.net:10000> PING
PONG

SET 및 GET 같은 명령을 실행할 수도 있습니다.

yourcachename.region.redis.azure.net:10000> SET hello world
OK
yourcachename.region.redis.azure.net:10000> GET hello
"world"

이제 redis-cli를 사용하여 Azure Managed Redis 인스턴스에 연결되었습니다.

redis-cli 대안

redis-cli는 유용한 도구이지만 문제 해결 또는 테스트를 위해 다른 방법으로 캐시에 연결할 수 있습니다.

  • RedisInsight는 Redis 명령을 실행하고 Redis 인스턴스의 콘텐츠를 보기 위한 풍부한 오픈 소스 그래픽 도구입니다. Azure Managed Redis에서 작동하며 Linux, Windows 및 macOS에서 지원됩니다.

관련 콘텐츠

새 Azure Managed Redis Instance 인스턴스를 만들어 시작합니다.