Создание кэша Azure для Redis и управление им с помощью классического Azure CLI

Статья
06/01/2023

Классический Azure CLI позволяет управлять инфраструктурой Azure с любой платформы. В этой статье описано, как создавать экземпляры Кэша Azure для Redis и управлять ими с помощью классической версии Azure CLI.

Важно!

Для выполнения действий в этой статье необходим классический Azure CLI. Это более старая версия Azure CLI, предназначенная только для классической модели развертывания Azure.

Чтобы установить классическую версию CLI, см. статью Установка классического интерфейса командной строки Azure (Azure Classic CLI), а для установки текущей версии Azure CLI для развертываний Azure Resource Manager см. статью Установка Azure CLI.

Примечание

Последние примеры сценариев Azure CLI для кэша Azure для Redis см. в этой статье.

Предварительные требования

Для создания экземпляров кэша Azure для Redis и управления ими с помощью классического Azure CLI необходимо выполнить следующие действия.

Необходимо иметь учетную запись Azure. Если ее нет, можно создать бесплатную учетную запись всего за пару минут.
Установите классический Azure CLI.
Подключите установленный экземпляр Azure CLI к личной либо рабочей или учебной учетной записи Azure, а затем выполните вход из классической версии Azure CLI с помощью команды azure login.
Перед выполнением любой из указанных ниже команд переключите классический Azure CLI в режим диспетчера ресурсов, выполнив команду azure config mode arm. Дополнительные сведения см. в разделе Управление ресурсами и группами ресурсов Azure с помощью классического Azure CLI.

Свойства кэша Azure для Redis

При создании и обновлении экземпляров кэша Azure для Redis используются следующие свойства.

Свойство	Параметр	Описание
name	-n, --name	Имя кэша Azure для Redis.
resource group	-g, --resource-group	Имя группы ресурсов.
location	-l, --location	Расположение для создания кэша.
размер;	-z, --size	Размер кэша Azure для Redis. Допустимые значения: [C0, C1, C2, C3, C4, C5, C6, P1, P2, P3, P4]
sku	-x, --sku	Номер SKU Redis. Требуется одно из этих значений: ["Базовый", "Стандартный", "Премиум"]
EnableNonSslPort	-e, --enable-non-ssl-port	Свойство EnableNonSslPort кэша Azure для Redis. Добавьте этот флаг, если вы хотите включить порт без TLS / SSL для вашего кэша
Конфигурация Redis	-c, --redis-configuration	Конфигурация Redis. Введите строку ключей и значений конфигурации в формате JSON. Формат:"{"":"","":""}"
Конфигурация Redis	-f, --redis-configuration-file	Конфигурация Redis. Введите путь к файлу, содержащему ключи и значения. Формат записи в файле: {"":"","":""}
Число сегментов	-r, --shard-count	Число сегментов, которые будут созданы при создании кэша уровня "Премиум" с включенной кластеризацией.
Виртуальная сеть	-v, --virtual-network	При размещении кэша в виртуальной сети определяет точный идентификатор ресурса Resource Manager виртуальной сети, в которой будет развернут Кэш Azure для Redis. Пример формата: /subscriptions/{идентификатор_подписки}/resourceGroups/{имя_группы_ресурсов}/Microsoft.ClassicNetwork/VirtualNetworks/vnet1
key type	-t, --key-type	Тип обновляемого ключа. Допустимые значения: [Primary, Secondary].
StaticIP	-p, --static-ip <static-ip>	При размещении кэша в виртуальной сети определяет уникальный IP-адрес подсети для кэша. Если IP-адрес не указан, он автоматически выбирается из подсети.
Подсеть	t, --subnet <subnet>	При размещении кэша в виртуальной сети определяет имя подсети, в которой будет развернут кэш.
Виртуальная сеть	-v, --virtual-network <virtual-network>	При размещении кэша в виртуальной сети определяет точный идентификатор ресурса Resource Manager виртуальной сети, в которой будет развернут Кэш Azure для Redis. Пример формата: /subscriptions/{идентификатор_подписки}/resourceGroups/{имя_группы_ресурсов}/Microsoft.ClassicNetwork/VirtualNetworks/vnet1
Подписка	-s, --subscription	Идентификатор подписки.

Просмотр всех команд кэша Azure для Redis

Для просмотра всех команд кэша Azure для Redis и их параметров используйте команду azure rediscache -h.

