Verwalten eines Azure Redis-Caches mithilfe der Azure CLI

In diesem Artikel wird beschrieben, wie Sie eine Azure Redis-Cacheinstanz mithilfe der Azure CLI erstellen und löschen. Der Artikel zeigt auch, wie Sie die Azure CLI verwenden, um Cachedetails wie Bereitstellungsstatus, Hostname, Ports und Schlüssel abzurufen.

Voraussetzungen

• Wenn Sie nicht über ein Azure-Konto verfügen, erstellen Sie ein kostenloses Konto , bevor Sie beginnen.

• Verwenden Sie die Bash-Umgebung in Azure Cloud Shell. Weitere Informationen finden Sie unter "Erste Schritte mit Azure Cloud Shell".

  

• Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI. Wenn Sie Windows oder macOS ausführen, sollten Sie die Azure CLI in einem Docker-Container ausführen. Weitere Informationen finden Sie unter Ausführen der Azure CLI in einem Docker-Container.

  • Wenn Sie eine lokale Installation verwenden, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an. Führen Sie die in Ihrem Terminal angezeigten Schritte aus, um den Authentifizierungsprozess abzuschließen. Weitere Anmeldeoptionen finden Sie unter Authentifizieren bei Azure mithilfe der Azure CLI.

  • Installieren Sie die Azure CLI-Erweiterung beim ersten Einsatz, wenn Sie dazu aufgefordert werden. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden und Verwalten von Erweiterungen mit der Azure CLI.

  • Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um das Upgrade auf die aktuelle Version durchzuführen.

• Stellen Sie sicher, dass Sie mit dem Abonnement, unter dem Sie Ihren Cache erstellen möchten, bei Azure angemeldet sind. Um ein anderes Abonnement als das derzeit verwendete zu nutzen, führen Sie az account set -s <subscriptionId> aus und ersetzen Sie <subscriptionId> durch die gewünschte Abonnement-ID.

Erstellen eines Azure-Caches für Redis-Cache

Sie können das folgende Azure CLI-Skript verwenden, um einen Azure-Cache für Redis Basic, Standard oder Premium-Ebenen-Cache zu erstellen. Verwenden Sie die Azure Managed Redis-Skripts , um einen Azure-Cache für Redis Enterprise-Ebene zu erstellen und zu verwalten.

Um einen Azure-Cache für Redis Basic, Standard oder Premium-Cache mithilfe von Azure CLI zu erstellen, sind die name, , location, resourceGroup, skuund size Parameter erforderlich. Andere Parameter sind optional und weisen Standardwerte auf.

Sie können das Azure CLI-Skript in diesem Abschnitt verwenden, um einen Azure Cache für Redis Basic-Cache mit Standardeinstellungen zu erstellen. Sie können auch die folgenden anderen Methoden verwenden, um einen Cache zu erstellen:

• Azure-Portal (Basic, Standard oder Premium)
• Azure PowerShell
• ARM-Vorlage
• Bicep-Vorlage

Der Cache name muss eine Zeichenfolge von 1 bis 63 Zeichen sein, die in der Azure-Region eindeutig sind. Der Name darf nur Zahlen, Buchstaben und Bindestriche enthalten, muss mit einer Zahl oder einem Buchstaben beginnen und enden und darf keine aufeinander folgenden Bindestriche enthalten.

Dies location sollte eine Azure-Region in der Nähe anderer Dienste sein, die Ihren Cache verwenden.

Wählen Sie eine SKU und size aus, die über die entsprechenden Features und eine geeignete Leistung für Ihren Cache verfügen.

Transport Layer Security (TLS) 1.2-1.3-Verschlüsselung ist für alle neuen Caches standardmäßig aktiviert. Sie können den Nicht-TLS-Port und die Verbindungen während oder nach der Cacheerstellung aktivieren, aus Sicherheitsgründen wird das Deaktivieren von TLS jedoch nicht empfohlen.

Das folgende Skript verwendet die Befehle az group create und az redis create, um eine Ressourcengruppe mit einem Azure Cache für Redis Basic C0 Cache zu erstellen.

# 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

Abrufen von Details zu einem Azure Cache for Redis-Cache

Das folgende Skript verwendet die Befehle "az redis show " und " az redis list-keys ", um den Namen, den Hostnamen, die Ports und die Schlüsseldetails für den vorherigen Cache abzurufen und anzuzeigen.

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

Bereinigen von Ressourcen

Das folgende Skript verwendet die Befehle " az group delete " und "az redis delete " zum Löschen des vorherigen Caches und anschließendes Löschen der Ressourcengruppe.

# 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

Verwandte Inhalte

• Azure CLI-Dokumentation
• Erstellen eines Azure Cache for Redis vom Typ „Premium“ mit Clustering