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

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

1. Создайте подсеть в зоне доступности, в которую вы переносите хосты.

2. Если в кластере используется класс хостов b2.medium или b3-c1-m4, измените его на другой класс. Иначе вы не сможете добавить хост в кластер и выполнить миграцию.

   Кластер недоступен около пяти — семи минут после изменения класса хостов.

   Прежний класс можно будет вернуть после миграции.

3. Добавьте хост в кластер:

   Консоль управления

   CLI

   Terraform

   API

   1. Перейдите на страницу каталога и выберите сервис Managed Service for Redis.

   2. Нажмите на имя нужного кластера и перейдите на вкладку Хосты.

   3. Нажмите кнопку  Создать хост.

   4. Укажите параметры хоста:

      • Зону доступности, куда переносятся хосты.
      • Новую подсеть.
      • Выберите опцию Публичный доступ, если хост должен быть доступен извне Yandex Cloud.

   5. Нажмите Сохранить.

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

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

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

   yc managed-redis host add \
      --cluster-name <имя_кластера> \
      --host zone-id=<зона_доступности>,`
            `subnet-id=<ID_новой_подсети>,`
            `assign-public-ip=<публичный_доступ_к_хосту:_true_или_false>
   

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

   В параметре zone-id укажите зону, куда вы переносите хосты.

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

      resource "yandex_mdb_redis_cluster" "<имя_кластера>" {
        ...
        host {
          zone             = "<зона_доступности>"
          subnet_id        = "<идентификатор_новой_подсети>"
          assign_public_ip = <публичный_доступ_к_хосту:_true_или_false>
        }
      }
      

      В параметре zone укажите зону, куда вы переносите хосты.

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

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

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

         terraform validate
         

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

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

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

         terraform plan
         

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

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

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

            terraform apply
            

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

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

   Чтобы добавить хост в кластер, воспользуйтесь методом REST API addHosts для ресурса Cluster или вызовом gRPC API ClusterService/AddHosts и передайте в запросе:

   • Идентификатор кластера в параметре clusterId. Идентификатор можно получить со списком кластеров в каталоге.
   • Настройки нового хоста в параметрах hostSpecs.

4. Чтобы успешно выполнять подключение к базе данных после миграции, укажите FQDN нового хоста в вашем бэкенде или клиенте (например, в коде или графической IDE). Удалите FQDN прежнего хоста в первоначальной зоне.

   Чтобы узнать FQDN, получите список хостов в кластере:

   yc managed-redis host list --cluster-name <имя_кластера>
   

   FQDN указан в выводе команды, в столбце NAME.

5. Удалите хосты в первоначальной зоне доступности:

   Консоль управления

   CLI

   Terraform

   API

   1. Перейдите на страницу каталога и выберите сервис Managed Service for Redis.
   2. Нажмите на имя нужного кластера и выберите вкладку Хосты.
   3. Нажмите на значок в строке нужного хоста, выберите пункт Удалить и подтвердите удаление.

   Выполните команду для каждого хоста:

   yc managed-redis host delete <FQDN_хоста> --cluster-name <имя_кластера>
   

   1. В конфигурационном файле Terraform с планом инфраструктуры удалите из описания кластера блоки host с первоначальной зоной доступности.

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

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

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

         terraform validate
         

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

   3. Введите слово yes и нажмите Enter.

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

         terraform plan
         

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

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

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

            terraform apply
            

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

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

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

   • Идентификатор кластера в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
   • FQDN-имя или массив имен удаляемых хостов в параметре hostNames.

6. Дождитесь, когда кластер перейдет в состояние Alive. В консоли управления перейдите на страницу каталога и выберите сервис Managed Service for Redis. Состояние кластера отображается в столбце Доступность.