Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Den här artikeln beskriver hur du skapar och tar bort en Azure Redis-cacheinstans med hjälp av Azure CLI. Artikeln visar också hur du använder Azure CLI för att hämta cacheinformation, inklusive etableringsstatus, värdnamn, portar och nycklar.
Förutsättningar
- Om du inte har något Azure-konto skapar du ett kostnadsfritt konto innan du börjar.
Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Kom igång med Azure Cloud Shell.
Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör på Windows eller macOS, överväg att köra Azure CLI i en Docker-container. För mer information, se Hur man kör Azure CLI i en Docker-container.
Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. För att slutföra autentiseringsprocessen, följ stegen som visas i din terminal. Andra inloggningsalternativ finns i Autentisera till Azure med Azure CLI.
När du blir uppmanad, installera Azure CLI-tillägget vid första användning. Mer information om tillägg finns i Använda och hantera tillägg med Azure CLI.
Kör az version för att ta reda på versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.
- Kontrollera att du är inloggad i Azure med den prenumeration som du vill skapa din cache under. Om du vill använda en annan prenumeration än den du är inloggad med kör
az account set -s <subscriptionId>du och ersätter<subscriptionId>med det prenumerations-ID som du vill använda.
Anmärkning
Azure Managed Redis använder Azure CLI az redisenterprise-kommandon . Tillägget redisenterprise för Azure CLI version 2.61.0 eller senare uppmanar dig att installera det första gången du kör ett az redisenterprise kommando.
Azure Cache for Redis använder az redisenterprise kommandona för Enterprise-nivåer och az redis-kommandona för nivåerna Basic, Standard och Premium. Du kan använda följande skript för att skapa och hantera Azure Managed Redis eller Azure Cache for Redis Enterprise. För Azure Cache for Redis Basic, Standard och Premium använder du Azure Cache for Redis-skripten .
Skapa en Azure Managed Redis-cache
Om du vill skapa en Azure Managed Redis-cache med hjälp av Azure CLI krävs parametrarna name, location, resourceGroupoch sku . Andra parametrar är valfria och har standardvärden.
Du kan använda Azure CLI-skriptet i det här avsnittet för att skapa en Azure Managed Redis-cache med standardinställningar. Du kan också använda följande andra metoder för att skapa en cache:
Cacheminnet name måste vara en sträng med 1–63 tecken som är unik i Azure-regionen. Namnet får endast innehålla siffror, bokstäver och bindestreck, måste börja och sluta med ett tal eller en bokstav och får inte innehålla bindestreck i följd.
location Bör vara en Azure-region nära andra tjänster som använder din cache.
Välj en sku som har lämpliga funktioner och prestanda för din cache.
Microsoft Entra-autentisering är aktiverat som standard för alla nya cacheminnen och rekommenderas för säkerhet.
Viktigt!
Använd Microsoft Entra-ID med hanterade identiteter för att auktorisera begäranden mot din cache om möjligt. Auktorisering med Microsoft Entra-ID och hanterad identitet ger bättre säkerhet och är enklare att använda än auktorisering av delad åtkomstnyckel. Mer information om hur du använder hanterade identiteter med din cache finns i Använda Microsoft Entra för cacheautentisering med Azure Managed Redis.
TLS-kryptering (Transport Layer Security) 1.2-1.3 är aktiverat som standard för alla nya cacheminnen. Du kan aktivera icke-TLS-portar och anslutningar när cacheminnet skapas, men av säkerhetsskäl rekommenderas inte inaktivering av TLS.
Följande skript anger variabler och använder sedan kommandona az group create och az redisenterprise create för att skapa en resursgrupp med en Azure Managed Redis Balanced B1 SKU-cache i den.
# 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
Hämta information om en Azure Managed Redis-cache
Följande skript använder kommandona az redisenterprise show och az redisenterprise database list-keys för att hämta och visa information om namn, värdnamn, portar och nycklar för föregående cache.
Viktigt!
Åtgärden list-keys fungerar bara när åtkomstnycklar är aktiverade för cacheminnet. Utdata från det här kommandot kan äventyra säkerheten genom att visa hemligheter och kan utlösa en varning om känslig information. Mer information finns i Använda Azure CLI för att hantera känslig information.
# 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]}
Rensa resurser
Följande skript använder kommandona az group delete och az redisenterprise delete för att ta bort föregående cache och sedan ta bort resursgruppen.
# 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
Viktigt!
Använd dessa skript för att skapa och hantera Azure Cache for Redis Basic-, Standard- och Premium-nivåer med Azure CLI az redis-kommandona .
Azure Cache för Redis Enterprise-nivåerna och Managed Redis använder kommandona az redisenterprise. Tillägget redisenterprise för Azure CLI version 2.61.0 eller senare uppmanar dig att installera det första gången du kör ett az redisenterprise kommando.
För att skapa och hantera ett cacheminne på Redis Enterprise-nivå i Azure Cache använder du Azure Managed Redis-skripten.
Skapa en Cache för Redis med Azure
Du kan använda följande Azure CLI-skript för att skapa en cache av typen Azure Cache for Redis i nivåerna Basic, Standard eller Premium. För att skapa och hantera ett cacheminne på Redis Enterprise-nivå i Azure Cache använder du Azure Managed Redis-skripten.
Om du vill skapa en Azure Cache for Redis Basic-, Standard- eller Premium-cache med hjälp av Azure CLI krävs parametrarna name, location, resourceGroup, skuoch size . Andra parametrar är valfria och har standardvärden.
Du kan använda Azure CLI-skriptet i det här avsnittet för att skapa en Azure Cache for Redis Basic-cache med standardinställningar. Du kan också använda följande andra metoder för att skapa en cache:
Cacheminnet name måste vara en sträng med 1–63 tecken som är unik i Azure-regionen. Namnet får endast innehålla siffror, bokstäver och bindestreck, måste börja och sluta med ett tal eller en bokstav och får inte innehålla bindestreck i följd.
location Bör vara en Azure-region nära andra tjänster som använder din cache.
Välj en sku och size som har lämpliga funktioner och prestanda för din cache.
TLS-kryptering (Transport Layer Security) 1.2-1.3 är aktiverat som standard för alla nya cacheminnen. Du kan aktivera icke-TLS-portar och anslutningar när cacheminnet skapas, men av säkerhetsskäl rekommenderas inte inaktivering av TLS.
Viktigt!
Microsoft Entra-autentisering rekommenderas för säkerhet. Du kan aktivera Microsoft Entra-autentisering under eller efter att cacheminnet har skapats.
Använd Microsoft Entra-ID med hanterade identiteter för att auktorisera begäranden mot din cache om möjligt. Auktorisering med Microsoft Entra-ID och hanterad identitet ger bättre säkerhet och är enklare att använda än auktorisering av delad åtkomstnyckel. Mer information om hur du använder hanterade identiteter med din cache finns i Använda Microsoft Entra-ID för cacheautentisering.
Följande skript använder kommandona az group create och az redis create för att skapa en resursgrupp med en Azure Cache for Redis Basic C0-cache i den.
# 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
Hämta information för en Azure Cache for Redis-cache
Följande skript använder kommandona az redis show och az redis list-keys för att hämta och visa information om namn, värdnamn, portar och nycklar för föregående cacheminne.
Viktigt!
Åtgärden list-keys fungerar bara när åtkomstnycklar är aktiverade för cacheminnet. Utdata från det här kommandot kan äventyra säkerheten genom att visa hemligheter och kan utlösa en varning om känslig information. Mer information finns i Använda Azure CLI för att hantera känslig information.
# 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]}
Rensa resurser
Följande skript använder kommandona az group delete och az redis delete för att ta bort föregående cache och sedan ta bort dess resursgrupp.
# 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