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

Если модуль был выключен и вы его включаете, обратите внимание на глобальный параметр publicDomainTemplate. Укажите его, если он не указан, иначе Ingress-ресурсы для служебных компонентов Deckhouse (dashboard, user-auth, grafana, upmeter и т. п.) создаваться не будут.

Конфигурация Ingress-контроллеров выполняется с помощью Custom Resource IngressNginxController.

В модуле реализовано 10 алертов.

Модуль включен по умолчанию в наборах модулей: Default, Managed. Модуль выключен по умолчанию в наборе модулей Minimal.

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

Чтобы явно включить или выключить модуль ingress-nginx, установите spec.enabled в true или false в ModuleConfig/ingress-nginx (создайте, при необходимости), или воспользуйтесь командой deckhouse-controller module в поде d8-system/deckhouse.

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

  • с помощью ресурса ModuleConfig:

    1apiVersion: deckhouse.io/v1alpha1
2kind: ModuleConfig
3metadata:
4  name: ingress-nginx
5spec:
6  enabled: true

  • с помощью команды deckhouse-controller (требуется kubectl, настроенный на работу с кластером):

    1kubectl -ti -n d8-system exec svc/deckhouse-leader -c deckhouse -- deckhouse-controller module enable ingress-nginx

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

  • с помощью ресурса ModuleConfig:

    1apiVersion: deckhouse.io/v1alpha1
2kind: ModuleConfig
3metadata:
4  name: ingress-nginx
5spec:
6  enabled: false

  • с помощью команды deckhouse-controller (требуется kubectl, настроенный на работу с кластером):

    1kubectl -ti -n d8-system exec svc/deckhouse-leader -c deckhouse -- deckhouse-controller module disable ingress-nginx

Чтобы настроить модуль, используйте ресурс ModuleConfig с именем ingress-nginx (подробнее о настройке Deckhouse…).

Пример ресурса ModuleConfig/ingress-nginx для настройки модуля:

1apiVersion: deckhouse.io/v1alpha1
2kind: ModuleConfig
3metadata:
4  name: ingress-nginx
5spec:
6  version: 1
7  enabled: true
8  settings: # <-- Параметры модуля из раздела "Параметры" ниже.

Параметры

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

  • settings
    объект
    • settings.defaultControllerVersion

      Версия контроллера ingress-nginx, которая будет использоваться для всех контроллеров по умолчанию, если не был задан параметр controllerVersion в IngressNginxController CR.

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

    • settings.highAvailability
      булевый

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

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

      Пример:

      1highAvailability: true