Подключиться
Yandex Managed Service for Redis

Управление шардами кластера

Статья создана

Вы можете добавлять и удалять шарды кластера, запрашивать список шардов в выбранном кластере, а также выполнять ребалансировку кластера.

Важно

Управлять шардами можно только в шардированном кластере. Шардировать существующий нешардированный кластер невозможно. Как создать шардированный кластер см. в разделе Создание кластера.

Получить список шардов в кластере

  1. Перейдите на страницу каталога и выберите сервис Managed Service for Redis.

  2. Нажмите на имя нужного кластера, затем выберите вкладку Шарды.

Если у вас еще нет интерфейса командной строки Yandex.Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Чтобы получить список баз данных в кластере, выполните команду:

$ yc managed-redis shards list --cluster-name <имя кластера>
+--------------+
|     NAME     |
+--------------+
| test-shard-1 |
| test-shard-2 |
| test-shard-3 |
| test-shard-4 |
| test-shard-5 |
+--------------+

Получить детальную информацию о шарде

Если у вас еще нет интерфейса командной строки Yandex.Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Чтобы получить информацию о шарде, выполните команду:

$ yc managed-redis shards get <имя шарда> --cluster-name <имя кластера>

Идентификатор и имя кластера можно запросить со списком кластеров в каталоге.

Добавить шард

  1. Перейдите на страницу каталога и выберите сервис Managed Service for Redis.

  2. Нажмите на имя нужного кластера и перейдите на вкладку Шарды.

  3. Нажмите кнопку Добавить шард.

  4. Укажите параметры шарда:

    • имя шарда;
    • зоны доступности;
    • если требуется, добавьте дополнительные хосты в шард.

  5. Нажмите кнопку Создать шард.

Если у вас еще нет интерфейса командной строки Yandex.Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Чтобы добавить шард c двумя хостами в кластер:

$ yc managed-redis shards add --name <имя нового шарда> --cluster-name <имя кластера> \
  --host zone-id=<зона доступности>,subnet-name=<имя подсети> \
  --host zone-id=<зона доступности>,subnet-name=<имя подсети>

  1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

    О том, как создать такой файл, см. в разделе Создание Redis-кластера.

  2. Добавьте к описанию кластера Managed Service for Redis нужное количество блоков host с указанием имени шарда в параметре shard_name:

    resource "yandex_mdb_redis_cluster" "<имя кластера>" {
  ...
  host {
    zone       = "<зона доступности>"
    subnet_id  = <идентификатор подсети>
    shard_name = "<имя шарда>"
  }
}

  3. Проверьте корректность настроек.

    1. В командной строке перейдите в каталог, в котором вы создали конфигурационный файл.

    2. Выполните проверку с помощью команды:

      terraform plan

    Если конфигурация описана верно, в терминале отобразится список изменяемых ресурсов и их параметров. Если в конфигурации есть ошибки, Terraform на них укажет. Это проверочный этап: ресурсы не будут изменены.

  4. Подтвердите изменение ресурсов.

    1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply

    2. Подтвердите изменение ресурсов.

Подробнее см. в документации провайдера Terraform.

Чтобы получить возможность размещать данные в новом шарде, запустите ребалансировку кластера Managed Service for Redis.

Удалить шард

Внимание

Вместе с шардом удаляются все находящиеся в нем хосты.

  1. Перейдите на страницу каталога и выберите сервис Managed Service for Redis.

  2. Нажмите на имя нужного кластера и выберите вкладку Шарды.

  3. Нажмите значок в строке нужного шарда и в открывшемся меню нажмите кнопку Удалить.

  4. В открывшемся окне нажмите кнопку Удалить.

Если у вас еще нет интерфейса командной строки Yandex.Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Чтобы удалить шард из кластера, выполните команду:

$ yc managed-redis shards delete <имя шарда>
     --cluster-name=<имя кластера>

Имя шарда можно запросить со списком шардов в кластере, имя кластера — со списком кластеров в каталоге.

  1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

    О том, как создать такой файл, см. в разделе Создание Redis-кластера.

  2. Удалите из описания кластера Managed Service for Redis все блоки host, которые относятся к шарду.

  3. Проверьте корректность настроек.

    1. В командной строке перейдите в каталог, в котором вы создали конфигурационный файл.

    2. Выполните проверку с помощью команды:

      terraform plan

    Если конфигурация описана верно, в терминале отобразится список изменяемых ресурсов и их параметров. Если в конфигурации есть ошибки, Terraform на них укажет. Это проверочный этап: ресурсы не будут изменены.

  4. Подтвердите удаление ресурсов.

    1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply

    2. Подтвердите изменение ресурсов.

Подробнее см. в документации провайдера Terraform.

Ребалансировать кластер

Новый шард создается без хеш-слотов и не может принимать данные. Чтобы данные начали размещаться на новом шарде, выполните ребалансировку кластера — эта процедура выделит часть хеш-слотов кластера новому шарду. Данные в переназначенных хеш-слотах будут перемещены в соответствующий шард. Ребалансировка может выполняться на работающем кластере и не влияет на доступность и целостность данных.

Подробнее см. в разделе Масштабирование.

Чтобы ребалансировать кластер:

  1. Перейдите на страницу каталога и выберите сервис Managed Service for Redis.
  2. Нажмите на имя нужного кластера.
  3. На вкладке Обзор нажмите кнопку Ребалансировать.

Совет

Также можно ребалансировать кластер с помощью кнопки Ребалансировать кластер на вкладке Шарды.

Если у вас еще нет интерфейса командной строки Yandex.Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Чтобы ребалансировать кластер, выполните команду:

yc managed-redis cluster rebalance \
   --name=<имя кластера>

Имя кластера можно запросить со списком кластеров в каталоге.

Ребалансировать кластер можно с помощью метода rebalance.

В этой статье: