Oharra
Baimena behar duzu orria atzitzeko. Direktorioetan saioa has dezakezu edo haiek alda ditzakezu.
Baimena behar duzu orria atzitzeko. Direktorioak alda ditzakezu.
En este artículo se describe cómo crear y eliminar una instancia de Azure Redis Cache mediante la CLI de Azure. En el artículo también se muestra cómo usar la CLI de Azure para obtener detalles de la memoria caché, como el estado de aprovisionamiento, el nombre de host, los puertos y las claves.
Prerrequisitos
- Si no tiene una cuenta de Azure, cree una cuenta gratuita antes de comenzar.
Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Introducción a Azure Cloud Shell.
Si prefieres ejecutar comandos de referencia CLI localmente, instala la CLI de Azure. Si estás utilizando Windows o macOS, considera ejecutar Azure CLI en un contenedor Docker. Para obtener más información, consulte Cómo ejecutar el Azure CLI en un contenedor de Docker.
Si estás utilizando una instalación local, inicia sesión en Azure CLI utilizando el comando az login. Para finalizar el proceso de autenticación, siga los pasos que se muestran en el terminal. Para ver otras opciones de inicio de sesión, consulte Autenticación en Azure mediante la CLI de Azure.
Cuando se le solicite, instale la extensión de la CLI de Azure en el primer uso. Para obtener más información sobre las extensiones, consulte Uso y administración de extensiones con la CLI de Azure.
Ejecute az version para ver la versión y las bibliotecas dependientes que están instaladas. Para actualizar a la versión más reciente, ejecute az upgrade.
- Asegúrese de que ha iniciado sesión en Azure con la suscripción en la que desea crear la memoria caché. Para usar una suscripción diferente a la que ha iniciado sesión, ejecute
az account set -s <subscriptionId>y reemplace por<subscriptionId>el identificador de suscripción que desea usar.
Nota:
Azure Managed Redis usa los comandos az redisenterprise de la CLI de Azure. La redisenterprise extensión de la CLI de Azure versión 2.61.0 o posterior le pide la instalación la primera vez que ejecute un az redisenterprise comando.
Azure Cache for Redis usa los comandos para los az redisenterprise niveles Enterprise y los comandos az redis para los niveles Básico, Estándar y Premium. Puede usar los siguientes scripts para crear y administrar Azure Managed Redis o Azure Cache for Redis Enterprise. Para Azure Cache for Redis Basic, Standard y Premium, use los scripts de Azure Cache for Redis .
Creación de una caché de Azure Managed Redis
Para crear una instancia de Azure Managed Redis Cache mediante la CLI de Azure, se requieren los nameparámetros , location, resourceGroupy sku . Otros parámetros son opcionales y tienen valores predeterminados.
Puede usar el script de la CLI de Azure en esta sección para crear una caché de Redis administrada de Azure con la configuración predeterminada. También puede usar los siguientes métodos para crear una memoria caché:
La memoria caché name debe ser una cadena de 1 a 63 caracteres que sea única en la región de Azure. El nombre solo puede contener números, letras y guiones, debe comenzar y terminar con un número o letra, y no puede contener guiones consecutivos.
location debe ser una región de Azure cerca de otros servicios que usen la memoria caché.
Elija una SKU que tenga las características y el rendimiento adecuados para la memoria caché.
La autenticación de Microsoft Entra está habilitada de forma predeterminada para todas las memorias caché nuevas y se recomienda para la seguridad.
Importante
Use Microsoft Entra ID con identidades administradas para autorizar solicitudes en la memoria caché si es posible. La autorización con el identificador y la identidad administrada de Microsoft Entra proporcionan una mejor seguridad y es más fácil de usar que la autorización de clave de acceso compartido. Para más información sobre el uso de identidades administradas con la memoria caché, consulte Uso de Microsoft Entra para la autenticación de caché con Azure Managed Redis.
El cifrado de seguridad de la capa de transporte (TLS) 1.2-1.3 está habilitado de forma predeterminada para todas las cachés nuevas. Puede habilitar el puerto y las conexiones que no son TLS durante o después de la creación de la caché, pero por motivos de seguridad, no se recomienda deshabilitar TLS.
El script siguiente establece variables y, a continuación, usa los comandos az group create y az redisenterprise create para crear un grupo de recursos con una caché de SKU de Azure Managed Redis Balanced B1 en él.
# 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
Obtén detalles de una memoria caché de Redis administrada en Azure
El siguiente script usa los comandos az redisenterprise show y az redisenterprise database list-keys para obtener y mostrar el nombre, el nombre de host, los puertos y los detalles de claves de la caché anterior.
Importante
La list-keys operación solo funciona cuando las claves de acceso están habilitadas para la memoria caché. La salida de este comando podría poner en peligro la seguridad mostrando secretos y puede desencadenar una advertencia de información confidencial. Para más información, consulte Uso de la CLI de Azure para administrar información confidencial.
# 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]}
Limpieza de recursos
El siguiente script usa los comandos az group delete y az redisenterprise delete para eliminar la caché anterior y, a continuación, eliminar su grupo de recursos.
# 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
Importante
Use estos scripts para crear y administrar los niveles Básico, Estándar y Premium de Azure Cache for Redis con los comandos az redis de la CLI de Azure.
Azure Cache for Redis Enterprise tiers y Azure Managed Redis usan los comandos az redisenterprise . La redisenterprise extensión de la CLI de Azure versión 2.61.0 o posterior le pide la instalación la primera vez que ejecute un az redisenterprise comando.
Para crear y administrar una caché de nivel Enterprise de Azure Cache for Redis, use los scripts de Azure Managed Redis.
Creación de una caché de Azure Cache for Redis
Puede usar el siguiente script de Azure CLI para crear una caché de Azure Cache for Redis en sus niveles Básico, Estándar o Premium. Para crear y administrar una caché de nivel Enterprise de Azure Cache for Redis, use los scripts de Azure Managed Redis.
Para crear una caché de Azure Cache for Redis Basic, Standard o Premium mediante la CLI de Azure, se requieren los parámetros name, location, resourceGroup, sku y size. Otros parámetros son opcionales y tienen valores predeterminados.
Puede usar el script de la CLI de Azure en esta sección para crear una caché básica de Azure Cache for Redis con la configuración predeterminada. También puede usar los siguientes métodos para crear una memoria caché:
La memoria caché name debe ser una cadena de 1 a 63 caracteres que sea única en la región de Azure. El nombre solo puede contener números, letras y guiones, debe comenzar y terminar con un número o letra, y no puede contener guiones consecutivos.
location debe ser una región de Azure cerca de otros servicios que usen la memoria caché.
Elija una SKU y size que tenga las características y el rendimiento adecuados para la memoria caché.
El cifrado de seguridad de la capa de transporte (TLS) 1.2-1.3 está habilitado de forma predeterminada para todas las cachés nuevas. Puede habilitar el puerto y las conexiones que no son TLS durante o después de la creación de la caché, pero por motivos de seguridad, no se recomienda deshabilitar TLS.
Importante
Se recomienda la autenticación de Microsoft Entra para la seguridad. Puede habilitar la autenticación de Microsoft Entra durante o después de la creación de la memoria caché.
Use Microsoft Entra ID con identidades administradas para autorizar solicitudes en la memoria caché si es posible. La autorización con el identificador y la identidad administrada de Microsoft Entra proporcionan una mejor seguridad y es más fácil de usar que la autorización de clave de acceso compartido. Para obtener más información sobre el uso de identidades administradas con la memoria caché, consulte Uso de Microsoft Entra ID para la autenticación de caché.
El script siguiente usa los comandos az group create y az redis create para crear un grupo de recursos con una caché C0 de Azure Cache for Redis Basic en él.
# 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
Obtención de detalles de una caché de Azure Cache for Redis
El siguiente script usa los comandos az redis show y az redis list-keys para obtener y mostrar los detalles del nombre, el nombre de host, los puertos y las claves de la caché anterior.
Importante
La list-keys operación solo funciona cuando las claves de acceso están habilitadas para la memoria caché. La salida de este comando podría poner en peligro la seguridad mostrando secretos y puede desencadenar una advertencia de información confidencial. Para más información, consulte Uso de la CLI de Azure para administrar información confidencial.
# 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]}
Limpieza de recursos
El siguiente script usa los comandos az group delete y az redis delete para eliminar la caché anterior y, a continuación, eliminar su grupo de recursos.
# 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