Доступно в редакциях:  CE, SE, SE+, EE, CSE Lite (1.73), CSE Pro (1.73)

Стадия жизненного цикла модуля: General Availability

У модуля есть требования для установки

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

Работоспособность модуля при использовании других ядер или дистрибутивов возможна, но не гарантируется.

Как явно включить или отключить модуль…

Явно включить или выключить модуль можно одним из следующих способов:

  • С помощью веб-интерфейса Deckhouse. В разделе «Система» → «Управление системой» → «Deckhouse» → «Модули», откройте модуль sds-node-configurator, включите (или выключите) переключатель «Модуль включен». Сохраните изменения.

    Пример:

    Интерфейс включения и выключения модуля

  • С помощью Deckhouse CLI (d8).

    Используйте команду d8 system module enable для включения модуля, или d8 system module disable для выключения модуля (требуется Deckhouse CLI (d8), настроенный на работу с кластером).

    Пример включения модуля sds-node-configurator:

    d8 system module enable sds-node-configurator

  • С помощью ModuleConfig sds-node-configurator.

    Установите spec.enabled в true или false в ModuleConfig sds-node-configurator (создайте его, при необходимости).

    Пример манифеста для включения модуля sds-node-configurator:

    apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
  name: sds-node-configurator
spec:
  enabled: true

Как настроить модуль…

Настроить модуль можно одним из следующих способов:

  • С помощью веб-интерфейса Deckhouse.

    В разделе «Система» → «Управление системой» → «Deckhouse» → «Модули», откройте модуль sds-node-configurator, включите переключатель «Дополнительные настройки». Заполните необходимые поля формы на вкладке «Конфигурация», или укажите настройки модуля в формате YAML на вкладке «YAML», не включая секцию settings. Сохраните изменения.

    Пример:

    Интерфейс настройки модуля

    Вы также можете отредактировать объект ModuleConfig sds-node-configurator на вкладке «YAML» в окне настроек модуля («Система» → «Управление системой» → «Deckhouse» → «Модули», откройте модуль sds-node-configurator), указав версию схемы в параметре spec.version и необходимые параметры модуля в секции spec.settings.

  • С помощью Deckhouse CLI (d8) (требуется Deckhouse CLI (d8), настроенный на работу с кластером).

    Отредактируйте существующий ModuleConfig sds-node-configurator (подробнее о настройке Deckhouse читайте в документации), выполнив следующую команду:

    d8 k edit mc sds-node-configurator

    Внесите необходимые изменения в секцию spec.settings. При необходимости укажите версию схемы в параметре spec.version. Сохраните изменения.

    Вы также можете создать файл манифеста ModuleConfig sds-node-configurator, используя пример ниже. Заполните секцию spec.settings необходимыми параметрами модуля. При необходимости укажите версию схемы в параметре spec.version.

    Примените манифест с помощью следующей команды (укажите имя файла манифеста):

    d8 k apply -f <FILENAME>

    Пример файла манифеста ModuleConfig sds-node-configurator:

    apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
  name: sds-node-configurator
spec:
  version: 1
  enabled: true
  settings: # Параметры модуля из раздела "Параметры" ниже.

Как сменить канал обновлений модуля…

Для смены канала обновлений модуля воспользуйтесь инструкцией.

Требования

К версии Deckhouse: 1.72 и выше.

Параметры

Версия схемы: 1

  • settings
    объект
    • settings.disableDs
      булевый
      Выключить DaemonSet sds-node-configurator.

      По умолчанию: false

    • settings.enableNetlinkBlockDeviceDiscovery
      булевый
      Использовать netlink/sysfs вместо lsblk как источник данных для обнаружения блочных устройств в agent. При выключенном флаге agent обнаруживает блочные устройства через lsblk.

      По умолчанию: false

    • settings.enableThinProvisioning
      булевый
      Включить поддержку thin-LVM-томов.

      По умолчанию: true

    • settings.fileDevicesDirectory
      строка

      Базовый каталог на каждом узле, внутри которого агенту разрешено создавать файлы-подложки для файловых LVM-устройств (spec.fileDevices).

      Каждый spec.fileDevices[].directory должен совпадать с этим каталогом либо быть его подкаталогом; файлы-подложки вне этого поддерева агент отклоняет, чтобы произвольный путь на узле (например, /etc или /var/lib/kubelet) нельзя было переполнить. Переопределите параметр, указав отдельный диск с данными, смонтированный на узле, если в каталоге по умолчанию недостаточно места.

      Корень файловой системы (/) указать нельзя: тогда подкаталогом считался бы любой абсолютный путь и ограничение перестало бы работать.

      По умолчанию: /opt/deckhouse/sds/file-devices

      Шаблон: ^/[^/]+(/[^/]+)*$

    • settings.fileDevicesMinFreeSpacePercent
      целочисленный

      Доля файловой системы (в процентах), которую агент оставляет свободной при создании или увеличении файлового LVM-устройства (spec.fileDevices).

      Файлы-подложки создаются с преаллокацией, и по умолчанию они лежат на корневой файловой системе узла. Занять место до последнего свободного байта — это уже не ошибка провижининга, а отказ уровня узла: kubelet начинает вытеснять поды при nodefs.available<10%, задолго до реального заполнения файловой системы. Значение по умолчанию (15%) совпадает с более строгим порогом kubelet imagefs.available и оставляет запас относительно порога nodefs.

      Запись, которая не укладывается в это ограничение, не создаётся, а причина сообщается в condition VGConfigurationApplied ресурса LVMVolumeGroup; сама Volume Group при этом продолжает работать.

      Уменьшать значение имеет смысл, только если fileDevicesDirectory указывает на отдельный диск, от которого больше ничего на узле не зависит. 0 полностью отключает резерв.

      По умолчанию: 15

      Допустимые значения: 0 <= X <= 90

    • settings.logLevel
      строка
      Уровень логирования для приложений модуля.

      По умолчанию: INFO

      Допустимые значения: ERROR, WARN, INFO, DEBUG, TRACE