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

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

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

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

  • С помощью веб-интерфейса 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.highAvailability
      булевый

      Ручное управление режимом отказоустойчивости.

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

      Пример: 

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

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

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

      Пример: 

      logLevel: Info
    • settings.migrations
      объект
      Настраивает механизмы совместимости, используемые во время миграции с ingress-nginx на ALB.

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

      • settings.migrations.http01CertificateSolverBridging
        объект

        Включает преобразование HTTPRoute, создаваемых cert-manager для HTTP-01 solver через Gateway API, во временные объекты Ingress.

        Это позволяет обслуживать HTTP-01 challenge cert-manager, использующие Gateway API solver, через ingress-nginx во время миграции с ingress-nginx на ALB.

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

        • settings.migrations.http01CertificateSolverBridging.enabled
          булевый
          Включает bridging для HTTP-01 certificate solver. Bridging работает только при включённом модуле ingress-nginx.

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

        • settings.migrations.http01CertificateSolverBridging.ingressClassName
          строка
          Значение spec.ingressClassName для временных объектов Ingress. Если не задано, используется global.modules.ingressClass.

          Минимальная длина: 1

      • settings.migrations.ingress2Gateway
        объект
        Настраивает HTTP-сервер преобразования ingress2gateway в подах контроллера Gateway. По умолчанию сервер отключён. Включайте его только на время преобразования администратором кластера ресурсов Ingress в ресурсы Gateway API.

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

        • settings.migrations.ingress2Gateway.enabled
          булевый
          Включает HTTP-сервер преобразования ingress2gateway. Отключите сервер после завершения преобразования.

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

    • 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'