다음 도구를 사용하여 Azure Managed Redis에서 클라이언트로 데이터에 액세스하고 관리할 수 있습니다. 이러한 도구를 사용하여 Azure Managed Redis 인스턴스와 직접 상호 작용하고 디버깅 및 문제 해결을 위해 사용합니다.
- Redis Insight
- redis-cli 명령줄 도구
Redis Insight
Redis Insight 는 Redis 명령을 실행하고 Redis 인스턴스의 콘텐츠를 보기 위한 풍부한 오픈 소스 그래픽 및 CLI 도구입니다. Azure Managed Redis에서 작동하며 Linux, Windows 및 macOS에서 지원됩니다.
Redis Insight 설치
Redis Insight를 설치하려면 Redis Insight 설명서의 지침을 따릅니다.
팁 (조언)
설치하는 동안 EULA 및 개인 정보 설정 페이지에서 권장 설정 사용을 선택하는 것이 좋습니다.
Redis Insight를 사용하여 Azure Managed Redis에 대한 액세스 구성
Redis Insight는 Microsoft Entra ID 또는 액세스 키 인증을 사용하여 Managed Redis 인스턴스를 Azure 인증할 수 있습니다. 보안을 강화하려면 Microsoft Entra ID 사용하는 것이 좋습니다.
버전 3.2.0부터 Redis Insight는 PKCE OAuth 2.0 흐름을 활용하여 Microsoft Entra ID로 Azure Managed Redis에 인증할 수 있으며, 이를 통해 구독 간 데이터베이스를 자동으로 검색하고 암호 없이 인증할 수 있습니다.
Redis Insight를 사용하여 Azure Managed Redis에 대한 액세스를 구성하는 지침은 Redis Insight GitHub 리포지토리 참조하세요. Azure 테넌트당 일회성 설정입니다.
Redis Insight를 사용하여 Azure Managed Redis에 연결
Microsoft Entra ID 액세스가 구성되면 다음 단계를 수행하여 Redis Insight의 Azure Managed Redis 인스턴스에 연결합니다.
- Redis Insight의 Redis 데이터베이스 탭에서 + 기존 데이터베이스 연결을 선택합니다.
- 데이터베이스 추가 창에서 Azure Managed Redis를 선택합니다.
- 프롬프트에 따라 Microsoft Entra ID 인증을 사용하여 연결합니다.
- Subscription 페이지에서 Azure Managed Redis 인스턴스가 포함된 구독을 선택하고 데이터베이스 추가를 선택합니다.
- 연결할 Azure Managed Redis 인스턴스(데이터베이스)를 선택한 다음 데이터베이스 추가를 선택합니다. 동시에 연결할 여러 데이터베이스를 선택할 수 있습니다.
- 이전 단계를 반복하여 동일하거나 다른 Azure 구독에서 필요에 따라 Azure Managed Redis 인스턴스를 추가합니다.
Azure Managed Redis 인스턴스를 추가한 후 Redis Insight의 Redis 데이터베이스 목록에서 해당 인스턴스를 선택하고 명령 실행 및 데이터 보기를 시작할 수 있습니다.
기본 제공 CLI에 액세스하려면 선택한 데이터베이스에 대한 화면 아래쪽에서 (>_ CLI)를 선택합니다.
redis-cli 명령줄 도구
redis-cli 명령줄 도구를 사용하여 Azure Managed Redis 인스턴스와 클라이언트로 상호 작용합니다. 명령을 실행하고 스크립트에서 반복 가능한 테스트를 수행하는 간단한 방법으로 redis_cli 사용합니다.
redis-cli 설치
redis-cli 도구는 여러 운영 체제에서 사용할 수 있는 Redis 패키지와 함께 자동으로 설치됩니다. 선호하는 운영 체제에 대한 가장 자세한 설명서는 open source 설치 가이드를 참조하세요.
리눅스
redis-cli는 기본적으로 Linux에서 실행되며 대부분의 배포에는 redis-cli 도구가 포함된 Redis 패키지가 있습니다. 예를 들어 Ubuntu에서는 다음 명령을 사용하여 Redis 패키지를 설치합니다.
sudo apt-get update
sudo apt-get install redis
Windows
Windows 컴퓨터에서 redis-cli를 사용하는 가장 좋은 방법은 WSL(Windows Subsystem for Linux) 설치하는 것입니다. Linux 하위 시스템을 사용하면 Windows 직접 Linux 도구를 실행할 수 있습니다. WSL을 설치하려면 WSL 설치 지침에 따릅니다.
WSL이 설치되면 WSL에 대해 선택한 Linux Distro에서 사용 가능한 패키지 관리를 사용하여 redis-cli를 설치할 수 있습니다.
캐시 액세스 정보 수집
캐시에 액세스하는 데 필요한 정보는 다음 세 가지 방법으로 수집할 수 있습니다.
- Azure CLI az redisenterprise database list-keys
- Azure PowerShell을 사용하여 Get-AzRedisEnterpriseCacheKey 명령 실행
- Azure 포털 사용
이 섹션에서는 Azure 포털에서 정보를 검색합니다.
Azure Managed Redis 서버를 연결하려면 캐시 클라이언트에 캐시 엔드포인트, 포트 및 캐시에 대한 키가 필요합니다. 일부 클라이언트는 약간 다른 이름으로 이러한 항목을 참조할 수 있습니다. 이 정보는 Azure 포털 가져올 수 있습니다.
캐시에 대한 엔드포인트 및 포트를 얻으려면 리소스 메뉴에서 개요를 선택합니다. 엔드포인트는 형식
{yourcachename}.{region}.redis.azure.net입니다. 포트는 모든 Azure Managed Redis 인스턴스에 대해10000.액세스 키를 얻으려면 설정 메뉴에서 인증을 선택합니다. 그런 다음 , 액세스 키 탭을 선택합니다. 여기에서 캐시에 대한 기본 및 보조 키를 찾을 수 있습니다. 두 키 중 하나를 사용하여 클라이언트 도구에 연결할 수 있습니다.
redis-cli를 사용하여 연결
Redis 패키지가 설치된 컴퓨터에서 셸 또는 터미널을 엽니다. WSL을 사용하는 경우 Windows Terminal 사용하여 Linux 명령줄을 열 수 있습니다. redis-cli로 연결하기 전에 다음을 확인합니다.
- TLS 액세스가 필요한지 여부 - 기본적으로 Azure Managed Redis 인스턴스는 연결에 TLS 암호화를 사용합니다. 서버 쪽에서 TLS를 사용할 때마다
--tls옵션을 사용하여 redis-cli의 TLS를 사용하도록 설정해야 합니다. - 사용된 포트 - 모든 Azure Managed Redis 인스턴스는 포트
10000사용합니다. Redis Community Edition의 기본값과 다르다는 점에 유의하십시오. 기본값은6379입니다. - 캐시 인스턴스에서 OSS 클러스터 정책을 사용하는지 여부 - OSS 클러스터 정책을 사용하는 경우 모든 분할된 데이터베이스에 액세스할 수 있도록 하는 옵션을 추가
-c합니다.
예제
TLS에서 엔터프라이즈 클러스터 정책을 사용하여 Azure Managed Redis 인스턴스에 연결합니다.
redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tlsOSS 클러스터 정책 및 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 인스턴스에 연결되었습니다.
관련 콘텐츠
새 Azure Managed Redis Instance 인스턴스를 만들어 시작합니다.