Управление хостами кластера

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

Получить список хостов в кластере
Добавить хост
Изменить хост
Удалить хост

Вы можете добавлять и удалять хосты кластера, а также управлять настройками ClickHouse для отдельных кластеров.

Важно

Если вы создали кластер без поддержки ClickHouse Keeper, то прежде чем добавлять новые хосты в любой из шардов, включите отказоустойчивость с использованием хостов ZooKeeper.

Получить список хостов в кластере

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

CLI

API

Перейдите на страницу каталога и выберите сервис Managed Service for ClickHouse.
Нажмите на имя нужного кластера, затем выберите вкладку Хосты.

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

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

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

yc managed-clickhouse host list \
   --cluster-name=<имя кластера>

+----------------------------+--------------+---------+--------+---------------+
|            NAME            |  CLUSTER ID  |  ROLE   | HEALTH |    ZONE ID    |
+----------------------------+--------------+---------+--------+---------------+
| rc1b...mdb.yandexcloud.net | c9qp71dk1... | MASTER  | ALIVE  | ru-central1-b |
| rc1c...mdb.yandexcloud.net | c9qp71dk1... | REPLICA | ALIVE  | ru-central1-c |
+----------------------------+--------------+---------+--------+---------------+

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

Воспользуйтесь методом API listHosts и передайте идентификатор кластера в параметре clusterId запроса.

Чтобы узнать идентификатор кластера, получите список кластеров в каталоге.

Добавить хост

Количество хостов в кластерах Managed Service for ClickHouse ограничено квотами на количество CPU и объем памяти, которые доступны кластерам БД в вашем облаке. Чтобы проверить используемые ресурсы, откройте страницу Квоты и найдите блок Managed Databases.

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

CLI

Terraform

API

Перейдите на страницу каталога и выберите сервис Managed Service for ClickHouse.
Нажмите на имя нужного кластера и перейдите на вкладку Хосты.
Нажмите кнопку Добавить хост.
Укажите параметры хоста:
- зону доступности;
- подсеть (если нужной подсети в списке нет, создайте ее);
- выберите опцию Публичный доступ, если хост должен быть доступен извне Yandex Cloud;
- имя шарда;
- выберите опцию Копировать схему данных, чтобы скопировать схему со случайной реплики на новый хост.

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

Чтобы добавить хост в кластер:

Запросите список подсетей кластера, чтобы выбрать подсеть для нового хоста:

yc vpc subnet list

+-----------+-----------+------------+---------------+------------------+
|     ID    |   NAME    | NETWORK ID |     ZONE      |      RANGE       |
+-----------+-----------+------------+---------------+------------------+
| b0cl69... | default-c | enp6rq7... | ru-central1-c | [172.16.0.0/20]  |
| e2lkj9... | default-b | enp6rq7... | ru-central1-b | [10.10.0.0/16]   |
| e9b0ph... | a-2       | enp6rq7... | ru-central1-a | [172.16.32.0/20] |
| e9b9v2... | default-a | enp6rq7... | ru-central1-a | [172.16.16.0/20] |
+-----------+-----------+------------+---------------+------------------+

Если нужной подсети в списке нет, создайте ее.

Посмотрите описание команды CLI для добавления хостов:
```
yc managed-clickhouse host add --help
```
Выполните команду добавления хоста:
```
yc managed-clickhouse host add \
   --cluster-name=<имя кластера> \
   --host zone-id=<зона доступности>,`
         `subnet-id=<идентификатор подсети>,`
         `assign-public-ip=<публичный доступ к хосту: true или false>,`
         `shard-name=<имя шарда>,`
         `type=clickhouse
```
Чтобы скопировать схему данных со случайной реплики на новый хост, укажите необязательный параметр --copy-schema.

Managed Service for ClickHouse запустит операцию добавления хоста.

Идентификатор подсети необходимо указать, если в зоне доступности больше одной подсети, в противном случае Managed Service for ClickHouse автоматически выберет единственную подсеть. Имя кластера можно запросить со списком кластеров в каталоге.

Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

О том, как создать такой файл, см. в разделе Создание ClickHouse-кластера.

Добавьте к описанию кластера Managed Service for ClickHouse блок host.

