Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier les répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de changer de répertoire.
Cet article explique comment créer et supprimer une instance de cache Redis Azure à l’aide d’Azure CLI. L’article montre également comment utiliser Azure CLI pour obtenir des détails sur le cache, notamment l’état d’approvisionnement, le nom d’hôte, les ports et les clés.
Conditions préalables
- Si vous ne disposez pas d’un compte Azure, créez-en un gratuitement avant de commencer.
Utilisez l’environnement Bash dans Azure Cloud Shell. Pour obtenir plus d’informations, consultez Démarrage d’Azure Cloud Shell.
Si vous préférez exécuter des commandes de référence CLI localement, installez Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Guide pratique pour exécuter Azure CLI dans un conteneur Docker.
Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour terminer le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour obtenir d’autres options de connexion, consultez S’authentifier auprès d’Azure à l’aide d’Azure CLI.
Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser et gérer des extensions avec Azure CLI.
Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.
- Vérifiez que vous êtes connecté à Azure avec l’abonnement sous lequel vous souhaitez créer votre cache. Pour utiliser un abonnement différent de celui que vous êtes connecté, exécutez
az account set -s <subscriptionId>, remplacez<subscriptionId>par l’ID d’abonnement que vous souhaitez utiliser.
Remarque
Azure Managed Redis utilise les commandes Azure CLI az redisenterprise . L’extension redisenterprise pour Azure CLI version 2.61.0 ou ultérieure vous invite à installer la première fois que vous exécutez une az redisenterprise commande.
Azure Cache pour Redis utilise les commandes pour les az redisenterprise niveaux Entreprise et les commandes az redis pour les niveaux Essentiel, Standard et Premium. Vous pouvez utiliser les scripts suivants pour créer et gérer Azure Managed Redis ou Azure Cache pour Redis Enterprise. Pour Azure Cache pour Redis Essentiel, Standard et Premium, utilisez les scripts Azure Cache pour Redis.
Créer un cache Redis managé Azure
Pour créer un cache Redis géré par Azure en utilisant Azure CLI, les paramètres et name, location, resourceGroup et sku sont requis. D’autres paramètres sont facultatifs et ont des valeurs par défaut.
Vous pouvez utiliser le script Azure CLI dans cette section pour créer un cache Redis managé Azure avec les paramètres par défaut. Vous pouvez également utiliser les autres méthodes suivantes pour créer un cache :
Le cache name doit être une chaîne de 1 à 63 caractères unique dans la région Azure. Le nom ne peut contenir que des chiffres, des lettres et des traits d’union, doit commencer et se terminer par un nombre ou une lettre, et ne peut pas contenir de traits d’union consécutifs.
Il location doit s’agir d’une région Azure proche d’autres services qui utilisent votre cache.
Choisissez une référence SKU qui dispose des fonctionnalités et des performances appropriées pour votre cache.
L’authentification Microsoft Entra est activée par défaut pour tous les nouveaux caches et est recommandée pour la sécurité.
Important
Utilisez l’ID Microsoft Entra avec des identités managées pour autoriser les demandes sur votre cache si possible. L’autorisation utilisant l’ID Microsoft Entra et l’identité managée offre une meilleure sécurité et est plus facile à utiliser que l’autorisation de clé d’accès partagé. Pour plus d’informations sur l’utilisation d’identités managées avec votre cache, consultez Utiliser Microsoft Entra pour l’authentification de cache avec Azure Managed Redis.
Le chiffrement TLS (Transport Layer Security) 1.2-1.3 est activé par défaut pour tous les nouveaux caches. Vous pouvez activer le port et les connexions non TLS pendant ou après la création du cache, mais pour des raisons de sécurité, la désactivation de TLS n’est pas recommandée.
Le script suivant définit des variables, puis utilise les commandes az group create et az redisenterprise create pour créer un groupe de ressources avec un cache de référence SKU Azure Redis Balanced B1 dans celui-ci.
# 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
Obtenir des détails pour un cache Redis managé Azure
Le script suivant utilise les commandes az redisenterprise show et az redisenterprise database list-keys pour obtenir et afficher le nom, le nom d’hôte, les ports et les détails des clés pour le cache précédent.
Important
L’opération list-keys fonctionne uniquement lorsque les clés d’accès sont activées pour le cache. La sortie de cette commande peut compromettre la sécurité en affichant des secrets et peut déclencher un avertissement d’informations sensibles. Pour plus d’informations, consultez Utiliser Azure CLI pour gérer les informations sensibles.
# 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]}
Nettoyer les ressources
Le script suivant utilise les commandes az group delete et az redisenterprise delete pour supprimer le cache précédent, puis supprimez son groupe de ressources.
# 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
Important
Utilisez ces scripts pour créer et gérer des niveaux Azure Cache pour Redis Basic, Standard et Premium avec les commandes Azure CLI az redis .
Les niveaux Azure Cache pour Redis Enterprise et Redis géré par Azure utilisent les commandes az redisenterprise. L’extension redisenterprise pour Azure CLI version 2.61.0 ou ultérieure vous invite à installer la première fois que vous exécutez une az redisenterprise commande.
Pour créer et gérer un cache Azure Cache pour Redis de niveau Entreprise, utilisez les scripts Redis géré par Azure.
Créer un cache Azure pour Redis
Vous pouvez utiliser le script Azure CLI suivant pour créer un cache Azure pour Redis Basic, Standard ou Premium. Pour créer et gérer un cache Azure Cache pour Redis de niveau Entreprise, utilisez les scripts Redis géré par Azure.
Pour créer un cache Azure Cache pour Redis Basic, Standard ou Premium à l’aide d’Azure CLI, les paramètres name, location, resourceGroup, sku, et size sont requis. D’autres paramètres sont facultatifs et ont des valeurs par défaut.
Vous pouvez utiliser le script Azure CLI dans cette section pour créer un cache Azure pour Redis Basic avec les paramètres par défaut. Vous pouvez également utiliser les autres méthodes suivantes pour créer un cache :
Le cache name doit être une chaîne de 1 à 63 caractères unique dans la région Azure. Le nom ne peut contenir que des chiffres, des lettres et des traits d’union, doit commencer et se terminer par un nombre ou une lettre, et ne peut pas contenir de traits d’union consécutifs.
Il location doit s’agir d’une région Azure proche d’autres services qui utilisent votre cache.
Choisissez un SKU et size qui possèdent les fonctionnalités et les performances appropriées pour votre cache.
Le chiffrement TLS (Transport Layer Security) 1.2-1.3 est activé par défaut pour tous les nouveaux caches. Vous pouvez activer le port et les connexions non TLS pendant ou après la création du cache, mais pour des raisons de sécurité, la désactivation de TLS n’est pas recommandée.
Important
L’authentification Microsoft Entra est recommandée pour la sécurité. Vous pouvez activer l’authentification Microsoft Entra pendant ou après la création du cache.
Utilisez l’ID Microsoft Entra avec des identités managées pour autoriser les demandes sur votre cache si possible. L’autorisation utilisant l’ID Microsoft Entra et l’identité managée offre une meilleure sécurité et est plus facile à utiliser que l’autorisation de clé d’accès partagé. Pour plus d’informations sur l’utilisation d’identités managées avec votre cache, consultez Utiliser Microsoft Entra ID pour l’authentification du cache.
Le script suivant utilise les commandes az group create et az redis create pour créer un groupe de ressources avec un cache Azure Cache pour 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
Obtenir des informations sur une instance Azure Cache pour Redis
Le script suivant utilise les commandes az redis show et az redis list-keys pour obtenir et afficher le nom, le nom d’hôte, les ports et les détails des clés pour le cache précédent.
Important
L’opération list-keys fonctionne uniquement lorsque les clés d’accès sont activées pour le cache. La sortie de cette commande peut compromettre la sécurité en affichant des secrets et peut déclencher un avertissement d’informations sensibles. Pour plus d’informations, consultez Utiliser Azure CLI pour gérer les informations sensibles.
# 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]}
Nettoyer les ressources
Le script suivant utilise les commandes az group delete et az redis delete pour supprimer le cache précédent, puis supprimer son groupe de ressources.
# 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