다음을 통해 공유


Azure CLI를 사용하여 Azure Redis 만들기

이 시나리오에서는 Azure Redis 인스턴스를 만드는 방법을 알아봅니다. 그런 다음, 캐시에 대한 프로비전 상태, 호스트 이름, 포트 및 키를 포함하여 캐시의 세부 정보를 가져오는 방법을 알아봅니다. 마지막으로, 캐시를 삭제하는 방법을 알아봅니다.

Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.

필수 조건

샘플 스크립트

Azure Managed Redis

  1. Azure Managed Redis(미리 보기) 인스턴스를 만들려면 Azure Portal에 로그인하고 리소스 만들기를 선택합니다.

  2. 페이지의 검색 상자에 Azure Cache for Redis를 입력합니다.

  3. 새 Redis Cache 페이지에서 새 캐시의 설정을 구성합니다.

    설정 값 선택 설명
    구독 드롭다운하여 구독을 선택합니다. 이 새 Azure Managed Redis 인스턴스를 만들 구독입니다.
    리소스 그룹 드롭다운하여 리소스 그룹을 선택하거나, 새로 만들기를 선택하고 새 리소스 그룹 이름을 입력합니다. 캐시 및 기타 리소스를 만들 새 리소스 그룹의 이름입니다. 모든 앱 리소스를 하나의 리소스 그룹에 배치하면 앱 리소스를 쉽게 관리하거나 삭제할 수 있습니다.
    DNS 이름 지역에서 고유한 이름을 입력합니다. 캐시 이름은 숫자, 문자 또는 하이픈만 포함하는 캐시의 지역 이름이 결합된 경우 1~63자의 문자열이어야 합니다. (캐시 이름이 45자 미만인 경우 현재 사용 가능한 모든 지역에서 작동해야 합니다.) 이름은 숫자 또는 문자로 시작하고 끝나야 하며 연속 하이픈을 포함할 수 없습니다. 캐시 인스턴스의 호스트 이름\<DNS name\>.\<Azure region\>.redis.azure.net입니다.
    위치 드롭다운하여 위치를 선택합니다. Azure Managed Redis는 선택한 Azure 지역에서 사용할 수 있습니다.
    캐시 유형 드롭다운하고 성능 계층 및 캐시 크기를 선택합니다. 계층은 Redis 인스턴스의 성능을 결정하는 반면 캐시 크기는 데이터를 저장하는 데 사용할 수 있는 메모리를 결정합니다. 올바른 성능 계층을 선택하는 방법에 대한 지침은 올바른 계층 선택을 참조 하세요.

    Azure Managed Redis 기본 사항 탭을 보여 주는 스크린샷

  4. 다음: 네트워킹을 선택하고 퍼블릭 또는 프라이빗 엔드포인트를 선택합니다.

  5. 다음: 고급을 선택합니다.

    인스턴스에 추가할 Redis 모듈을 구성합니다.

    기본적으로 새 관리 캐시의 경우:

    • Microsoft Entra ID를 사용할 수 있습니다.
    • 보안상의 이유로 액세스 키 인증 을 사용할 수 없습니다.

    Important

    최적의 보안을 위해 관리 ID와 함께 Microsoft Entra ID를 사용하여 가능한 경우 캐시에 대한 요청에 권한을 부여하는 것이 좋습니다. Microsoft Entra ID 및 관리 ID를 사용한 인증은 공유 액세스 키 인증에 비해 뛰어난 보안과 사용 편의성을 제공합니다. 캐시에서 관리 ID를 사용하는 방법에 대한 자세한 내용은 캐시 인증을 위한 Microsoft Entra ID 사용을 참조하세요.

    비클러스터형 캐시에 대한 클러스터링 정책엔터프라이즈로 설정하거나 클러스터형 캐시에 대한 정책을 OSS로 설정합니다. 클러스터링 정책 선택에 대한 자세한 내용은 클러스터 정책을 참조하세요.

    Azure Managed Redis 고급 탭을 보여 주는 스크린샷.

    활성 지역 복제를 사용하는 경우 만드는 동안 구성해야 합니다. 자세한 내용은 Azure Managed Redis 인스턴스에 대한 활성 지역 복제 구성을 참조 하세요.

    Important

    Azure Managed Redis(미리 보기) 인스턴스를 만든 후에는 클러스터링 정책을 변경할 수 없습니다. RediSearch를 사용 중인 경우 Enterprise 클러스터 정책이 필요하며 NoEviction이 유일한 제거 정책으로써 지원됩니다.

    Important

    지역에서 복제 그룹에서 이 캐시 인스턴스를 사용하는 경우 인스턴스를 만든 후에는 제거 정책을 변경할 수 없습니다. 캐시를 만들기 전에 주 노드의 제거 정책을 알고 있어야 합니다. 활성 지역 복제에 대한 자세한 내용은 활성 지역 복제 필수 구성 요소를 참조하세요.

    Important

    캐시 인스턴스를 만든 후에는 모듈을 변경할 수 없습니다. Azure Cache for Redis 인스턴스를 만들 때 모듈을 사용하도록 설정해야 합니다. 캐시를 만든 후에는 모듈 구성을 사용하도록 설정할 수 있는 옵션이 없습니다.

  6. 다음: 태그를 선택하고 건너뜁니다.

  7. 완료되면 다음: 리뷰 + 만들기를 클릭합니다.

  8. 설정을 검토하고 생성를 선택합니다.

    Redis 인스턴스를 만드는 데 몇 분 정도 걸립니다. Azure Managed Redis 개요 페이지에서 진행률을 모니터링할 수 있습니다. 상태실행 중으로 표시되면 캐시를 사용할 준비가 된 것입니다.

