Замена FQDN статического узла

Полное доменное имя (Fully Qualified Domain Name, FQDN) статического узла задаётся параметром host в секции hosts. Чтобы изменить FQDN без замены сервера и дисков, выполните следующие действия.

Создайте DNS-запись для нового FQDN, указывающую на тот же сервер. Новый FQDN должен разрешаться со всех узлов кластера. Не удаляйте старую DNS-запись до окончания процедуры. Если кластер использует TLS, подготовьте сертификат узла, содержащий новый FQDN.

1. Получите текущую конфигурацию кластера с помощью команды ydb admin cluster config fetch:

   ydb [global options...] admin cluster config fetch > config.yaml
   

2. В файле config.yaml найдите существующий элемент списка hosts для заменяемого узла и измените только его значение host. Не удаляйте запись узла и не создавайте новую в другом месте — это изменит позицию узла в конфигурации и нарушит обновление.

   Например, для узла с идентификатором 1 замените node-1.example.com на node-1-new.example.com:

   config:
     hosts:
     - host: node-1-new.example.com
       node_id: 1
   

3. Примените новую конфигурацию с помощью команды ydb admin cluster config replace:

   ydb [global options...] admin cluster config replace -f config.yaml
   

4. Дождитесь, пока в локальной копии файла config.yaml на заменяемом узле появится новый FQDN.

5. Подготовьте заменяемый узел к перезапуску:

   • Если кластер использует TLS, установите подготовленный сертификат.
   • Если узел запускается с параметром --node static, убедитесь, что новое значение host совпадает с выводом команды hostname или hostname -f. Если значения не совпадают, перед перезапуском настройте операционную систему так, чтобы команда hostname -f возвращала новое значение host.

6. Получите разрешение на остановку процесса и перезапустите процесс статического узла. Например, при использовании systemd:

   sudo systemctl restart ydbd-storage
   

   Имя сервиса может отличаться в зависимости от способа развёртывания.

7. На вкладке Nodes страницы мониторинга кластера убедитесь, что узел подключился с прежним идентификатором и новым FQDN. После этого можно удалить старую DNS-запись.