Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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
- Se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.
È possibile utilizzare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere Introduzione ad Azure Cloud Shell.
Se preferisci eseguire localmente i comandi di riferimento della CLI, installa l'Azure CLI. Se si esegue in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker. Per altre informazioni, vedere Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.
Se usi un'installazione locale, accedi all'interfaccia della riga di comando di Azure usando il comando az login. Per completare il processo di autenticazione, seguire i passaggi visualizzati nel terminale. Per altre opzioni di accesso, vedere Eseguire l'autenticazione ad Azure con l'interfaccia della riga di comando di Azure.
Quando ti viene richiesto, installa l'estensione Azure CLI al primo utilizzo. Per altre informazioni sulle estensioni, vedere Usare e gestire le estensioni con l'interfaccia della riga di comando di Azure.
Esegui az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, avviare az upgrade.
- 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 name
parametri , location
resourceGroup
, 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:
- Portale di Azure (Basic, Standard o Premium)
- Portale di Azure (Enterprise)
- Azure PowerShell
- Modello ARM
- Modello Bicep
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