Подключиться
Yandex Managed Service for Apache Kafka®

Изменение настроек кластера

После создания кластера Apache Kafka® вы можете:

Изменить класс и количество хостов

Вы можете изменить:

  • класс и количество хостов-брокеров Apache Kafka®;
  • класс хостов ZooKeeper.

Важно

Количество хостов-брокеров Apache Kafka® нельзя уменьшить.

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

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

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

  1. Получите информацию о кластере:

    yc managed-kafka cluster list
yc managed-kafka cluster get <имя или идентификатор кластера>

  2. Посмотрите описание команды CLI для изменения кластера:

    yc managed-kafka cluster update --help

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

    yc managed-kafka cluster update <имя или идентификатор кластера> --brokers-count <число>

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

    yc managed-kafka cluster update <имя или идентификатор кластера> --resource-preset <класс хоста>

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

    yc managed-kafka cluster update <имя или идентификатор кластера> \
--zookeeper-resource-preset <класс хоста>

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

  • Идентификатор кластера в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
  • Список настроек, которые необходимо изменить, в параметре updateMask (одной строкой через запятую). Если не задать этот параметр, метод API сбросит на значения по умолчанию все настройки кластера, которые не были явно указаны в запросе.
  • Новую конфигурацию кластера в параметре configSpec.

Изменить настройки хранилища

Важно

На данный момент тип диска для кластера Apache Kafka® нельзя изменить после создания.

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

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

Чтобы изменить настройки хранилища для хостов:

  1. Проверьте, что нужный кластер использует именно стандартное или быстрое сетевое хранилище (увеличить размер локального или нереплицируемого сетевого хранилища невозможно). Для этого запросите информацию о кластере и найдите поле disk_type_id — его значение должно быть network-hdd или network-ssd:

    yc managed-kafka cluster list
yc managed-kafka cluster get <имя или идентификатор кластера>

  2. Посмотрите описание команды CLI для изменения кластера:

    yc managed-kafka cluster update --help

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

    yc managed-kafka cluster update <имя или идентификатор кластера> --disk-size <размер диска>

    Если не указаны единицы размера, то используются гигабайты.

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

    yc managed-kafka cluster update <имя или идентификатор кластера> \
--zookeeper-disk-size <размер диска>

    Если не указаны единицы размера, то используются гигабайты.

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

  • Идентификатор кластера в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
  • Список настроек, которые необходимо изменить, в параметре updateMask (одной строкой через запятую). Если не задать этот параметр, метод API сбросит на значения по умолчанию все настройки кластера, которые не были явно указаны в запросе.
  • Новую конфигурацию кластера в параметре configSpec.

Изменить настройки Apache Kafka®

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

  2. Выберите кластер и нажмите кнопку Редактировать на панели сверху.

  3. Измените настройки Apache Kafka®, нажав кнопку Настроить в блоке Настройки Kafka.

    Подробнее см. в разделе Настройки Apache Kafka®.

  4. Нажмите кнопку Сохранить.

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

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

Чтобы изменить настройки Apache Kafka®:

  1. Посмотрите описание команды CLI для изменения настроек кластера:

    yc managed-kafka cluster update --help

  2. Измените настройки 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 и передайте в запросе:

Изменить группы безопасности

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

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

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

  1. Посмотрите описание команды CLI для изменения кластера:

    $ yc managed-kafka cluster update --help

  2. Укажите нужные группы безопасности в команде изменения кластера:

    $ yc managed-kafka cluster update <имя кластера>
     --security-group-ids <список групп безопасности>

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

  • Идентификатор кластера в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
  • Список групп в параметре securityGroupIds.
  • Список настроек, которые необходимо изменить, в параметре updateMask. Если не задать этот параметр, метод API сбросит на значения по умолчанию все настройки кластера, которые не были явно указаны в запросе.

Важно

Может потребоваться дополнительная настройка групп безопасности для подключения к кластеру.

В этой статье: