Обновление версии OpenSearch
Вы можете обновить кластер Managed Service for OpenSearch до более новой версии OpenSearch.
Об обновлениях в рамках одной версии и обслуживании хостов см. в разделе Техническое обслуживание.
Узнать доступные версии
В консоли управления
Перед обновлением версии
Убедитесь, что обновление не нарушит работу ваших приложений:
- Посмотрите в истории изменений
OpenSearch, как обновления могут повлиять на работу ваших приложений. - Попробуйте обновить версию на тестовом кластере. Его можно развернуть из резервной копии основного кластера.
- Создайте резервную копию основного кластера непосредственно перед обновлением версии.
Обновить версию
- В консоли управления
перейдите на страницу каталога и выберите сервис Managed Service for OpenSearch. - Выберите кластер и нажмите кнопку Редактировать.
- В поле Версия выберите нужную версию OpenSearch.
- Нажмите кнопку Сохранить.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
-
Получите имя и идентификатор нужного кластера вместе со списком всех кластеров OpenSearch:
yc managed-opensearch cluster list
-
Получите информацию о нужном кластере и проверьте версию в параметре
config.version
:yc managed-opensearch cluster get <имя_или_идентификатор_кластера>
-
Обновите версию OpenSearch:
yc managed-opensearch cluster update <имя_или_идентификатор_кластера> \ --version <версия_OpenSearch>
-
Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.
О том, как создать такой файл, см. в разделе Создание кластера.
Полный список доступных для изменения полей конфигурации кластера Managed Service for OpenSearch см. в документации провайдера Terraform
. -
Измените в описании кластера значение параметра
version
в блокеconfig
. Если такого параметра нет, добавьте его.resource "yandex_mdb_opensearch_cluster" "<имя_кластера>" { ... config { version = "<версия_OpenSearch>" ... } }
-
Проверьте корректность настроек.
-
В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
-
Выполните команду:
terraform validate
Если в файлах конфигурации есть ошибки, Terraform на них укажет.
-
-
Подтвердите изменение ресурсов.
-
Выполните команду для просмотра планируемых изменений:
terraform plan
Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
-
Если вас устраивают планируемые изменения, внесите их:
-
Выполните команду:
terraform apply
-
Подтвердите изменение ресурсов.
-
Дождитесь завершения операции.
-
Ограничения по времени
Провайдер Terraform ограничивает время на выполнение операций с кластером Managed Service for OpenSearch:
- создание, в том числе путем восстановления из резервной копии, — 30 минут;
- изменение — 60 минут;
- удаление — 15 минут.
Операции, длящиеся дольше указанного времени, прерываются.
Как изменить эти ограничения?
Добавьте к описанию кластера блок
timeouts
, например:resource "yandex_mdb_opensearch_cluster" "<имя_кластера>" { ... timeouts { create = "1h30m" # Полтора часа update = "2h" # 2 часа delete = "30m" # 30 минут } }
-
Воспользуйтесь методом API update и передайте в запросе:
- Идентификатор кластера в параметре
clusterId
. Чтобы узнать идентификатор, получите список кластеров в каталоге. - Новую версию OpenSearch в параметре
configSpec.version
. - Список изменяемых полей конфигурации кластера в параметре
updateMask
(в данном случае —configSpec.version
).
Важно
Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask
(одной строкой через запятую).