Azure Cache for Redis

  1. 캐시를 만들려면 Azure Portal에 로그인합니다. 포털 메뉴에서 리소스 만들기를 선택합니다.

    Azure Portal의 왼쪽 탐색 창에 강조 표시된 리소스 만들기 옵션을 보여 주는 스크린샷.

  2. 시작 창의 검색 창에서 Aure Cache for Redis를 입력합니다. 검색 결과에서 Azure Cache for Redis를 찾은 다음, 만들기를 선택합니다.

    검색 상자에 Azure Cache for Redis가 있는 Azure Marketplace를 보여 주고 만들기 단추가 강조 표시되어 있는 스크린샷입니다.

  3. 새 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 개요를 참조하세요.
  4. 네트워킹 탭을 선택하거나 다음: 네트워킹을 선택합니다.

  5. 네트워킹 탭에서 캐시에 사용할 연결 방법을 선택합니다.

  6. 고급 탭을 선택하거나 다음: 고급을 선택합니다.

  7. 고급 창에서 다음 정보에 따라 인증 방법을 확인하거나 선택합니다.

    고급 창과 선택할 수 있는 옵션을 보여 주는 스크린샷.

    • 기본적으로 새 기본, 표준 또는 프리미엄 캐시의 경우 Microsoft Entra 인증이 활성화되고 액세스 키 인증이 비활성화됩니다.
    • 기본 또는 표준 캐시의 경우 비 TLS 포트 선택 영역을 선택/해제할 수 있습니다.
    • 표준 및 프리미엄 캐시의 경우 가용성 영역을 사용하도록 선택할 수 있습니다. 캐시를 만든 후에는 가용성 영역을 비활성화할 수 없습니다.
    • 프리미엄 캐시의 경우 비 TLS 포트, 클러스터링, 관리 ID 및 데이터 지속성에 대한 설정을 구성합니다.

    Important

    최적의 보안을 위해 관리 ID와 함께 Microsoft Entra ID를 사용하여 가능한 경우 캐시에 대한 요청에 권한을 부여하는 것이 좋습니다. Microsoft Entra ID 및 관리 ID를 사용한 인증은 공유 액세스 키 인증에 비해 뛰어난 보안과 사용 편의성을 제공합니다. 캐시에서 관리 ID를 사용하는 방법에 대한 자세한 내용은 캐시 인증을 위한 Microsoft Entra ID 사용을 참조하세요.

  8. (선택 사항) 태그 탭을 선택하거나 다음: 태그를 선택합니다.

  9. (선택 사항) 태그 탭에서 캐시 리소스를 분류하려는 경우 태그 이름과 값을 입력합니다.

  10. 검토 + 만들기 단추를 선택합니다.

    검토 + 만들기 탭에서 Azure는 자동으로 구성의 유효성을 검사합니다.

  11. 녹색 유효성 검사 통과 메시지가 표시되면 만들기를 선택합니다.

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

