Доступно в редакциях:  CE, BE, SE, SE+, EE

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

Если вы включаете модуль в кластере, где необходимо публиковать веб-интерфейсы служебных компонентов DKP и других модулей, убедитесь, что указан глобальный параметр publicDomainTemplate. Если он не указан, системные объекты HTTPRoute/Gateway/ListenerSet будут создаваться некорректно и веб-интерфейсы служебных компонентов DKP и других модулей не будут опубликованы.

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

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

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

    Пример:

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

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

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

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

    d8 system module enable alb

  • С помощью ModuleConfig alb.

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

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

    apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
  name: alb
spec:
  enabled: true

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

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

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

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

    Пример:

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

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

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

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

    d8 k edit mc alb

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

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

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

    d8 k apply -f <FILENAME>

    Пример файла манифеста ModuleConfig alb:

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

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

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

Требования

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

Параметры

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

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

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

      Допустимые значения: Error, Warning, Info, Debug, Verbose

      Пример: 


      logLevel: Info
    • settings.storageClass
      строка

      Имя StorageClass, который используется для хранения GeoIP-баз в geoproxy.

      Если параметр не задан, эффективный StorageClass выбирается в таком порядке:

      1. alb.storageClass
      2. global.modules.storageClass
      3. StorageClass по умолчанию в кластере

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

      Изменение этого параметра не переносит существующие StatefulSet или PVC geoproxy на другой StorageClass. Новое значение используется только для вновь создаваемых StatefulSet geoproxy.

      Примеры: 


      storageClass: ceph-ssd

      storageClass: 'false'