resource "yandex_mdb_clickhouse_cluster" "<имя кластера>" {
  ...
  host {
    type             = "CLICKHOUSE"
    zone             = "<зона доступности>"
    subnet_id        = "<идентификатор подсети>"
    assign_public_ip = <публичный доступ к хосту: true или false>
  }
}

Проверьте корректность настроек.
1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
2. Выполните команду:
```
terraform validate
```
  Если в файлах конфигурации есть ошибки, Terraform на них укажет.
Подтвердите изменение ресурсов.
1. Выполните команду для просмотра планируемых изменений:
```
terraform plan
```
  Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
2. Если вас устраивают планируемые изменения, внесите их:
  1. Выполните команду:
```
terraform apply
```
  2. Подтвердите изменение ресурсов.
  3. Дождитесь завершения операции.

Подробнее см. в документации провайдера Terraform.

Воспользуйтесь методом API addHosts и передайте в запросе:

Идентификатор кластера в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
Настройки нового хоста в одном или нескольких параметрах hostSpecs.

Чтобы скопировать схему данных со случайной реплики на новый хост, передайте в запросе параметр copySchema со значением true.

Важно

Если после добавления хоста к нему невозможно подключиться, убедитесь, что группа безопасности кластера настроена корректно для подсети, в которую помещен хост.

Используйте опцию копирования схемы данных только в том случае, когда схема одинакова на всех хостах-репликах кластера.

Изменить хост

Для каждого хоста в кластере Managed Service for ClickHouse можно изменить настройки публичного доступа.

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

CLI

API

Чтобы изменить параметры хоста в кластере:

Перейдите на страницу каталога и выберите сервис Managed Service for ClickHouse.
Нажмите на имя нужного кластера и выберите вкладку Хосты.
Нажмите на значок в строке нужного хоста и выберите пункт Редактировать.
Включите опцию Публичный доступ, если хост должен быть доступен извне Yandex Cloud.
Нажмите кнопку Сохранить.

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

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

yc managed-clickhouse host update <имя хоста> \
   --cluster-name=<имя кластера> \
   --assign-public-ip=<публичный доступ к хосту: true или false>

Имя хоста можно запросить со списком хостов в кластере, имя кластера — со списком кластеров в каталоге.

Чтобы изменить параметры хоста, воспользуйтесь методом API updateHosts и передайте в запросе:

Идентификатор кластера, в котором нужно изменить хост, в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
Имя хоста, который нужно изменить, в параметре updateHostSpecs.hostName. Чтобы узнать имя, получите список хостов в кластере.
Настройки публичного доступа к хосту в параметре updateHostSpecs.assignPublicIp.
Список полей конфигурации кластера, подлежащих изменению (в данном случае — assignPublicIp), в параметре updateMask.

Важно

Этот метод API сбросит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask (одной строкой через запятую).

Важно

Если после изменения хоста к нему невозможно подключиться, убедитесь, что группа безопасности кластера настроена корректно для подсети, в которую помещен хост.

Удалить хост

Вы можете удалить хост из ClickHouse-кластера, если в кластере 3 и более хостов.

Примечание

Кластер, созданный с поддержкой механизма репликации ClickHouse Keeper, должен состоять из трех или более хостов.

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

CLI

Terraform

API

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

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

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

yc managed-clickhouse host delete <имя хоста> \
   --cluster-name=<имя кластера>

Имя хоста можно запросить со списком хостов в кластере, имя кластера — со списком кластеров в каталоге.

Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

О том, как создать такой файл, см. в разделе Создание ClickHouse-кластера.
Удалите из описания кластера Managed Service for ClickHouse блок host с типом CLICKHOUSE.
Проверьте корректность настроек.
1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
2. Выполните команду:
```
terraform validate
```
  Если в файлах конфигурации есть ошибки, Terraform на них укажет.
Подтвердите удаление ресурсов.
1. Выполните команду для просмотра планируемых изменений:
```
terraform plan
```
  Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
2. Если вас устраивают планируемые изменения, внесите их:
  1. Выполните команду:
```
terraform apply
```
  2. Подтвердите изменение ресурсов.
  3. Дождитесь завершения операции.

Подробнее см. в документации провайдера Terraform.

Воспользуйтесь методом API deleteHosts и передайте в запросе:

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

Управление хостами кластера

Получить список хостов в кластере

Добавить хост

Изменить хост

Удалить хост

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