Обновление версии Valkey™
Вы можете обновить кластер Yandex Managed Service for Valkey™ до любой поддерживаемой версии.
Поддерживаемые версии
Каждая версия Valkey™, поддержка которой была включена в Yandex Managed Service for Valkey™, остается доступной, пока она поддерживается производителем. Как правило, это 24 месяца с даты выпуска версии. Подробнее см. в документации Valkey™
Узнать доступные версии Valkey™
- В консоли управления
перейдите на страницу каталога и выберите сервис Yandex Managed Service for Valkey™. - Выберите кластер и нажмите кнопку Редактировать.
- Откройте список в поле Версия.
Перед обновлением версии
Убедитесь, что это не нарушит работу ваших приложений:
- Посмотрите в истории изменений
Valkey™, как обновления могут повлиять на работу ваших приложений. - Попробуйте обновить версию на тестовом кластере. Его можно развернуть из резервной копии основного кластера, если версия Valkey™ в резервной копии поддерживается в Yandex Managed Service for Valkey™.
- Создайте резервную копию основного кластера непосредственно перед обновлением версии.
Обновить кластер
Внимание
- После обновления СУБД до выбранной версии вернуть кластер к предыдущей версии невозможно.
- Успешность обновления версии Valkey™ зависит от многих факторов, в том числе от настроек кластера и данных, хранящихся в базах. Рекомендуется сначала обновить тестовый кластер, который использует те же данные и настройки.
- В консоли управления
перейдите в каталог с кластером, который нужно обновить. - Выберите сервис Yandex Managed Service for Valkey™.
- Выберите нужный кластер в списке и нажмите кнопку Редактировать.
- В поле Версия выберите новую версию.
- Нажмите кнопку Сохранить изменения.
После запуска обновления кластер переходит в статус Updating. Дождитесь окончания операции и проверьте версию кластера.
Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.
По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>
. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name
или --folder-id
.
-
Получите список ваших кластеров Valkey™ командой:
yc managed-redis cluster list
-
Получите информацию о нужном кластере и проверьте версию Valkey™, указанную в свойстве
config.version
:yc managed-redis cluster get <имя_или_идентификатор_кластера>
-
Запустите обновление Valkey™:
yc managed-redis cluster update <имя_или_идентификатор_кластера> \ --redis-version <номер_новой_версии>
После запуска обновления кластер переходит в статус Updating. Дождитесь окончания операции и проверьте версию кластера.
-
Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.
О том, как создать такой файл, см. в разделе Создание кластера.
-
В блоке
config
измените параметрversion
на номер версии Valkey™, до которой хотите обновиться:resource "yandex_mdb_redis_cluster" "<имя_кластера>" { ... config { version = "<номер_новой_версии>" ... } }
-
Проверьте корректность настроек.
-
В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
-
Выполните команду:
terraform validate
Если в файлах конфигурации есть ошибки, Terraform на них укажет.
-
-
Подтвердите изменение ресурсов.
-
Выполните команду для просмотра планируемых изменений:
terraform plan
Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
-
Если вас устраивают планируемые изменения, внесите их:
-
Выполните команду:
terraform apply
-
Подтвердите изменение ресурсов.
-
Дождитесь завершения операции.
-
-
Подробнее см. в документации провайдера Terraform
Ограничения по времени
Провайдер Terraform ограничивает время на выполнение операций с кластером Yandex Managed Service for Valkey™:
- создание, в т. ч. путем восстановления из резервной копии, — 15 минут;
- изменение — 60 минут;
- удаление — 15 минут.
Операции, длящиеся дольше указанного времени, прерываются.
Как изменить эти ограничения?
Добавьте к описанию кластера блок timeouts
, например:
resource "yandex_mdb_redis_cluster" "<имя_кластера>" {
...
timeouts {
create = "1h30m" # Полтора часа
update = "2h" # 2 часа
delete = "30m" # 30 минут
}
}
-
Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
export IAM_TOKEN="<IAM-токен>"
-
Воспользуйтесь методом Cluster.Update и выполните запрос, например, с помощью cURL
:Важно
Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре
updateMask
(одной строкой через запятую).curl \ --request PATCH \ --header "Authorization: Bearer $IAM_TOKEN" \ --header "Content-Type: application/json" \ --url 'https://mdb.api.yandexcloud.kz/managed-redis/v1/clusters/<идентификатор_кластера>' \ --data '{ "updateMask": "configSpec.version", "configSpec": { "version": "<версия_Valkey™>" } }'
Где:
-
updateMask
— перечень изменяемых параметров в одну строку через запятую.В данном случае передается только один параметр.
-
configSpec.version
— новая версия Valkey™.
Идентификатор кластера можно запросить со списком кластеров в каталоге.
-
-
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.
-
Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
export IAM_TOKEN="<IAM-токен>"
-
Клонируйте репозиторий cloudapi
:cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
Далее предполагается, что содержимое репозитория находится в директории
~/cloudapi/
. -
Воспользуйтесь вызовом ClusterService.Update и выполните запрос, например, с помощью gRPCurl
:Важно
Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре
update_mask
(в виде массива строкpaths[]
).Формат перечисления настроек
"update_mask": { "paths": [ "<настройка_1>", "<настройка_2>", ... "<настройка_N>" ] }
grpcurl \ -format json \ -import-path ~/cloudapi/ \ -import-path ~/cloudapi/third_party/googleapis/ \ -proto ~/cloudapi/yandex/cloud/mdb/redis/v1/cluster_service.proto \ -rpc-header "Authorization: Bearer $IAM_TOKEN" \ -d '{ "cluster_id": "<идентификатор_кластера>", "update_mask": { "paths": [ "config_spec.version" ] }, "config_spec": { "version": "<версия_Valkey™>" } }' \ mdb.api.yandexcloud.kz:443 \ yandex.cloud.mdb.redis.v1.ClusterService.Update
Где:
-
update_mask
— перечень изменяемых параметров в виде массива строкpaths[]
.В данном случае передается только один параметр.
-
config_spec.version
— новая версия Valkey™.
Идентификатор кластера можно запросить со списком кластеров в каталоге.
-
-
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.
Примеры
Допустим, нужно обновить кластер с версии 7.0 до версии 7.2.
-
Чтобы получить список кластеров и узнать их имена и идентификаторы, выполните команду:
yc managed-redis cluster list
Результат:
+----------------------+---------------+---------------------+--------+---------+ | ID | NAME | CREATED AT | HEALTH | STATUS | +----------------------+---------------+---------------------+--------+---------+ | c9q8p8j2gaih******** | redis406 | 2022-04-23 12:44:17 | ALIVE | RUNNING | +----------------------+---------------+---------------------+--------+---------+
-
Чтобы получить информацию о кластере с именем
redis406
, выполните команду:yc managed-redis cluster get redis406
Результат:
id: c9q8p8j2gaih******** ... config: version: "7.0" ...
-
Для обновления кластера с именем
redis406
до версии 7.2, выполните команду:yc managed-redis cluster update redis406 --redis-version 7.2