Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. 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 não tiver uma conta do Azure, crie uma conta gratuita antes de começar.
Utilize o ambiente Bash no Azure Cloud Shell. Para mais informações, veja Get started with Azure Cloud Shell.
Se preferir executar comandos de referência da CLI localmente, instale o CLI do Azure. Se estiver a usar Windows ou macOS, considere executar o Azure CLI num contentor Docker. Para obter mais informações, consulte 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 os passos exibidos no seu terminal. Para outras opções de entrada, consulte Autenticar no Azure usando a CLI do Azure.
Quando solicitado, instale a extensão do Azure CLI na primeira utilização. Para obter mais informações sobre extensões, consulte Usar e gerenciar extensões com a CLI do Azure.
Execute az version para descobrir a versão e as bibliotecas dependentes que estão instaladas. Para atualizar para a versão mais recente, execute az upgrade.
- Certifique-se de que está ligado ao Azure com a subscrição onde pretende criar a sua cache. Para utilizar uma subscrição diferente daquela com que iniciou sessão, execute
az account set -s <subscriptionId>, substituindo<subscriptionId>pelo ID de subscrição que pretende utilizar.
Observação
O Azure Managed Redis usa os comandos Azure CLI az redisenterprise . A redisenterprise extensão para a 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 Azure Managed Redis ou o Cache do Azure para Redis Enterprise. Para o Azure Cache para Redis Basic, Standard e Premium, use os scripts do Azure Cache para Redis.
Criar um cache Redis gerenciado do Azure
Para criar um cache Redis gerido 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 valores predefinidos por defeito.
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 hífenes, deve começar e terminar com um número ou letra e não pode conter hífenes consecutivos.
O location deve ser uma região do Azure perto de outros serviços que usam seu cache.
Escolha uma sku que tenha os recursos e o desempenho apropriados para seu cache.
A autenticação do Microsoft Entra é habilitada por padrão para todos os novos caches e é recomendada para segurança.
Importante
Use o Microsoft Entra ID com identidades gerenciadas para autorizar solicitações em seu cache, se possível. A autorização usando o 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 compartilhada. 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 Azure Managed Redis.
A criptografia Transport Layer Security (TLS) 1.2-1.3 está habilitada por padrão para todos os novos caches. Você pode habilitar a porta não-TLS e as conexões durante ou após a criação do cache, mas, por motivos de segurança, a desativação do TLS não é recomendada.
O script a seguir define variáveis e, em seguida, usa os comandos az group create e az redisenterprise create para criar um grupo de recursos com um cache de SKU B1 Balanceado Redis Gerenciado do Azure 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 os detalhes de nome, nome do host, portas e chaves para o 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]}
Limpeza de 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 o Cache do Azure para as camadas Redis Basic, Standard e Premium com os comandos az redis da CLI do Azure.
As camadas do Azure Cache para Redis Enterprise e o Azure Managed Redis usam os comandos az redisenterprise. A redisenterprise extensão para a 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 gerir um cache Azure Cache for Redis da camada empresarial, use os scripts Azure Managed Redis.
Criar um Cache do Azure para cache Redis
Você pode usar o seguinte script da CLI do Azure para criar um Azure Cache para Redis nas camadas Básica, Standard ou Premium. Para criar e gerir um cache Azure Cache for Redis da camada empresarial, use os scripts Azure Managed Redis.
Para criar um Azure Cache para Redis Basic, 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 valores predefinidos por defeito.
Você pode usar o script da CLI do Azure nesta seção para criar um Cache do Azure para cache Redis 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 hífenes, deve começar e terminar com um número ou letra e não pode conter hífenes consecutivos.
O location deve ser uma região do Azure perto de outros serviços que usam seu cache.
Escolha uma sku e size que tenha os recursos e o desempenho apropriados para seu cache.
A criptografia Transport Layer Security (TLS) 1.2-1.3 está habilitada por padrão para todos os novos caches. Você pode habilitar a porta não-TLS e as conexões durante ou após a criação do cache, mas, por motivos de segurança, a desativação do TLS não é recomendada.
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.
Use o Microsoft Entra ID com identidades gerenciadas para autorizar solicitações em seu cache, se possível. A autorização usando o 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 compartilhada. 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 básico do Azure para Redis.
# 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 Azure para cache 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 para o 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]}
Limpeza de 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