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

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

Обновлена 17 октября 2024 г.

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

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

CLI

Terraform

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

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Выполните команду:
```
yc managed-mongodb host add \
   --cluster-name <имя_кластера> \
   --host type=<тип_хоста>,`
         `zone-id=<зона_доступности>,`
         `subnet-id=<ID_новой_подсети>,`
         `assign-public-ip=<публичный_доступ_к_хосту:_true_или_false>
```
Особенности команды:
- Имя кластера можно получить со списком кластеров в каталоге.
- Возможные значения параметра type: mongod, mongos, mongocfg, mongoinfra. Тип хоста зависит от типа шардирования.
- В параметре zone-id укажите зону, куда вы переносите хосты.
1. В конфигурационный файл Terraform с планом инфраструктуры добавьте манифест хоста:
  resource "yandex_mdb_mongodb_cluster" "<имя_кластера>" { ... host { type = "<тип_хоста>" zone_id = "<зона_доступности>" subnet_id = "<идентификатор_новой_подсети>" assign_public_ip = <публичный_доступ_к_хосту:_true_или_false> ... } }
  Возможные значения параметра type: MONGOD, MONGOINFRA, MONGOS или MONGOCFG. Тип хоста зависит от типа шардирования.
  
  В параметре 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-mongodb host list --cluster-name <имя_кластера>
```
FQDN указан в выводе команды, в столбце NAME.

О том, как получить FQDN хоста в Консоли управления, см. инструкцию.
Удалите хосты в первоначальной зоне доступности:
Консоль управления

CLI

Terraform

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

Примечание

Для кластеров, хосты которых располагаются в зоне доступности ru-central1-d, недоступно:

использование платформы Intel Broadwell;
хранилище на локальных SSD-дисках при использовании платформы Intel Cascade Lake.

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

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

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

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

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

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

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

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

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

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