Azure Cloud Shell 시작

Azure Cloud Shell은 이 문서의 단계를 실행하는 데 무료로 사용할 수 있는 대화형 셸입니다. 공용 Azure 도구가 사전 설치되어 계정에서 사용하도록 구성되어 있습니다.

Cloud Shell을 열려면 코드 블록의 오른쪽 위 모서리에 있는 사용해 보세요를 선택하기만 하면 됩니다. 또한 https://shell.azure.com 로 이동하여 별도의 브라우저 탭에서 Cloud Shell을 시작할 수 있습니다.

Cloud Shell이 열리면 환경에 대해 Bash가 선택되어 있는지 확인합니다. 후속 세션은 Bash 환경에서 Azure CLI를 사용합니다. 복사를 선택하여 코드 블록을 복사하고 Cloud Shell에 붙여넣고 Enter 키를 눌러 실행합니다.

Azure에 로그인

Cloud Shell은 로그인한 초기 계정에서 자동으로 인증됩니다. 다음 스크립트를 사용하여 다른 구독을 사용하여 로그인하고 subscriptionId를 Azure 구독 ID로 바꿉니다.

Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.

subscription="subscriptionId" # Set Azure subscription ID here

az account set -s $subscription # ...or use 'az login'

자세한 내용은 활성 구독 설정 또는 대화형으로 로그인을 참조하세요.

스크립트 실행


# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
resourceGroup="msdocs-redis-cache-rg-$randomIdentifier"
tag="create-manage-cache"
cache="msdocs-redis-cache-$randomIdentifier"
sku="Balanced_B1"

# Create a resource group
echo "Creating $resourceGroup in "$location"..."
az group create --resource-group $resourceGroup --location "$location" --tags $tag

# Create a Balanced B1 Azure Managed Redis Cache
echo "Creating $cache"
az redisenterprise create --name $cache --resource-group $resourceGroup --location "$location" --sku $sku

# Get details of an Azure Managed Redis
echo "Showing details of $cache"
az redisenterprise show --name "$cache" --resource-group $resourceGroup 

# Retrieve the hostname and ports for an Azure Redis Cache instance
redis=($(az redisenterprise show --name "$cache" --resource-group $resourceGroup --query [hostName,enableNonSslPort,port,sslPort] --output tsv))

# Retrieve the keys for an Azure Redis Cache instance
keys=($(az redisenterprise list-keys --name "$cache" --resource-group $resourceGroup --query [primaryKey,secondaryKey] --output tsv))

# Display the retrieved hostname, keys, and ports
echo "Hostname:" ${redis[0]}
echo "Non SSL Port:" ${redis[2]}
echo "Non SSL Port Enabled:" ${redis[1]}
echo "SSL Port:" ${redis[3]}
echo "Primary Key:" ${keys[0]}
echo "Secondary Key:" ${keys[1]}

# Delete a redis cache
echo "Deleting $cache"
az redisenterprise delete --name "$cache" --resource-group $resourceGroup -y

# echo "Deleting all resources"
az group delete --resource-group $resourceGroup -y

리소스 정리

다음 명령을 사용하여 이러한 리소스가 계속해서 필요한 경우가 아니면 az group delete 명령을 사용하여 리소스 그룹 및 연결된 모든 리소스를 제거합니다. 이러한 리소스 중 일부는 만들고 삭제하는 데 시간이 걸릴 수 있습니다.

az group delete --resource-group $resourceGroup

샘플 참조

이 스크립트는 다음 명령을 사용하여 리소스 그룹 및 Azure Managed Redis를 만듭니다. 테이블에 있는 각 명령은 명령에 해당하는 문서에 연결됩니다.

명령 주의
az group create 모든 리소스가 저장되는 리소스 그룹을 만듭니다.
az redisenterprise create Azure Managed Redis 인스턴스를 만듭니다.
az redisenterprise show Azure Managed Redis 인스턴스의 세부 정보를 검색합니다.
az redisenterprise list-keys Azure Managed Redis 인스턴스에 대한 액세스 키를 검색합니다.
az redisenterprise delete Azure Managed Redis 인스턴스를 삭제합니다.

Azure Cloud Shell 시작

