Изменение настроек кластера
После создания кластера Apache Kafka® вы можете:
- Изменить класс и количество хостов.
- Изменить настройки хранилища (доступно только для стандартного
network-hdd
и быстрого сетевогоnetwork-ssd
хранилищ). - Изменить настройки Apache Kafka®.
- Переместить кластер из текущего каталога в другой каталог.
- Изменить группы безопасности кластера.
Изменить класс и количество хостов
Вы можете изменить:
- класс и количество хостов-брокеров Apache Kafka®;
- класс хостов ZooKeeper.
Важно
Количество хостов-брокеров Apache Kafka® нельзя уменьшить.
Если у вас еще нет интерфейса командной строки Yandex.Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы изменить класс и количество хостов:
-
Получите информацию о кластере:
yc managed-kafka cluster list yc managed-kafka cluster get <имя или идентификатор кластера>
-
Посмотрите описание команды CLI для изменения кластера:
yc managed-kafka cluster update --help
-
Чтобы увеличить количество хостов-брокеров, выполните команду:
yc managed-kafka cluster update <имя или идентификатор кластера> --brokers-count <число>
-
Чтобы изменить класс хоста-брокера, выполните команду:
yc managed-kafka cluster update <имя или идентификатор кластера> --resource-preset <класс хоста>
-
Чтобы изменить класс хоста ZooKeeper, выполните команду:
yc managed-kafka cluster update <имя или идентификатор кластера> \ --zookeeper-resource-preset <класс хоста>
Воспользуйтесь методом API update и передайте в запросе:
- Идентификатор кластера в параметре
clusterId
. Чтобы узнать идентификатор, получите список кластеров в каталоге. - Список настроек, которые необходимо изменить, в параметре
updateMask
(одной строкой через запятую). Если не задать этот параметр, метод API сбросит на значения по умолчанию все настройки кластера, которые не были явно указаны в запросе. - Новую конфигурацию кластера в параметре
configSpec
.
Изменить настройки хранилища
Важно
На данный момент тип диска для кластера Apache Kafka® нельзя изменить после создания.
Если у вас еще нет интерфейса командной строки Yandex.Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы изменить настройки хранилища для хостов:
-
Проверьте, что нужный кластер использует именно стандартное или быстрое сетевое хранилище (увеличить размер локального или нереплицируемого сетевого хранилища невозможно). Для этого запросите информацию о кластере и найдите поле
disk_type_id
— его значение должно бытьnetwork-hdd
илиnetwork-ssd
:yc managed-kafka cluster list yc managed-kafka cluster get <имя или идентификатор кластера>
-
Посмотрите описание команды CLI для изменения кластера:
yc managed-kafka cluster update --help
-
Чтобы изменить размер дисков хостов-брокеров, выполните команду:
yc managed-kafka cluster update <имя или идентификатор кластера> --disk-size <размер диска>
Если не указаны единицы размера, то используются гигабайты.
-
Чтобы изменить размер дисков хостов ZooKeeper, выполните команду:
yc managed-kafka cluster update <имя или идентификатор кластера> \ --zookeeper-disk-size <размер диска>
Если не указаны единицы размера, то используются гигабайты.
Воспользуйтесь методом API update и передайте в запросе:
- Идентификатор кластера в параметре
clusterId
. Чтобы узнать идентификатор, получите список кластеров в каталоге. - Список настроек, которые необходимо изменить, в параметре
updateMask
(одной строкой через запятую). Если не задать этот параметр, метод API сбросит на значения по умолчанию все настройки кластера, которые не были явно указаны в запросе. - Новую конфигурацию кластера в параметре
configSpec
.
Изменить настройки Apache Kafka®
-
Перейдите на страницу каталога и выберите сервис Managed Service for Apache Kafka®.
-
Выберите кластер и нажмите кнопку Редактировать на панели сверху.
-
Измените настройки Apache Kafka®, нажав кнопку Настроить в блоке Настройки Kafka.
Подробнее см. в разделе Настройки Apache Kafka®.
-
Нажмите кнопку Сохранить.
Если у вас еще нет интерфейса командной строки Yandex.Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы изменить настройки Apache Kafka®:
-
Посмотрите описание команды CLI для изменения настроек кластера:
yc managed-kafka cluster update --help
-
Измените настройки Apache Kafka® в команде изменения кластера (в примере приведены не все настройки):
yc managed-kafka cluster update <имя кластера> \ --compression-type <тип сжатия> \ --log-flush-interval-messages <количество сообщений в логе, необходимое для их сброса на диск> \ --log-flush-interval-ms <максимальное время хранения сообщений в памяти перед сбросом на диск>
Воспользуйтесь методом API update и передайте в запросе:
- Идентификатор кластера в параметре
clusterId
. Чтобы узнать идентификатор, получите список кластеров в каталоге. - Список настроек, которые необходимо изменить, в параметре
updateMask
(одной строкой через запятую). Если не задать этот параметр, метод API сбросит на значения по умолчанию все настройки кластера, которые не были явно указаны в запросе. - Новые значения настроек Apache Kafka® в параметре:
configSpec.kafka.kafkaConfig_2_1
, если используете Apache Kafka® версии2.1
;configSpec.kafka.kafkaConfig_2_6
, если используете Apache Kafka® версии2.6
.
Переместить кластер
Чтобы переместить кластер из текущего каталога в другой, воспользуйтесь методом API move и передайте в запросе:
- Идентификатор кластера в параметре
clusterId
. Чтобы узнать идентификатор, получите список кластеров в каталоге. - Идентификатор каталога назначения в параметре
destinationFolderId
.
Изменить группы безопасности
Если у вас еще нет интерфейса командной строки Yandex.Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы изменить список групп безопасности для кластера:
-
Посмотрите описание команды CLI для изменения кластера:
$ yc managed-kafka cluster update --help
-
Укажите нужные группы безопасности в команде изменения кластера:
$ yc managed-kafka cluster update <имя кластера> --security-group-ids <список групп безопасности>
Чтобы изменить список групп безопасности кластера, воспользуйтесь методом API update
и передайте в запросе:
- Идентификатор кластера в параметре
clusterId
. Чтобы узнать идентификатор, получите список кластеров в каталоге. - Список групп в параметре
securityGroupIds
. - Список настроек, которые необходимо изменить, в параметре
updateMask
. Если не задать этот параметр, метод API сбросит на значения по умолчанию все настройки кластера, которые не были явно указаны в запросе.
Важно
Может потребоваться дополнительная настройка групп безопасности для подключения к кластеру.