Миграция хостов кластера Elasticsearch в другую зону доступности

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

Улучшена

Обновлена 24 апреля 2025 г.

Хосты кластера Managed Service for Elasticsearch располагаются в зонах доступности Yandex Cloud. Чтобы перенести хосты из одной зоны в другую:

Создайте подсеть в зоне доступности, в которую вы переносите хосты.
Добавьте хост в кластер. Можно добавлять и удалять только хосты с ролью Data node:
Консоль управления

CLI

Terraform

API
1. В консоли управления перейдите на страницу каталога и выберите сервис Managed Service for Elasticsearch.
2. Нажмите на имя нужного кластера, затем выберите вкладку Хосты.
3. Нажмите кнопку Создать хост.
4. Укажите параметры хоста:
  - Зону доступности, куда переносятся хосты.
  - Новую подсеть.
  - Выберите опцию Публичный доступ, если хост должен быть доступен извне Yandex Cloud.
5. Нажмите Сохранить.
Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

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

Выполните команду:
```
yc managed-elasticsearch host add \
   --cluster-name <имя_кластера> \
   --host type=datanode,`
         `zone-id=<зона_доступности>,`
         `subnet-id=<ID_новой_подсети>,`
         `assign-public-ip=<публичный_доступ_к_хосту:_true_или_false>
```
Имя кластера можно получить со списком кластеров в каталоге. В параметре zone-id укажите зону, куда вы переносите хосты.
1. В конфигурационный файл Terraform с планом инфраструктуры добавьте манифест хоста:
  resource "yandex_mdb_elasticsearch_cluster" "<имя_кластера>" { ... host { type = "DATA_NODE" zone = "<зона_доступности>" subnet_id = "<ID_новой_подсети>" assign_public_ip = <публичный_доступ_к_хосту:_true_или_false> } }
  В параметре zone укажите зону, куда вы переносите хосты.
2. Проверьте корректность настроек.
  1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
  2. Выполните команду:
    
    terraform validate
    
    Если в файлах конфигурации есть ошибки, Terraform на них укажет.
3. Подтвердите изменение ресурсов.
  1. Выполните команду для просмотра планируемых изменений:
    
    terraform plan
    
    Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
  2. Если вас устраивают планируемые изменения, внесите их:
    
    Выполните команду:
    
    terraform apply
    
    Подтвердите изменение ресурсов.
    
    Дождитесь завершения операции.
Чтобы добавить хост в кластер, воспользуйтесь методом REST API addHosts для ресурса Cluster или вызовом gRPC API ClusterService/AddHosts и передайте в запросе:
- Идентификатор кластера в параметре clusterId. Идентификатор можно получить со списком кластеров в каталоге.
- Настройки нового хоста в параметрах hostSpecs.
Чтобы успешно выполнять подключение к базе данных после миграции, укажите FQDN нового хоста в вашем бэкенде или клиенте (например, в коде или графической IDE). Удалите FQDN прежнего хоста в первоначальной зоне.

Чтобы узнать FQDN, получите список хостов в кластере:
```
yc managed-elasticsearch host list --cluster-name <имя_кластера>
```
FQDN указан в выводе команды, в столбце NAME. Также вы можете использовать особый FQDN для подключения.
Удалите хосты в первоначальной зоне доступности. Можно добавлять и удалять только хосты с ролью Data node.
Консоль управления

CLI

Terraform

API
1. В консоли управления перейдите на страницу каталога и выберите сервис Managed Service for Elasticsearch.
2. Нажмите на имя нужного кластера, затем выберите вкладку Хосты.
3. Нажмите на значок в строке нужного хоста, выберите пункт Удалить и подтвердите удаление.
Выполните команду для каждого хоста:
```
yc managed-elasticsearch host delete <FQDN_хоста> --cluster-name <имя_кластера>
```
1. В конфигурационном файле Terraform с планом инфраструктуры удалите из описания кластера блоки host с первоначальной зоной доступности.
2. Проверьте корректность настроек.
  1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
  2. Выполните команду:
    
    terraform validate
    
    Если в файлах конфигурации есть ошибки, Terraform на них укажет.
3. Подтвердите удаление ресурсов.
  1. Выполните команду для просмотра планируемых изменений:
    
    terraform plan
    
    Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
  2. Если вас устраивают планируемые изменения, внесите их:
    
    Выполните команду:
    
    terraform apply
    
    Подтвердите изменение ресурсов.
    
    Дождитесь завершения операции.
Чтобы удалить хост, воспользуйтесь методом REST API deleteHosts для ресурса Cluster или вызовом gRPC API ClusterService/DeleteHosts и передайте в запросе:
- Идентификатор кластера в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
- FQDN-имя или массив имен удаляемых хостов в параметре hostNames.
Дождитесь, когда кластер перейдет в состояние Alive. В консоли управления перейдите на страницу каталога и выберите сервис Managed Service for Elasticsearch. Состояние кластера отображается в столбце Доступность.

Для кластеров, хосты которых располагаются в зоне доступности ru-central1-d, недоступно хранилище на локальных SSD-дисках при использовании платформы Intel Cascade Lake.

Особенности миграции в сервисе Yandex Data Transfer

Если кластер выступает в роли эндпоинта при передаче данных с помощью сервиса Data Transfer и используется тип трансфера Репликация или Копирование и репликация, перезапустите трансфер после миграции кластера. Так трансфер получит сведения о новой топологии кластера.

Трансферы типа Копирование перезапускать не нужно, так как во время их активации информация о новой топологии передается автоматически.

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

Деактивируйте трансфер и дождитесь его перехода в статус Остановлен. Затем активируйте трансфер и дождитесь его перехода в статус Реплицируется.
Измените какую-либо настройку трансфера или эндпоинта.

Подробнее см. в разделе Миграция эндпоинтов и трансфера Data Transfer в другую зону доступности.

Миграция хостов кластера Elasticsearch в другую зону доступности

Особенности миграции в сервисе Yandex Data TransferОсобенности миграции в сервисе Yandex Data Transfer

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

Особенности миграции в сервисе Yandex Data Transfer