Compartilhar via

Gerenciar um cache redis do Azure usando a CLI do Azure

  • Aplica-se a: ✅ Azure Managed Redis, ✅ Azure Cache for Redis

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.
  • 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

Conteúdo relacionado

  • Last updated on