将 Redis 命令行工具与 Azure Redis 缓存配合使用

可将常用的 redis-cli.exe 命令行工具用作客户端与 Azure Cache for Redis 进行交互。 下载用于 Windows 的 Redis 命令行工具 后,即可在 Windows 平台上使用此工具。

如需在其他平台上运行该命令行工具,请从 https://redis.io/download 下载开源 Redis。

收集缓存访问信息

注意

本文使用 Azure Az PowerShell 模块,这是与 Azure 交互时推荐使用的 PowerShell 模块。 若要开始使用 Az PowerShell 模块,请参阅安装 Azure PowerShell。 若要了解如何迁移到 Az PowerShell 模块,请参阅 将 Azure PowerShell 从 AzureRM 迁移到 Az

可通过三种方式收集访问缓存所需的信息:

  1. 在 Azure CLI 中使用 az redis list-keys
  2. 在 Azure PowerShell 中使用 Get-AzRedisCacheKey
  3. 使用 Azure 门户

本部分介绍如何从 Azure 门户检索密钥。

从 Azure 门户检索主机名、端口和访问密钥

若要连接到某个 Azure Cache for Redis 实例,缓存客户端需要该缓存的主机名、端口和密钥。 在某些客户端中,这些项的名称可能略有不同。 可以从 Azure 门户检索主机名、端口和访问密钥。

  • 若要获取访问密钥,请在缓存的左侧导航中选择“访问密钥”。

    Azure Cache for Redis keys

  • 若要获取主机名和端口,请在缓存的左侧导航栏中选择“属性”。 主机名的格式为 <DNS 名称>.redis.cache.chinacloudapi.cn

    Azure Cache for Redis properties

为 redis-cli.exe 启用访问权限

使用 Azure Cache for Redis 时,默认情况下仅启用 TLS 端口 (6380)。 redis-cli.exe 命令行工具不支持 TLS。 可通过两种配置方式使用该命令行工具:

  1. 启用非 TLS 端口 (6379) - 不建议采用此配置,因为在此配置中,系统通过 TCP 以明文形式发送访问密钥 。 这种更改可能会影响对缓存的访问。 仅当访问测试缓存时才考虑选择此配置。

  2. 下载并安装 stunnel

    运行 stunnel GUI Start 以启动服务器 。

    右键单击 stunnel 服务器的任务栏图标,然后选择“显示日志窗口”。

    在 stunnel 的“日志窗口”菜单上,选择“配置”>“编辑配置”,以打开当前配置文件。

    在“服务定义”部分下为 redis-cli.exe 添加以下项。 将 yourcachename 替换为实际缓存名称。

    [redis-cli]
    client = yes
    accept = 127.0.0.1:6380
    connect = yourcachename.redis.cache.chinacloudapi.cn:6380
    

    保存并关闭配置文件。

    在 stunnel 的“日志窗口”菜单中,选择“配置”>“重新加载配置” 。

使用 Redis 命令行工具进行连接。

使用 stunnel 时,运行 redis-cli.exe,并仅传递端口和访问密钥(主要或次要)以连接到缓存 。

redis-cli.exe -p 6380 -a YourAccessKey

Screenshot that shows that your connection to the cache is successful.

如果将测试缓存与不安全的非 TLS 端口一起使用,请运行 redis-cli.exe 并传递主机名、端口和访问密钥(主要或次要),以连接到测试缓存 。

redis-cli.exe -h yourcachename.redis.cache.chinacloudapi.cn -p 6379 -a YourAccessKey

stunnel with redis-cli

后续步骤

了解使用 Redis 控制台发出命令的详细信息。