Изменение версии и редакции Elasticsearch

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

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

1. Получите список ваших кластеров Elasticsearch:

   yc managed-elasticsearch cluster list
   

2. Получите информацию о нужном кластере и проверьте версию в свойстве config.version:

   yc managed-elasticsearch cluster get <имя_или_идентификатор_кластера>
   

3. Обновите версию:

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

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

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

   Полный список доступных для изменения полей конфигурации кластера Managed Service for Elasticsearch см. в документации провайдера Terraform.

2. Добавьте к описанию кластера Managed Service for Elasticsearch поле config.version или измените его значение, если оно уже существует:

   resource "yandex_mdb_elasticsearch_cluster" "<имя_кластера>" {
     ...
     config {
       version = "<версия_Elasticsearch>"
     }
   }
   

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

   Ограничения по времени

   Провайдер Terraform ограничивает время на выполнение операций с кластером Managed Service for Elasticsearch:

   • создание, в т. ч. путем восстановления из резервной копии, — 30 минут;
   • изменение — 60 минут;
   • удаление — 15 минут.

   Операции, длящиеся дольше указанного времени, прерываются.

   Как изменить эти ограничения?

   Добавьте к описанию кластера блок timeouts, например:

   resource "yandex_mdb_elasticsearch_cluster" "<имя_кластера>" {
     ...
     timeouts {
       create = "1h30m" # Полтора часа
       update = "2h"    # 2 часа
       delete = "30m"   # 30 минут
     }
   }
   

Чтобы обновить версию, воспользуйтесь методом REST API update для ресурса Cluster или вызовом gRPC API ClusterService/Update и передайте в запросе:

• Идентификатор кластера в параметре clusterId.

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

• Новую версию Elasticsearch в параметре configSpec.version.

• Список изменяемых полей конфигурации кластера в параметре updateMask (в данном случае — configSpec.version).

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

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

1. Получите список ваших кластеров Elasticsearch:

   yc managed-elasticsearch cluster list
   

2. Получите информацию о нужном кластере и проверьте редакцию в свойстве config.edition:

   yc managed-elasticsearch cluster get <имя_или_идентификатор_кластера>
   

3. Измените редакцию:

   yc managed-elasticsearch cluster update <имя_или_идентификатор_кластера> \
      --edition <редакция_Elasticsearch>
   

   Где --edition — редакция Elasticsearch: basic или platinum.

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

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

2. Добавьте к описанию кластера Managed Service for Elasticsearch поле config.edition или измените его значение, если поле уже существует:

   resource "yandex_mdb_elasticsearch_cluster" "<имя_кластера>" {
     ...
     config {
       edition = "<редакция_Elasticsearch>"
       ...
     }
     ...
   }
   

   Где edition — редакция Elasticsearch: basic или platinum.

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

resource "yandex_mdb_elasticsearch_cluster" "<имя_кластера>" {
  ...
  timeouts {
    create = "1h30m" # Полтора часа
    update = "2h"    # 2 часа
    delete = "30m"   # 30 минут
  }
}

Чтобы изменить редакцию Elasticsearch, воспользуйтесь методом REST API update для ресурса Cluster или вызовом gRPC API ClusterService/Update и передайте в запросе:

• Идентификатор кластера в параметре clusterId.

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

• Новую редакцию Elasticsearch в параметре configSpec.edition.

• Список изменяемых полей конфигурации кластера в параметре updateMask (в данном случае — configSpec.edition).