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

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

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

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

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

   CLI

   Terraform

   API

   1. В консоли управления перейдите на страницу каталога и выберите сервис Managed Service for PostgreSQL.

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

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

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

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

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

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

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

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

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

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

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

      resource "yandex_mdb_postgresql_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.

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

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

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

   FQDN указан в выводе команды, в столбце NAME. Также вы можете использовать особый FQDN для подключения.

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

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

   CLI

   Terraform

   API

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

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

   yc managed-postgresql 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.

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

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

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

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

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

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

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