C:\>azure rediscache -h
help:    Commands to manage your Azure Cache for Redis(s)
help:
help:    Create an Azure Cache for Redis
help:      rediscache create [--name <name> --resource-group <resource-group> --location <location> [options]]
help:
help:    Delete an existing Azure Cache for Redis
help:      rediscache delete [--name <name> --resource-group <resource-group> ]
help:
help:    List all Azure Cache for Redis within your Subscription or Resource Group
help:      rediscache list [options]
help:
help:    Show properties of an existing Azure Cache for Redis
help:      rediscache show [--name <name> --resource-group <resource-group>]
help:
help:    Change settings of an existing Azure Cache for Redis
help:      rediscache set [--name <name> --resource-group <resource-group> --redis-configuration <redis-configuration>/--redis-configuration-file <redisConfigurationFile>]
help:
help:    Renew the authentication key for an existing Azure Cache for Redis
help:      rediscache renew-key [--name <name> --resource-group <resource-group> ]
help:
help:    Lists Primary and Secondary key of an existing Azure Cache for Redis
help:      rediscache list-keys [--name <name> --resource-group <resource-group>]
help:
help:    Options:
help:      -h, --help  output usage information
help:
help:    Current Mode: arm (Azure Resource Management)

Создание экземпляра кэша Azure для Redis

Чтобы создать кэш Azure для Redis, используйте следующую команду:

    azure rediscache create [--name <name> --resource-group <resource-group> --location <location> [options]]

Чтобы получить дополнительные сведения об этой команде, выполните команду azure rediscache create -h.

C:\>azure rediscache create -h
help:    Create an Azure Cache for Redis
help:
help:    Usage: rediscache create [--name <name> --resource-group <resource-group> --location <location> [options]]
help:
help:    Options:
help:      -h, --help                                               output usage information
help:      -v, --verbose                                            use verbose output
help:      -vv                                                      more verbose with debug output
help:      --json                                                   use json output
help:      -n, --name <name>                                        Name of the Azure Cache for Redis.
help:      -g, --resource-group <resource-group>                    Name of the Resource Group
help:      -l, --location <location>                                Location to create cache.
help:      -z, --size <size>                                        Size of the Azure Cache for Redis. Valid values: [C0, C1, C2, C3, C4, C5, C6, P1, P2, P3, P4]
help:      -x, --sku <sku>                                          Redis SKU. Should be one of : [Basic, Standard, Premium]
help:      -e, --enable-non-ssl-port                                EnableNonSslPort property of the Azure Cache for Redis. Add this flag if you want to enable the non-TLS/SSL Port for your cache
help:      -c, --redis-configuration <redis-configuration>          Redis Configuration. Enter a JSON formatted string of configuration keys and values here. Format:"{"<key1>":"<value1>","<key2>":"<value2>"}"
help:      -f, --redis-configuration-file <redisConfigurationFile>  Redis Configuration. Enter the path of a file containing configuration keys and values here. Format for the file entry: {"<key1>":"<value1>","<key2>":"<value2>"}
help:      -r, --shard-count <shard-count>                          Number of Shards to create on a Premium Cluster Cache
help:      -v, --virtual-network <virtual-network>                  The exact ARM resource ID of the virtual network to deploy the Azure Cache for Redis in. Example format: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/Microsoft.ClassicNetwork/VirtualNetworks/vnet1
help:      -t, --subnet <subnet>                                    Required when deploying an Azure Cache for Redis inside an existing Azure Virtual Network
help:      -p, --static-ip <static-ip>                              Required when deploying an Azure Cache for Redis inside an existing Azure Virtual Network
help:      -s, --subscription <id>                                  the subscription identifier
help:
help:    Current Mode: arm (Azure Resource Management)

Удаление имеющегося кэша Azure для Redis

Чтобы удалить кэш Azure для Redis, используйте следующую команду:

    azure rediscache delete [--name <name> --resource-group <resource-group> ]

Чтобы получить дополнительные сведения об этой команде, выполните команду azure rediscache delete -h.

C:\>azure rediscache delete -h
help:    Delete an existing Azure Cache for Redis
help:
help:    Usage: rediscache delete [--name <name> --resource-group <resource-group> ]
help:
help:    Options:
help:      -h, --help                             output usage information
help:      -v, --verbose                          use verbose output
help:      -vv                                    more verbose with debug output
help:      --json                                 use json output
help:      -n, --name <name>                      Name of the Azure Cache for Redis.
help:      -g, --resource-group <resource-group>  Name of the Resource Group under which the cache exists
help:      -s, --subscription <subscription>      the subscription identifier
help:
help:    Current Mode: arm (Azure Resource Management)

Вывод списка всех кэшей Azure для Redis в подписке или группе ресурсов

Чтобы вывести список всех кэшей Azure для Redis в подписке или группе ресурсов, выполните следующую команду.

    azure rediscache list [options]

Чтобы получить дополнительные сведения об этой команде, выполните команду azure rediscache list -h.

C:\>azure rediscache list -h
help:    List all Azure Cache for Redis within your Subscription or Resource Group
help:
help:    Usage: rediscache list [options]
help:
help:    Options:
help:      -h, --help                             output usage information
help:      -v, --verbose                          use verbose output
help:      -vv                                    more verbose with debug output
help:      --json                                 use json output
help:      -g, --resource-group <resource-group>  Name of the Resource Group
help:      -s, --subscription <subscription>      the subscription identifier
help:
help:    Current Mode: arm (Azure Resource Management)

