Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Доступны в регионе
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • Машинное обучение
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Партнёрская программа
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Истории успеха
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Документация
  • Блог
Проект Яндекса
© 2025 ТОО «Облачные Сервисы Казахстан»
Yandex Managed Service for Valkey™
  • Начало работы
    • Все инструкции
      • Информация об имеющихся кластерах
      • Создание кластера
      • Изменение настроек кластера
      • Обновление версии Valkey™
      • Остановка и запуск кластера
      • Управление хостами кластера
      • Миграция хостов в другую зону доступности
      • Управление резервными копиями
      • Удаление кластера
  • Управление доступом
  • Справочник Terraform
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • Публичные материалы
  • История изменений
  • Вопросы и ответы

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

  • Поддерживаемые версии
  • Узнать доступные версии Valkey™
  • Перед обновлением версии
  • Обновить кластер
  • Примеры
  1. Пошаговые инструкции
  2. Кластеры
  3. Обновление версии Valkey™

Обновление версии Valkey™

Статья создана
Yandex Cloud
Улучшена
mmerihsesh
Обновлена 24 апреля 2025 г.
  • Поддерживаемые версии
    • Узнать доступные версии Valkey™
  • Перед обновлением версии
  • Обновить кластер
  • Примеры

Вы можете обновить кластер Yandex Managed Service for Valkey™ до любой поддерживаемой версии.

Поддерживаемые версииПоддерживаемые версии

Каждая версия Valkey™, поддержка которой была включена в Yandex Managed Service for Valkey™, остается доступной, пока она поддерживается производителем. Как правило, это 24 месяца с даты выпуска версии. Подробнее см. в документации Valkey™.

Узнать доступные версии Valkey™Узнать доступные версии Valkey™

Консоль управления
  1. В консоли управления перейдите на страницу каталога и выберите сервис Yandex Managed Service for Valkey™.
  2. Выберите кластер и нажмите кнопку Редактировать.
  3. Откройте список в поле Версия.

Перед обновлением версииПеред обновлением версии

Убедитесь, что это не нарушит работу ваших приложений:

  1. Посмотрите в истории изменений Valkey™, как обновления могут повлиять на работу ваших приложений.
  2. Попробуйте обновить версию на тестовом кластере. Его можно развернуть из резервной копии основного кластера, если версия Valkey™ в резервной копии поддерживается в Yandex Managed Service for Valkey™.
  3. Создайте резервную копию основного кластера непосредственно перед обновлением версии.

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

Внимание

  • После обновления СУБД до выбранной версии вернуть кластер к предыдущей версии невозможно.
  • Успешность обновления версии Valkey™ зависит от многих факторов, в том числе от настроек кластера и данных, хранящихся в базах. Рекомендуется сначала обновить тестовый кластер, который использует те же данные и настройки.
Консоль управления
CLI
Terraform
REST API
gRPC API
  1. В консоли управления перейдите в каталог с кластером, который нужно обновить.
  2. Выберите сервис Yandex Managed Service for Valkey™.
  3. Выберите нужный кластер в списке и нажмите кнопку Редактировать.
  4. В поле Версия выберите новую версию.
  5. Нажмите кнопку Сохранить изменения.

После запуска обновления кластер переходит в статус Updating. Дождитесь окончания операции и проверьте версию кластера.

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

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

  1. Получите список ваших кластеров Valkey™ командой:

    yc managed-redis cluster list
    
  2. Получите информацию о нужном кластере и проверьте версию Valkey™, указанную в свойстве config.version:

    yc managed-redis cluster get <имя_или_идентификатор_кластера>
    
  3. Запустите обновление Valkey™:

    yc managed-redis cluster update <имя_или_идентификатор_кластера> \
      --redis-version <номер_новой_версии>
    

    После запуска обновления кластер переходит в статус Updating. Дождитесь окончания операции и проверьте версию кластера.

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

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

  2. В блоке config измените параметр version на номер версии Valkey™, до которой хотите обновиться:

    resource "yandex_mdb_redis_cluster" "<имя_кластера>" {
        ...
        config {
            version  = "<номер_новой_версии>"
            ...
        }
    }
    
  3. Проверьте корректность настроек.

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

    2. Выполните команду:

      terraform validate
      

      Если в файлах конфигурации есть ошибки, Terraform на них укажет.

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

    1. Выполните команду для просмотра планируемых изменений:

      terraform plan
      

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

    2. Если вас устраивают планируемые изменения, внесите их:

      1. Выполните команду:

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

      3. Дождитесь завершения операции.

Подробнее см. в документации провайдера 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 минут
  }
}
  1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

    export IAM_TOKEN="<IAM-токен>"
    
  2. Воспользуйтесь методом 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™.

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

  3. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

  1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

    export IAM_TOKEN="<IAM-токен>"
    
  2. Клонируйте репозиторий cloudapi:

    cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
    

    Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.

  3. Воспользуйтесь вызовом 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™.

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

  4. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

ПримерыПримеры

Допустим, нужно обновить кластер с версии 7.0 до версии 7.2.

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

    yc managed-redis cluster list
    

    Результат:

    +----------------------+---------------+---------------------+--------+---------+
    |          ID          |     NAME      |     CREATED AT      | HEALTH | STATUS  |
    +----------------------+---------------+---------------------+--------+---------+
    | c9q8p8j2gaih******** |   redis406    | 2022-04-23 12:44:17 | ALIVE  | RUNNING |
    +----------------------+---------------+---------------------+--------+---------+
    
  2. Чтобы получить информацию о кластере с именем redis406, выполните команду:

    yc managed-redis cluster get redis406
    

    Результат:

    id: c9q8p8j2gaih********
    ...
    config:
      version: "7.0"
      ...
    
  3. Для обновления кластера с именем redis406 до версии 7.2, выполните команду:

    yc managed-redis cluster update redis406 --redis-version 7.2
    

Была ли статья полезна?

Предыдущая
Изменение настроек кластера
Следующая
Остановка и запуск кластера
Проект Яндекса
© 2025 ТОО «Облачные Сервисы Казахстан»