Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este artigo descreve como criar e excluir uma instância de cache redis do Azure usando a CLI do Azure. O artigo também mostra como usar a CLI do Azure para obter detalhes de cache, incluindo status de provisionamento, nome do host, portas e chaves.
Pré-requisitos
- Se você ainda não tiver uma conta do Azure, crie uma conta gratuita antes de começar.
Utilize o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Introdução ao Azure Cloud Shell.
Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Se você estiver executando no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para obter mais informações, confira Como executar a CLI do Azure em um contêiner do Docker.
Se você estiver usando uma instalação local, entre na CLI do Azure usando o comando az login . Para concluir o processo de autenticação, siga as etapas exibidas em seu terminal. Para obter outras opções de entrada, consulte Autenticar no Azure usando a CLI do Azure.
Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar e gerenciar extensões com a CLI do Azure.
Execute o comando az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para atualizar para a versão mais recente, execute az upgrade.
- Verifique se você está conectado ao Azure com a assinatura na qual deseja criar seu cache. Para usar uma assinatura diferente daquela com a qual você está conectado, execute
az account set -s <subscriptionId>, substituindo<subscriptionId>pela ID da assinatura que você deseja usar.
Observação
O Redis Gerenciado do Azure usa os comandos az redisenterprise da CLI do Azure. A redisenterprise extensão da CLI do Azure versão 2.61.0 ou superior solicita a instalação na primeira vez que você executa um az redisenterprise comando.
O Cache do Azure para Redis usa os az redisenterprise comandos para as camadas Enterprise e os comandos az redis para as camadas Basic, Standard e Premium. Você pode usar os scripts a seguir para criar e gerenciar o Redis Gerenciado do Azure ou o Cache do Azure para Redis Enterprise. Para o Azure Cache para Redis Básico, Padrão e Premium, use os scripts do Azure Cache para Redis.
Criar um cache Gerenciado Redis do Azure
Para criar um cache Redis Gerenciado do Azure usando a CLI do Azure, os parâmetros name, location, resourceGroup e sku são necessários. Outros parâmetros são opcionais e têm padrões.
Você pode usar o script da CLI do Azure nesta seção para criar um cache Redis Gerenciado do Azure com configurações padrão. Você também pode usar os seguintes outros métodos para criar um cache:
O cache name deve ser uma cadeia de caracteres de 1 a 63 caracteres exclusiva na região do Azure. O nome pode conter apenas números, letras e hifens, deve iniciar e terminar com um número ou letra e não pode conter hifens consecutivos.
A location deve ser uma região do Azure próxima a outros serviços que usam seu cache.
Escolha um sku que tenha os recursos e o desempenho apropriados para o cache.
A autenticação do Microsoft Entra é habilitada por padrão para todos os novos caches e é recomendada para segurança.
Importante
Se possível, utilize o ID do Microsoft Entra com identidades gerenciadas para autorizar solicitações contra seu cache. A autorização usando a ID do Microsoft Entra e a identidade gerenciada fornece melhor segurança e é mais fácil de usar do que a autorização de chave de acesso compartilhado. Para obter mais informações sobre como usar identidades gerenciadas com seu cache, consulte Usar o Microsoft Entra para autenticação de cache com o Redis Gerenciado do Azure.
A criptografia TLS (Transport Layer Security) 1.2-1.3 está habilitada por padrão para todos os novos caches. Você pode habilitar a porta e as conexões não TLS durante ou após a criação do cache, mas, por motivos de segurança, não é recomendável desabilitar o TLS.
O script a seguir define variáveis e usa os comandos az group create e az redisenterprise create para criar um grupo de recursos com um cache de SKU do Azure Managed Redis Balanced B1 nele.
# 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
Obter detalhes para um cache Redis Gerenciado do Azure
O script a seguir usa os comandos az redisenterprise show e az redisenterprise database list-keys para obter e exibir o nome, o nome do host, as portas e os detalhes das chaves do cache anterior.
Importante
A list-keys operação funciona somente quando as chaves de acesso estão habilitadas para o cache. A saída desse comando pode comprometer a segurança mostrando segredos e pode disparar um aviso de informações confidenciais. Para obter mais informações, consulte Usar a CLI do Azure para gerenciar informações confidenciais.
# 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]}
Limpar os recursos
O script a seguir usa os comandos az group delete e az redisenterprise delete para excluir o cache anterior e, em seguida, excluir seu grupo de recursos.
# 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
Importante
Use esses scripts para criar e gerenciar as camadas Basic, Standard e Premium do Azure Cache para Redis com os comandos da CLI az redis do Azure.
As camadas do Cache do Azure para Redis Enterprise e os Redis Gerenciados do Azure usam os comandos az redisenterprise. A redisenterprise extensão da CLI do Azure versão 2.61.0 ou superior solicita a instalação na primeira vez que você executa um az redisenterprise comando.
Para criar e gerenciar um cache da camada Enterprise do Cache do Azure para Redis, use os scripts do Redis Gerenciado do Azure.
Criar um cache do Cache do Azure para Redis
Você pode usar o seguinte script da CLI do Azure para criar um cache do Cache do Azure para Redis de nível Básico, Standard ou Premium. Para criar e gerenciar um cache da camada Enterprise do Cache do Azure para Redis, use os scripts do Redis Gerenciado do Azure.
Para criar um Cache do Azure para Redis Básico, Standard ou Premium usando a CLI do Azure, os parâmetros name, location, resourceGroup, sku e size são necessários. Outros parâmetros são opcionais e têm padrões.
Você pode utilizar o script da CLI do Azure nesta seção para criar um Cache do Azure para Redis no nível Basic com configurações padrão. Você também pode usar os seguintes outros métodos para criar um cache:
O cache name deve ser uma cadeia de caracteres de 1 a 63 caracteres exclusiva na região do Azure. O nome pode conter apenas números, letras e hifens, deve iniciar e terminar com um número ou letra e não pode conter hifens consecutivos.
A location deve ser uma região do Azure próxima a outros serviços que usam seu cache.
Escolha um sku e size que tenha os recursos e o desempenho apropriados para o cache.
A criptografia TLS (Transport Layer Security) 1.2-1.3 está habilitada por padrão para todos os novos caches. Você pode habilitar a porta e as conexões não TLS durante ou após a criação do cache, mas, por motivos de segurança, não é recomendável desabilitar o TLS.
Importante
A autenticação do Microsoft Entra é recomendada para segurança. Você pode habilitar a Autenticação do Microsoft Entra durante ou após a criação do cache.
Se possível, utilize o ID do Microsoft Entra com identidades gerenciadas para autorizar solicitações contra seu cache. A autorização usando a ID do Microsoft Entra e a identidade gerenciada fornece melhor segurança e é mais fácil de usar do que a autorização de chave de acesso compartilhado. Para obter mais informações sobre como usar identidades gerenciadas com seu cache, consulte Usar a ID do Microsoft Entra para autenticação de cache.
O script a seguir usa os comandos az group create e az redis create para criar um grupo de recursos com um cache C0 do Cache do Azure para Redis Básico nele.
# 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
Obter detalhes de um cache do Cache do Azure para Redis
O script a seguir usa os comandos az redis show e az redis list-keys para obter e exibir os detalhes de nome, nome do host, portas e chaves do cache anterior.
Importante
A list-keys operação funciona somente quando as chaves de acesso estão habilitadas para o cache. A saída desse comando pode comprometer a segurança mostrando segredos e pode disparar um aviso de informações confidenciais. Para obter mais informações, consulte Usar a CLI do Azure para gerenciar informações confidenciais.
# 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]}
Limpar os recursos
O script a seguir usa os comandos az group delete e az redis delete para excluir o cache anterior e, em seguida, excluir seu grupo de recursos.
# 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