Отображение свойств имеющегося кэша Azure для Redis

Чтобы отобразить свойства имеющегося кэша Azure для Redis, используйте следующую команду:

    azure rediscache show [--name <name> --resource-group <resource-group>]

Чтобы получить дополнительные сведения об этой команде, выполните команду azure rediscache show -h.

C:\>azure rediscache show -h
help:    Show properties of an existing Azure Cache for Redis
help:
help:    Usage: rediscache show [--name <name> --resource-group <resource-group>]
help:
help:    Options:
help:      -h, --help                             output usage information
help:      -v, --verbose                          use verbose output
help:      -vv                                    more verbose with debug output
help:      --json                                 use json output
help:      -n, --name <name>                      Name of the Azure Cache for Redis.
help:      -g, --resource-group <resource-group>  Name of the Resource Group
help:      -s, --subscription <subscription>      the subscription identifier
help:
help:    Current Mode: arm (Azure Resource Management)

Изменение параметров имеющегося кэша Azure для Redis

Чтобы изменить параметры имеющегося кэша Azure для Redis, используйте следующую команду:

    azure rediscache set [--name <name> --resource-group <resource-group> --redis-configuration <redis-configuration>/--redis-configuration-file <redisConfigurationFile>]

Чтобы получить дополнительные сведения об этой команде, выполните команду azure rediscache set -h.

C:\>azure rediscache set -h
help:    Change settings of an existing Azure Cache for Redis
help:
help:    Usage: rediscache set [--name <name> --resource-group <resource-group> --redis-configuration <redis-configuration>/--redis-configuration-file <redisConfigurationFile>]
help:
help:    Options:
help:      -h, --help                                               output usage information
help:      -v, --verbose                                            use verbose output
help:      -vv                                                      more verbose with debug output
help:      --json                                                   use json output
help:      -n, --name <name>                                        Name of the Azure Cache for Redis.
help:      -g, --resource-group <resource-group>                    Name of the Resource Group
help:      -c, --redis-configuration <redis-configuration>          Redis Configuration. Enter a JSON formatted string of configuration keys and values here.
help:      -f, --redis-configuration-file <redisConfigurationFile>  Redis Configuration. Enter the path of a file containing configuration keys and values here.
help:      -s, --subscription <subscription>                        the subscription identifier
help:
help:    Current Mode: arm (Azure Resource Management)

Обновление ключа аутентификации для имеющегося кэша Azure для Redis

Чтобы обновить ключ аутентификации для имеющегося кэша Azure для Redis, используйте следующую команду:

    azure rediscache renew-key [--name <name> --resource-group <resource-group> --key-type <key-type>]

Укажите Primary или Secondary для key-type.

Чтобы получить дополнительные сведения об этой команде, выполните команду azure rediscache renew-key -h.

C:\>azure rediscache renew-key -h
help:    Renew the authentication key for an existing Azure Cache for Redis
help:
help:    Usage: rediscache renew-key [--name <name> --resource-group <resource-group> ]
help:
help:    Options:
help:      -h, --help                             output usage information
help:      -v, --verbose                          use verbose output
help:      -vv                                    more verbose with debug output
help:      --json                                 use json output
help:      -n, --name <name>                      Name of the Azure Cache for Redis.
help:      -g, --resource-group <resource-group>  Name of the Resource Group under which cache exists
help:      -t, --key-type <key-type>              type of key to renew. Valid values are: 'Primary', 'Secondary'.
help:      -s, --subscription <subscription>      the subscription identifier
help:
help:    Current Mode: arm (Azure Resource Management)

Вывод первичного и вторичного ключей имеющегося кэша Azure для Redis

Чтобы вывести первичный и вторичный ключи имеющегося кэша Azure для Redis, используйте следующую команду:

    azure rediscache list-keys [--name <name> --resource-group <resource-group>]

Чтобы получить дополнительные сведения об этой команде, выполните команду azure rediscache list-keys -h.

C:\>azure rediscache list-keys -h
help:    Lists Primary and Secondary key of an existing Azure Cache for Redis
help:
help:    Usage: rediscache list-keys [--name <name> --resource-group <resource-group>]
help:
help:    Options:
help:      -h, --help                             output usage information
help:      -v, --verbose                          use verbose output
help:      -vv                                    more verbose with debug output
help:      --json                                 use json output
help:      -n, --name <name>                      Name of the Azure Cache for Redis.
help:      -g, --resource-group <resource-group>  Name of the Resource Group under which Cache exists
help:      -s, --subscription <subscription>      the subscription identifier
help:
help:    Current Mode: arm (Azure Resource Management)