이 문서에서는 Azure CLI를 사용하여 Azure Redis Cache 인스턴스를 만들고 삭제하는 방법을 설명합니다. 또한 이 문서에서는 Azure CLI를 사용하여 프로비전 상태, 호스트 이름, 포트 및 키를 비롯한 캐시 세부 정보를 가져오는 방법을 보여 줍니다.
필수 조건
- Azure 계정이 없는 경우 시작하기 전에 체험 계정을 만듭니다.
Bash 환경을 Azure Cloud Shell에서 사용합니다. 자세한 내용은 Azure Cloud Shell 시작을 참조하세요.
CLI 참조 명령을 로컬에서 실행하려면 Azure CLI를 설치하십시오. Windows 또는 macOS에서 실행하는 경우 Docker 컨테이너에서 Azure CLI를 실행하는 것이 좋습니다. 자세한 내용은 Docker 컨테이너에서 Azure CLI를 실행하는 방법을 참조하세요.
로컬 설치를 사용하는 경우 az login 명령을 사용하여 Azure CLI에 로그인합니다. 인증 프로세스를 완료하려면 터미널에 표시되는 단계를 수행합니다. 다른 로그인 옵션은 Azure CLI를 사용하여 Azure에 인증을 참조하세요.
메시지가 표시되면 처음 사용할 때 Azure CLI 확장을 설치합니다. 확장에 대한 자세한 내용은 Azure CLI로 확장 사용 및 관리를 참조하세요.
az version을 실행하여 설치된 버전과 관련 종속 라이브러리를 확인합니다. 최신 버전으로 업그레이드하려면 az upgrade를 실행합니다.
- 캐시를 만들려는 구독을 사용하여 Azure에 로그인했는지 확인합니다. 다른 구독을 사용하려면, 사용하려는 구독 ID로
az account set -s <subscriptionId>를 바꿔<subscriptionId>를 실행합니다.
비고
Azure Managed Redis는 Azure CLI az redisenterprise 명령을 사용합니다. Azure CLI 버전 2.61.0 이상의 redisenterprise 확장은 az redisenterprise 명령을 처음 실행할 때 설치를 요청합니다.
Azure Cache for Redis는 엔터프라이즈 계층에 대한 명령과 기본, 표준 및 프리미엄 계층에 대한 az redisenterprise 명령을 사용합니다. 다음 스크립트를 사용하여 Azure Managed Redis 또는 Azure Cache for Redis Enterprise를 만들고 관리할 수 있습니다. Azure Cache for Redis Basic, Standard 및 Premium의 경우 Azure Cache for Redis 스크립트를 사용합니다.
Azure Managed Redis 캐시 만들기
Azure CLIname를 사용하여 Azure Managed Redis 캐시를 만들려면 , location및 resourceGroupsku 매개 변수가 필요합니다. 다른 매개 변수는 선택 사항이며 기본값이 있습니다.
이 섹션의 Azure CLI 스크립트를 사용하여 기본 설정으로 Azure Managed Redis 캐시를 만들 수 있습니다. 다음 다른 방법을 사용하여 캐시를 만들 수도 있습니다.
캐시 name 는 Azure 지역에서 고유한 1~63자의 문자열이어야 합니다. 이름은 숫자, 문자 및 하이픈만 포함할 수 있으며 숫자 또는 문자로 시작하고 끝나야 하며 연속 하이픈을 포함할 수 없습니다.
location 캐시를 사용하는 다른 서비스 근처의 Azure 지역이어야 합니다.
캐시에 적절한 기능과 성능이 있는 sku 를 선택합니다.
Microsoft Entra 인증은 기본적으로 모든 새 캐시에 사용하도록 설정되며 보안을 위해 권장됩니다.
중요합니다
가능한 경우 관리 ID와 함께 Microsoft Entra ID를 사용하여 캐시에 대한 요청에 권한을 부여합니다. Microsoft Entra ID 및 관리 ID를 사용한 권한 부여는 더 나은 보안을 제공하며 공유 액세스 키 권한 부여보다 사용하기 쉽습니다. 캐시에서 관리 ID를 사용하는 방법에 대한 자세한 내용은 Azure Managed Redis를 사용한 캐시 인증에 Microsoft Entra 사용을 참조하세요.
TLS(전송 계층 보안) 1.2-1.3 암호화는 기본적으로 모든 새 캐시에 대해 사용하도록 설정됩니다. 캐시를 만드는 동안 또는 이후에 TLS가 아닌 포트 및 연결을 사용하도록 설정할 수 있지만 보안상의 이유로 TLS를 사용하지 않도록 설정하는 것은 권장되지 않습니다.
다음 스크립트는 변수를 설정한 다음 az group create 및 az redisenterprise create 명령을 사용하여 Azure Managed Redis Balanced B1 SKU 캐시를 사용하여 리소스 그룹을 만듭니다.
# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
resourceGroup="redis-cache-rg-$randomIdentifier"
tag="create-manage-cache"
cache="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
Azure Managed Redis 캐시에 대한 세부 정보 가져오기
다음 스크립트는 az redisenterprise show 및 az redisenterprise database list-keys 명령을 사용하여 이전 캐시의 이름, 호스트 이름, 포트 및 키 세부 정보를 가져와서 표시합니다.
중요합니다
이 list-keys 작업은 캐시에 액세스 키를 사용하도록 설정한 경우에만 작동합니다. 이 명령의 출력은 비밀을 표시하여 보안을 손상시킬 수 있으며 중요한 정보 경고를 트리거할 수 있습니다. 자세한 내용은 Azure CLI를 사용하여 중요한 정보를 관리하세요.
# Get details of an Azure Managed Redis cache
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 database list-keys --cluster-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]}
자원을 정리하세요
다음 스크립트는 az group delete 및 az redisenterprise delete 명령을 사용하여 이전 캐시를 삭제한 다음 해당 리소스 그룹을 삭제합니다.
# 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
중요합니다
이러한 스크립트를 사용하여 Azure CLI az redis 명령을 사용하여 Azure Cache for Redis Basic, Standard 및 Premium 계층을 만들고 관리합니다.
Azure Cache for Redis Enterprise 계층 및 Azure Managed Redis는 az redisenterprise 명령을 사용합니다. Azure CLI 버전 2.61.0 이상의 redisenterprise 확장은 az redisenterprise 명령을 처음 실행할 때 설치를 요청합니다.
Azure Cache for Redis Enterprise 계층 캐시를 만들고 관리하려면 Azure Managed Redis 스크립트를 사용합니다.
Azure Redis 캐시 만들기
다음 Azure CLI 스크립트를 사용하여 Azure Cache for Redis Basic, Standard 또는 프리미엄 계층 캐시를 만들 수 있습니다. Azure Cache for Redis Enterprise 계층 캐시를 만들고 관리하려면 Azure Managed Redis 스크립트를 사용합니다.
Azure Cache for Redis Basic, Standard 또는 Premium 캐시를 만들기 위해 Azure CLI를 사용할 때 name, location, resourceGroup, sku, size 매개 변수가 필요합니다. 다른 매개 변수는 선택 사항이며 기본값이 있습니다.
이 섹션의 Azure CLI 스크립트를 사용하여 기본 설정으로 Azure Cache for Redis Basic 캐시를 만들 수 있습니다. 다음 다른 방법을 사용하여 캐시를 만들 수도 있습니다.
캐시 name 는 Azure 지역에서 고유한 1~63자의 문자열이어야 합니다. 이름은 숫자, 문자 및 하이픈만 포함할 수 있으며 숫자 또는 문자로 시작하고 끝나야 하며 연속 하이픈을 포함할 수 없습니다.
location 캐시를 사용하는 다른 서비스 근처의 Azure 지역이어야 합니다.
캐시에 적절한 기능과 성능이 있는 size를 선택합니다.
TLS(전송 계층 보안) 1.2-1.3 암호화는 기본적으로 모든 새 캐시에 대해 사용하도록 설정됩니다. 캐시를 만드는 동안 또는 이후에 TLS가 아닌 포트 및 연결을 사용하도록 설정할 수 있지만 보안상의 이유로 TLS를 사용하지 않도록 설정하는 것은 권장되지 않습니다.
중요합니다
보안을 위해 Microsoft Entra 인증을 사용하는 것이 좋습니다. 캐시를 만드는 동안 또는 이후에 Microsoft Entra 인증을 사용하도록 설정할 수 있습니다.
가능한 경우 관리 ID와 함께 Microsoft Entra ID를 사용하여 캐시에 대한 요청에 권한을 부여합니다. Microsoft Entra ID 및 관리 ID를 사용한 권한 부여는 더 나은 보안을 제공하며 공유 액세스 키 권한 부여보다 사용하기 쉽습니다. 캐시에서 관리 ID를 사용하는 방법에 대한 자세한 내용은 Microsoft Entra ID를 사용한 캐시 인증에 대해 설명합니다.
다음 스크립트는 az group create 및 az redis create 명령을 사용하여 Azure Cache for Redis Basic C0 캐시를 사용하여 리소스 그룹을 만듭니다.
# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
resourceGroup="redis-cache-rg-$randomIdentifier"
tag="create-manage-cache"
cache="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) Azure Redis cache
echo "Creating $cache"
az redis create --name $cache --resource-group $resourceGroup --location "$location" --sku $sku --vm-size $size
Azure Cache for Redis 캐시의 세부 정보를 확인하세요.
다음 스크립트는 az redis show 및 az redis list-keys 명령을 사용하여 이전 캐시의 이름, 호스트 이름, 포트 및 키 세부 정보를 가져와서 표시합니다.
중요합니다
이 list-keys 작업은 캐시에 액세스 키를 사용하도록 설정한 경우에만 작동합니다. 이 명령의 출력은 비밀을 표시하여 보안을 손상시킬 수 있으며 중요한 정보 경고를 트리거할 수 있습니다. 자세한 내용은 Azure CLI를 사용하여 중요한 정보를 관리하세요.
# Get details of an Azure Cache for Redis cache
echo "Showing details of $cache"
az redis show --name "$cache" --resource-group $resourceGroup
# Retrieve the hostname and ports for an Azure Redis instance
redis=($(az redis show --name "$cache" --resource-group $resourceGroup --query [hostName,enableNonSslPort,port,sslPort] --output tsv))
# Retrieve the keys for an Azure Redis 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]}
자원을 정리하세요
다음 스크립트는 az group delete 및 az redis delete 명령을 사용하여 이전 캐시를 삭제한 다음 해당 리소스 그룹을 삭제합니다.
# Delete an Azure 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