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

Входит в расширения:  Продвинутое хранение данных, Хранение данных

Стадия жизненного цикла модуля: Общедоступная версия

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

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

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

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

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

  • С помощью веб-интерфейса 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 Platform читайте в документации), выполнив следующую команду:

    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 Platform: 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) нельзя было переполнить. Переопределите параметр, указав отдельный диск с данными, смонтированный на узле, если в каталоге по умолчанию недостаточно места: при стандартной разметке узла каталог по умолчанию делит файловую систему с /var/lib/kubelet и /var/lib/containerd.

      Прежний каталог по умолчанию, /opt/deckhouse/sds/file-devices, принимается дополнительно к указанному здесь. Поле spec.fileDevices[].directory неизменяемое, поэтому записи, созданные до переноса дерева модуля на узле, продолжают указывать его и не могут быть исправлены; они работают там, где есть.

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

      По умолчанию: /var/lib/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

    • settings.missingBlockDeviceRetentionHours
      целое число

      Сколько часов хранится ресурс BlockDevice, устройство которого пропало с узла, прежде чем агент его удалит.

      BlockDevice, который нельзя использовать (consumable: false, обычно устройство уже является физическим томом LVM), при пропаже устройства не удаляется: вместо этого ему выставляется condition Missing — сначала Unknown, а после 10 минут отсутствия устройства True. На узле, где LUN подключаются и отключаются динамически (гипервизор виртуализации, узел, подключающий диски виртуальным машинам), без удаления каждое такое устройство навсегда оставляло бы после себя ресурс.

      Срок отсчитывается с момента, когда Missing перешёл в True. Ресурс удаляется, только если ни один LVMVolumeGroup не перечисляет его в status.nodes и его status.lvmVolumeGroupName не указывает на существующий LVMVolumeGroup: физический том, пропавший из-под работающей группы томов, остаётся на виду. Если устройство вернётся, агент создаст ресурс заново.

      0 отключает удаление: ресурсы хранятся, пока их не удалят вручную.

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

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