Freigeben über

Verwalten eines Azure Redis-Caches mithilfe der Azure CLI

  • Gilt für:: ✅ Azure Managed Redis, ✅ Azure Cache for Redis

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

Hinweis

Azure Managed Redis verwendet die Azure CLI az redisenterprise-Befehle . Die redisenterprise Erweiterung für Azure CLI, Version 2.61.0 oder höher, fordert Sie zur Installation auf, wenn Sie einen az redisenterprise Befehl zum ersten Mal ausführen.

Azure Cache for Redis verwendet die az redisenterprise Befehle für Enterprise-Ebenen und die az redis-Befehle für die Stufen "Basic", "Standard" und "Premium". Sie können die folgenden Skripts verwenden, um Azure Managed Redis oder Azure Cache für Redis Enterprise zu erstellen und zu verwalten. Verwenden Sie für Azure Cache für Redis Basic, Standard und Premium den Azure-Cache für Redis-Skripts .

Erstellen eines Azure Managed Redis-Caches

Zum Erstellen eines Azure Managed Redis-Caches mithilfe von Azure CLI, sind die name, , location, resourceGroupund sku Parameter erforderlich. Andere Parameter sind optional und weisen Standardwerte auf.

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

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 aus, die über die entsprechenden Features und Leistung für Ihren Cache verfügt.

Die Microsoft Entra-Authentifizierung ist standardmäßig für alle neuen Caches aktiviert und wird für die Sicherheit empfohlen.

Von Bedeutung

Verwenden Sie Microsoft Entra ID mit verwalteten Identitäten, um nach Möglichkeit Anfragen für Ihren Cache zu autorisieren. Die Autorisierung mithilfe der Microsoft Entra-ID und der verwalteten Identität bietet eine bessere Sicherheit und ist einfacher zu verwenden als die Autorisierung gemeinsam genutzter Zugriffstasten. Weitere Informationen zur Verwendung von verwalteten Identitäten mit Ihrem Cache finden Sie unter Verwenden von Microsoft Entra für die Cacheauthentifizierung mit Azure Managed Redis.

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 legt Variablen fest und verwendet dann die Befehle az group create und az redisenterprise create, um eine Ressourcengruppe mit einem Azure Managed Redis Balanced B1 SKU Cache darin 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="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

Details zu einem Azure Managed Redis-Cache abrufen

Das folgende Skript verwendet die Befehle "az redisenterprise show " und "az redisenterprise database list-keys " zum Abrufen und Anzeigen des Namens, Hostnamens, Ports und Schlüsseldetails für den vorherigen Cache.

Von Bedeutung

Der list-keys Vorgang funktioniert nur, wenn Zugriffstasten für den Cache aktiviert sind. Die Ausgabe dieses Befehls kann die Sicherheit gefährden, indem geheime Schlüssel angezeigt werden und möglicherweise eine Warnung zu vertraulichen Informationen ausgelöst wird. Weitere Informationen finden Sie unter Verwenden der Azure CLI zum Verwalten vertraulicher Informationen.

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

Bereinigen von Ressourcen

Das folgende Skript verwendet die Befehle az group delete und az redisenterprise delete, um den vorherigen Cache zu löschen und anschließend seine Ressourcengruppe zu löschen.

# 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

Von Bedeutung

Verwenden Sie diese Skripts zum Erstellen und Verwalten von Azure Cache für Redis Basic-, Standard- und Premium-Ebenen mit den Azure CLI az redis-Befehlen .

Azure Cache für Redis Enterprise-Tarife und Azure Managed Redis verwenden die az redisenterprise-Befehle. Die redisenterprise Erweiterung für Azure CLI, Version 2.61.0 oder höher, fordert Sie zur Installation auf, wenn Sie einen az redisenterprise Befehl zum ersten Mal ausführen.

Verwenden Sie die Azure Managed Redis-Skripts , um einen Azure-Cache für Redis Enterprise-Ebene zu erstellen und zu verwalten.

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:

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.

Von Bedeutung

Die Microsoft Entra-Authentifizierung wird für die Sicherheit empfohlen. Sie können die Microsoft Entra-Authentifizierung während oder nach der Cacheerstellung aktivieren.

Verwenden Sie Microsoft Entra ID mit verwalteten Identitäten, um nach Möglichkeit Anfragen für Ihren Cache zu autorisieren. Die Autorisierung mithilfe der Microsoft Entra-ID und der verwalteten Identität bietet eine bessere Sicherheit und ist einfacher zu verwenden als die Autorisierung gemeinsam genutzter Zugriffstasten. Weitere Informationen zum Verwenden verwalteter Identitäten mit Ihren Caches finden Sie unter Verwenden von Microsoft Entra ID für die Cacheauthentifizierung.

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.

Von Bedeutung

Der list-keys Vorgang funktioniert nur, wenn Zugriffstasten für den Cache aktiviert sind. Die Ausgabe dieses Befehls kann die Sicherheit gefährden, indem geheime Schlüssel angezeigt werden und möglicherweise eine Warnung zu vertraulichen Informationen ausgelöst wird. Weitere Informationen finden Sie unter Verwenden der Azure CLI zum Verwalten vertraulicher Informationen.


# 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

  • Last updated on