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

Стадия жизненного цикла модуля: General Availability

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

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

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

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

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

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

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

    Пример:

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

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

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

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

    d8 system module enable ingress-nginx

  • С помощью ModuleConfig ingress-nginx.

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

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

    apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
  name: ingress-nginx
spec:
  enabled: true

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

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

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

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

    Пример:

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

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

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

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

    d8 k edit mc ingress-nginx

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

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

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

    d8 k apply -f <FILENAME>

    Пример файла манифеста ModuleConfig ingress-nginx:

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

Параметры

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

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

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

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

    • settings.highAvailability
      булевый

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

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

      Пример:

      highAvailability: true
    • settings.storageClass
      строка

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

      Если значение не указано, используется StorageClass существующей PVC. Если PVC ещё нет, будет использован StorageClass согласно настройке глобального параметра storageClass.

      Глобальный параметр storageClass учитывается только при включении модуля. Изменение параметра при включённом модуле не приводит к автоматическому перезаказу диска.

      При значении false будет использоваться emptyDir.

      Примеры:

      storageClass: ceph-ssd

      storageClass: 'false'