Azure Cloud Shell은 이 문서의 단계를 실행하는 데 무료로 사용할 수 있는 대화형 셸입니다. 공용 Azure 도구가 사전 설치되어 계정에서 사용하도록 구성되어 있습니다.

Cloud Shell을 열려면 코드 블록의 오른쪽 위 모서리에 있는 사용해 보세요를 선택하기만 하면 됩니다. 또한 https://shell.azure.com 로 이동하여 별도의 브라우저 탭에서 Cloud Shell을 시작할 수 있습니다.

Cloud Shell이 열리면 환경에 대해 Bash가 선택되어 있는지 확인합니다. 후속 세션은 Bash 환경에서 Azure CLI를 사용합니다. 복사를 선택하여 코드 블록을 복사하고 Cloud Shell에 붙여넣고 Enter 키를 눌러 실행합니다.

Azure에 로그인

Cloud Shell은 로그인한 초기 계정에서 자동으로 인증됩니다. 다음 스크립트를 사용하여 다른 구독을 사용하여 로그인하고 subscriptionId를 Azure 구독 ID로 바꿉니다.

Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.

subscription="subscriptionId" # Set Azure subscription ID here

az account set -s $subscription # ...or use 'az login'

자세한 내용은 활성 구독 설정 또는 대화형으로 로그인을 참조하세요.

스크립트 실행


# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
resourceGroup="msdocs-redis-cache-rg-$randomIdentifier"
tag="create-manage-cache"
cache="msdocs-redis-cache-$randomIdentifier"
sku="basic"
size="C0"

# Create a resource group
echo "Creating $resourceGroup in "$location"..."
az group create --resource-group $resourceGroup --location "$location" --tags $tag

# Create a Basic C0 (256 MB) Redis Cache
echo "Creating $cache"
az redis create --name $cache --resource-group $resourceGroup --location "$location" --sku $sku --vm-size $size

# Get details of an Azure Cache for Redis
echo "Showing details of $cache"
az redis show --name "$cache" --resource-group $resourceGroup

# Retrieve the hostname and ports for an Azure Redis Cache instance
redis=($(az redis show --name "$cache" --resource-group $resourceGroup --query [hostName,enableNonSslPort,port,sslPort] --output tsv))

# Retrieve the keys for an Azure Redis Cache instance
keys=($(az redis list-keys --name "$cache" --resource-group $resourceGroup --query [primaryKey,secondaryKey] --output tsv))

# Display the retrieved hostname, keys, and ports
echo "Hostname:" ${redis[0]}
echo "Non SSL Port:" ${redis[2]}
echo "Non SSL Port Enabled:" ${redis[1]}
echo "SSL Port:" ${redis[3]}
echo "Primary Key:" ${keys[0]}
echo "Secondary Key:" ${keys[1]}

# Delete a redis cache
echo "Deleting $cache"
az redis delete --name "$cache" --resource-group $resourceGroup -y

# echo "Deleting all resources"
az group delete --resource-group $resourceGroup -y

리소스 정리

다음 명령을 사용하여 이러한 리소스가 계속해서 필요한 경우가 아니면 az group delete 명령을 사용하여 리소스 그룹 및 연결된 모든 리소스를 제거합니다. 이러한 리소스 중 일부는 만들고 삭제하는 데 시간이 걸릴 수 있습니다.

az group delete --resource-group $resourceGroup

샘플 참조

이 스크립트는 다음 명령을 사용하여 리소스 그룹 및 Azure Cache for Redis를 만듭니다. 테이블에 있는 각 명령은 명령에 해당하는 문서에 연결됩니다.

명령 주의
az group create 모든 리소스가 저장되는 리소스 그룹을 만듭니다.
az redis create Azure Managed Redis 인스턴스를 만듭니다.
az redis show Azure Managed Redis 인스턴스의 세부 정보를 검색합니다.
az redis list-keys Azure Managed Redis 인스턴스에 대한 액세스 키를 검색합니다.
az redis delete Azure Managed Redis 인스턴스를 삭제합니다.

다음 단계

Azure CLI에 대한 자세한 내용은 Azure CLI 설명서를 참조하세요.

클러스터링을 사용하여 Azure Managed Redis를 만드는 Azure Managed Redis CLI 스크립트 샘플은 클러스터링이 있는 Azure Managed Redis를 참조하세요.