Доступно в редакциях:  Ultimate/EE

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

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

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

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

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

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

    Пример:

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

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

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

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

    d8 system module enable sds-object

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

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

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

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

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

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

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

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

    Пример:

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

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

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

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

    d8 k edit mc sds-object

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

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

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

    d8 k apply -f <FILENAME>

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

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

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

Чтобы сменить канал обновлений модуля, выполните действия из раздела Как сменить канал обновлений для модуля?.

Требования

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

Параметры

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

  • settings
    объект
    • settings.controller
      объект
      Настройки sds-object-controller — компонента, который обрабатывает ресурсы хранилищ (SeaweedFSStore, SDSElasticStore), а также ObjectStore, Bucket, BucketContents и BucketAccess.

      По умолчанию: {}

      • settings.controller.resourcesManagement
        объект
        Настройки управления ресурсами sds-object-controller.

        По умолчанию: {}

        Пример: 

        mode: VPA
vpa:
  cpu:
    limitRatio: 1.5
    max: 200m
    min: 50m
  memory:
    limitRatio: 1.5
    max: 256Mi
    min: 64Mi
  mode: Auto
        • settings.controller.resourcesManagement.mode
          строка
          Режим управления запросами ресурсов: классический Static (requests/limits) или VPA.

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

          Допустимые значения: VPA, Static

        • settings.controller.resourcesManagement.static
          объект
          Настройки статического управления ресурсами.
          • settings.controller.resourcesManagement.static.limits
            объект
            Лимиты ресурсов для пода controller.
            • settings.controller.resourcesManagement.static.limits.cpu
              Лимит CPU.
            • settings.controller.resourcesManagement.static.limits.memory
              Лимит памяти.
          • settings.controller.resourcesManagement.static.requests
            объект
            Запросы ресурсов для пода controller.
            • settings.controller.resourcesManagement.static.requests.cpu
              Запрос CPU.
            • settings.controller.resourcesManagement.static.requests.memory
              Запрос памяти.
        • settings.controller.resourcesManagement.vpa
          объект
          Параметры режима VPA.

          По умолчанию: {}

          • settings.controller.resourcesManagement.vpa.cpu
            объект
            Параметры, связанные с CPU.

            По умолчанию: {}

            • settings.controller.resourcesManagement.vpa.cpu.limitRatio
              число

              Коэффициент для расчёта начального лимита CPU от запроса.

              В дальнейшем VPA сохраняет получившееся соотношение limits/requests при изменении ресурсов.

            • settings.controller.resourcesManagement.vpa.cpu.max
              Максимально допустимый запрос CPU.

              По умолчанию: 200m

            • settings.controller.resourcesManagement.vpa.cpu.min
              Минимально допустимый запрос CPU.

              По умолчанию: 50m

          • settings.controller.resourcesManagement.vpa.memory
            объект
            Параметры, связанные с памятью.

            По умолчанию: {}

            • settings.controller.resourcesManagement.vpa.memory.limitRatio
              число

              Коэффициент для расчёта начального лимита памяти от запроса.

              В дальнейшем VPA сохраняет получившееся соотношение limits/requests при изменении ресурсов.

            • settings.controller.resourcesManagement.vpa.memory.max
              Максимально допустимый запрос памяти.

              По умолчанию: 256Mi

            • settings.controller.resourcesManagement.vpa.memory.min
              Минимально допустимый запрос памяти.

              По умолчанию: 64Mi

          • settings.controller.resourcesManagement.vpa.mode
            строка
            Режим использования VPA.

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

            Допустимые значения: Initial, Auto

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

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

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

    • settings.nodeSelector
      объект

      То же, что параметр spec.nodeSelector в подах Kubernetes. Применяется к сервисным подам модуля (controller, webhooks).

      Если параметр не задан, nodeSelector определяется автоматически.

      Примечание: это не управляет размещением data plane объектного хранилища — оно настраивается отдельно для каждого хранилища через SeaweedFSStore.spec.placement.

    • settings.tolerations
      массив объектов

      То же, что параметр spec.tolerations в подах Kubernetes. Применяется к сервисным подам модуля (controller, webhooks).

      Если параметр не задан, tolerations определяются автоматически.

      • settings.tolerations.effect
        строка
        Эффект taint, которому соответствует toleration. Пустое значение соответствует любому эффекту.

        Допустимые значения: ‘’, NoSchedule, PreferNoSchedule, NoExecute

      • settings.tolerations.key
        строка
        Ключ taint, к которому применяется toleration. Пустой ключ с operator: Exists соответствует любому taint.
      • settings.tolerations.operator
        строка
        Оператор, определяющий, как сопоставляются key и value.

        Допустимые значения: Exists, Equal

      • settings.tolerations.tolerationSeconds
        целое число

        Время в секундах, в течение которого toleration терпит taint после его появления.

        Применяется только при effect: NoExecute. Если параметр не задан, toleration действует бессрочно.

      • settings.tolerations.value
        строка
        Значение taint, которому соответствует toleration. Обязательно при operator: Equal.