Condividi tramite


Gestire una cache Redis di Azure usando l'interfaccia della riga di comando di Azure

Questo articolo descrive come creare ed eliminare un'istanza della cache Redis di Azure usando l'interfaccia della riga di comando di Azure. L'articolo illustra anche come usare l'interfaccia della riga di comando di Azure per ottenere informazioni dettagliate sulla cache, tra cui lo stato del provisioning, il nome host, le porte e le chiavi.

Prerequisiti

  • Assicurati di aver eseguito l'accesso ad Azure con l'abbonamento nella quale vuoi creare la cache. Per usare una sottoscrizione diversa da quella con cui si è connessi, eseguire az account set -s <subscriptionId>, sostituendo <subscriptionId> con l'ID sottoscrizione che si vuole usare.

Annotazioni

Azure Managed Redis usa i comandi az redisenterprise dell'interfaccia della riga di comando di Azure. L'estensione redisenterprise per l'interfaccia della riga di comando di Azure versione 2.61.0 o successiva ti invita a installarla la prima volta che si esegue un comando az redisenterprise.

Cache Redis di Azure usa i az redisenterprise comandi per i livelli Enterprise e i comandi az redis per i livelli Basic, Standard e Premium. È possibile usare gli script seguenti per creare e gestire Redis gestito di Azure o Cache Redis di Azure per Redis Enterprise. Per Azure Cache for Redis Basic, Standard e Premium, usare gli script Azure Cache for Redis.

Creare una cache Redis gestita di Azure

Per creare una cache Redis gestita di Azure usando l'interfaccia della riga di comando di Azure, sono necessari i nameparametri , locationresourceGroup, e sku . Altri parametri sono facoltativi e hanno valori predefiniti.

È possibile usare lo script dell'interfaccia della riga di comando di Azure in questa sezione per creare una cache Redis gestita di Azure con le impostazioni predefinite. È anche possibile usare gli altri metodi seguenti per creare una cache:

La cache name deve essere una stringa di 1-63 caratteri univoca nell'area di Azure. Il nome può contenere solo numeri, lettere e trattini, deve iniziare e terminare con un numero o una lettera e non può contenere trattini consecutivi.

location Deve essere un'area di Azure vicino ad altri servizi che usano la cache.

Scegliere uno SKU con le funzionalità e le prestazioni appropriate per la cache.

L'autenticazione di Microsoft Entra è abilitata per impostazione predefinita per tutte le nuove cache ed è consigliata per la sicurezza.

Importante

Usare Microsoft Entra ID con identità gestite per autorizzare le richieste nella cache, se possibile. L'autorizzazione con l'ID e l'identità gestita di Microsoft Entra garantisce una maggiore sicurezza ed è più facile da usare rispetto all'autorizzazione della chiave di accesso condiviso. Per altre informazioni sull'uso di identità gestite con la cache, vedere Usare Microsoft Entra per l'autenticazione della cache con Redis gestito di Azure.

La crittografia Transport Layer Security (TLS) 1.2-1.3 è abilitata per impostazione predefinita per tutte le nuove cache. È possibile abilitare la porta e le connessioni non TLS durante o dopo la creazione della cache, ma per motivi di sicurezza la disabilitazione di TLS non è consigliata.

Lo script seguente imposta le variabili e quindi usa i comandi az group create e az redisenterprise create per creare un gruppo di risorse con una cache sku B1 bilanciata di Azure gestita da Redis.


# 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

Ottenere i dettagli per una cache Redis gestita di Azure

Lo script seguente usa i comandi az redisenterprise show e az redisenterprise database list-keys per ottenere e visualizzare il nome, il nome host, le porte e i dettagli delle chiavi per la cache precedente.

Importante

L'operazione list-keys funziona solo quando le chiavi di accesso sono abilitate per la cache. L'output di questo comando potrebbe compromettere la sicurezza visualizzando i segreti e potrebbe generare un avviso di informazioni riservate. Per altre informazioni, vedere Usare l'interfaccia della riga di comando di Azure per gestire le informazioni riservate.

# 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]}

Pulire le risorse

Lo script seguente usa i comandi az group delete e az redisenterprise delete per eliminare la cache precedente e quindi eliminare il relativo gruppo di risorse.

# 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

Usare questi script per creare e gestire i livelli Basic, Standard e Premium di Cache Redis di Azure con i comandi az redis dell'Azure CLI.

Azure Cache for Redis Enterprise tiers e Azure Managed Redis usano i comandi az redisenterprise . L'estensione per l'interfaccia redisenterprise della riga di comando di Azure versione 2.61.0 o successiva richiede l'installazione la prima volta che si esegue un az redisenterprise comando.

Per creare e gestire una cache di Azure Cache per Redis di livello Enterprise, usare gli script Azure Managed Redis.

Creare una cache di Azure per Redis

È possibile usare il seguente script del CLI di Azure per creare una cache di Azure Cache per Redis di livello Basic, Standard o Premium. Per creare e gestire una cache di livello Enterprise di Azure Cache for Redis, usare gli script Azure Managed Redis.

Per creare una cache di Azure per Redis Basic, Standard o Premium usando l'interfaccia della riga di comando di Azure, sono necessari i parametri name, location, resourceGroup, sku e size. Altri parametri sono facoltativi e hanno valori predefiniti.

È possibile utilizzare lo script CLI di Azure in questa sezione per creare un Azure Cache per Redis di tipo Basic con le impostazioni predefinite. È anche possibile usare gli altri metodi seguenti per creare una cache:

La cache name deve essere una stringa di 1-63 caratteri univoca nell'area di Azure. Il nome può contenere solo numeri, lettere e trattini, deve iniziare e terminare con un numero o una lettera e non può contenere trattini consecutivi.

location Deve essere un'area di Azure vicino ad altri servizi che usano la cache.

Scegliere uno SKU con size le funzionalità e le prestazioni appropriate per la cache.

La crittografia Transport Layer Security (TLS) 1.2-1.3 è abilitata per impostazione predefinita per tutte le nuove cache. È possibile abilitare la porta e le connessioni non TLS durante o dopo la creazione della cache, ma per motivi di sicurezza la disabilitazione di TLS non è consigliata.

Importante

L'autenticazione di Microsoft Entra è consigliata per la sicurezza. È possibile abilitare l'autenticazione di Microsoft Entra durante o dopo la creazione della cache.

Usare Microsoft Entra ID con identità gestite per autorizzare le richieste nella cache, se possibile. L'autorizzazione con l'ID e l'identità gestita di Microsoft Entra garantisce una maggiore sicurezza ed è più facile da usare rispetto all'autorizzazione della chiave di accesso condiviso. Per altre informazioni sull'uso di identità gestite con la cache, vedere Usare l'ID Microsoft Entra per l'autenticazione della cache.

Lo script seguente usa i comandi az group create e az redis create per creare un gruppo di risorse con una cache Azure Cache per 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

Ottenere i dettagli per una cache Redis di Azure

Lo script seguente usa i comandi az redis show e az redis list-keys per ottenere e visualizzare il nome, il nome host, le porte e i dettagli delle chiavi per la cache precedente.

Importante

L'operazione list-keys funziona solo quando le chiavi di accesso sono abilitate per la cache. L'output di questo comando potrebbe compromettere la sicurezza visualizzando i segreti e potrebbe generare un avviso di informazioni riservate. Per altre informazioni, vedere Usare l'interfaccia della riga di comando di Azure per gestire le informazioni riservate.


# 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]}

Pulire le risorse

Lo script seguente usa i comandi az group delete e az redis delete per eliminare la cache precedente e quindi eliminare il relativo gruppo di risorse.

# 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