Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Tento článek popisuje, jak vytvořit a odstranit instanci azure Redis Cache pomocí Azure CLI. Tento článek také ukazuje, jak pomocí Azure CLI získat podrobnosti o mezipaměti, včetně stavu zřizování, názvu hostitele, portů a klíčů.
Požadavky
- Pokud nemáte účet Azure, vytvořte si bezplatný účet před tím, než začnete.
Použijte prostředí Bash v Azure Cloud Shellu. Další informace najdete v tématu Začínáme s Azure Cloud Shellem.
Pokud chcete spouštět referenční příkazy CLI lokálně, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Docker. Pro více informací, viz Jak spustit Azure CLI v Docker kontejneru.
Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Chcete-li dokončit proces ověřování, postupujte podle kroků zobrazených ve vašem terminálu. Další možnosti přihlášení najdete v tématu Ověřování v Azure pomocí Azure CLI.
Když budete vyzváni, nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Použití a správa rozšíření pomocí Azure CLI.
Spusťte az version, abyste zjistili verzi a závislé knihovny, které jsou nainstalovány. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.
- Ujistěte se, že jste přihlášení k Azure pomocí předplatného, ve kterém chcete vytvořit mezipaměť. Pokud chcete použít jiné předplatné, než je předplatné, které jste přihlášeni, spusťte příkaz
az account set -s <subscriptionId>a nahraďte<subscriptionId>ho ID předplatného, které chcete použít.
Poznámka:
Azure Managed Redis používá příkazy Azure CLI az redisenterprise . Rozšíření redisenterprise pro Azure CLI verze 2.61.0 nebo vyšší vás při prvním spuštění az redisenterprise příkazu vyzve k instalaci.
Azure Cache for Redis používá az redisenterprise příkazy pro podnikové úrovně a příkazy az redis pro úrovně Basic, Standard a Premium. Následující skripty můžete použít k vytvoření a správě Azure Managed Redis nebo Azure Cache for Redis Enterprise. Pro Azure Cache for Redis Basic, Standard a Premium použijte skripty Azure Cache for Redis .
Vytvoření mezipaměti Azure Managed Redis
K vytvoření mezipaměti Azure Managed Redis pomocí Azure CLI jsou vyžadovány parametry name, location, resourceGroup a sku. Jiné parametry jsou volitelné a mají výchozí hodnoty.
Pomocí skriptu Azure CLI v této části můžete vytvořit mezipaměť Azure Managed Redis s výchozím nastavením. K vytvoření mezipaměti můžete použít také následující jiné metody:
Mezipaměť name musí být řetězec 1–63 znaků, který je jedinečný v oblasti Azure. Název může obsahovat jenom číslice, písmena a pomlčky, musí začínat a končit číslicí nebo písmenem a nesmí obsahovat po sobě jdoucí pomlčky.
Měla location by to být oblast Azure v blízkosti jiných služeb, které používají vaši mezipaměť.
Zvolte sku, které má odpovídající funkce a výkon pro mezipaměť.
Ověřování Microsoft Entra je ve výchozím nastavení povolené pro všechny nové mezipaměti a doporučuje se pro zabezpečení.
Důležité
Pokud je to možné, použijte ID Microsoft Entra se spravovanými identitami k autorizaci požadavků na vaši mezipaměť. Autorizace pomocí ID Microsoft Entra a spravované identity poskytuje lepší zabezpečení a je snazší ji používat než autorizaci sdíleného přístupového klíče. Další informace o používání spravovaných identit s mezipamětí najdete v tématu Použití Microsoft Entra pro ověřování mezipamětí pomocí Azure Managed Redis.
Šifrování TLS (Transport Layer Security) 1.2-1.3 je ve výchozím nastavení povolené pro všechny nové mezipaměti. Během vytváření mezipaměti nebo po vytvoření mezipaměti můžete povolit port a připojení jiného typu než TLS, ale z bezpečnostních důvodů se nedoporučuje zakázání protokolu TLS.
Následující skript nastaví proměnné a pak použije příkazy az group create a az redisenterprise create k vytvoření skupiny prostředků s mezipamětí SKU Azure Managed Redis Balanced B1.
# 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
Získání podrobností o službě Azure Managed Redis Cache
Následující skript používá příkazy az redisenterprise show a az redisenterprise database list-keys k získání a zobrazení názvu, názvu hostitele, portů a podrobností o klíčích pro předchozí mezipaměť.
Důležité
Operace list-keys funguje jenom v případě, že jsou pro mezipaměť povolené přístupové klíče. Výstup tohoto příkazu může ohrozit zabezpečení zobrazením tajných kódů a může aktivovat upozornění na citlivé informace. Další informace najdete v tématu Použití Azure CLI ke správě citlivých informací.
# 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]}
Vyčistěte zdroje
Následující skript pomocí příkazů az group delete a az redisenterprise delete odstraní předchozí mezipaměť a pak odstraní její skupinu prostředků.
# 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
Důležité
Pomocí těchto skriptů můžete vytvářet a spravovat úrovně Azure Cache for Redis Basic, Standard a Premium pomocí příkazů Azure CLI az redis .
Úrovně Azure Cache for Redis Enterprise a Azure Managed Redis používají příkazy az redisenterprise . Rozšíření redisenterprise pro Azure CLI verze 2.61.0 nebo vyšší vás při prvním spuštění az redisenterprise příkazu vyzve k instalaci.
K vytvoření a správě mezipaměti Enterprise-tier pro Azure Cache for Redis použijte skripty Azure Managed Redis.
Vytvořte mezipaměť Azure Cache for Redis
K vytvoření základní, standardní nebo prémiové mezipaměti Azure Cache for Redis můžete použít následující skript Azure CLI. K vytvoření a správě mezipaměti Enterprise-tier pro Azure Cache for Redis použijte skripty Azure Managed Redis.
K vytvoření mezipaměti Azure Cache for Redis Basic, Standard nebo Premium pomocí Azure CLI jsou vyžadovány parametry name, location, resourceGroup, sku a size. Jiné parametry jsou volitelné a mají výchozí hodnoty.
Pomocí skriptu Azure CLI v této části můžete vytvořit mezipaměť Azure Cache for Redis Basic s výchozím nastavením. K vytvoření mezipaměti můžete použít také následující jiné metody:
Mezipaměť name musí být řetězec 1–63 znaků, který je jedinečný v oblasti Azure. Název může obsahovat jenom číslice, písmena a pomlčky, musí začínat a končit číslicí nebo písmenem a nesmí obsahovat po sobě jdoucí pomlčky.
Měla location by to být oblast Azure v blízkosti jiných služeb, které používají vaši mezipaměť.
Zvolte SKU a size položku, které mají odpovídající funkce a výkon pro vaši mezipaměť.
Šifrování TLS (Transport Layer Security) 1.2-1.3 je ve výchozím nastavení povolené pro všechny nové mezipaměti. Během vytváření mezipaměti nebo po vytvoření mezipaměti můžete povolit port a připojení jiného typu než TLS, ale z bezpečnostních důvodů se nedoporučuje zakázání protokolu TLS.
Důležité
Pro zabezpečení se doporučuje ověřování Microsoft Entra. Ověřování Microsoft Entra můžete povolit během vytváření mezipaměti nebo po jejím vytvoření.
Pokud je to možné, použijte ID Microsoft Entra se spravovanými identitami k autorizaci požadavků na vaši mezipaměť. Autorizace pomocí ID Microsoft Entra a spravované identity poskytuje lepší zabezpečení a je snazší ji používat než autorizaci sdíleného přístupového klíče. Další informace o používání spravovaných identit s mezipamětí naleznete v tématu Použití MICROSOFT Entra ID pro ověřování mezipaměti.
Následující skript používá příkazy az group create a az redis create k vytvoření skupiny prostředků s mezipamětí Azure Cache for Redis Basic C0 v ní.
# 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
Získání podrobností o službě Azure Cache for Redis Cache
Následující skript používá příkazy az redis show a az redis list-keys k získání a zobrazení názvu, názvu hostitele, portů a podrobností o klíčích pro předchozí mezipaměť.
Důležité
Operace list-keys funguje jenom v případě, že jsou pro mezipaměť povolené přístupové klíče. Výstup tohoto příkazu může ohrozit zabezpečení zobrazením tajných kódů a může aktivovat upozornění na citlivé informace. Další informace najdete v tématu Použití Azure CLI ke správě citlivých informací.
# 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]}
Vyčistěte zdroje
Následující skript pomocí příkazů az group delete a az redis delete odstraní předchozí mezipaměť a pak odstraní její skupinu prostředků.
# 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