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

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

Установите spec.enabled в true или false в настройках модуля для его явного включения или выключения.

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

apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
  name: kube-dns
spec:
  enabled: true

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

apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
  name: kube-dns
spec:
  enabled: false

Модуль настраивается с помощью custom resource ModuleConfig с именем kube-dns (подробнее о настройке Deckhouse…).

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

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

Параметры

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

  • clusterDomainAliasesмассив строк

    Список альтернативных доменов кластера, разрешающихся наравне с global.discovery.clusterDomain.

    • Элемент массивастрока

      Шаблон: ^[0-9a-zA-Z\.-]+$

  • enableLogsбулевый

    Включение логирования в CoreDNS.

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

  • hostsмассив объектов

    Необязательный параметр.

    Статический список хостов в стиле /etc/hosts.

    • hosts.domainстрока

      Шаблон: ^[0-9a-zA-Z\.-]+$

    • hosts.ipстрока

      Шаблон: ^[0-9]{1,}\.[0-9]{1,}\.[0-9]{1,}\.[0-9]{1,}$

  • stubZonesмассив объектов

    Список дополнительных зон для обслуживания CoreDNS.

    По умолчанию: []

    Пример:

    stubZones:
- zone: example.com
  upstreamNameservers:
  - 8.8.8.8
  cacheTTLSeconds: 3600
    • stubZones.cacheTTLSecondsцелочисленный

      Максимальный TTL в секундах для успешных запросов.

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

      Допустимые значения: 1 <= X <= 3600

    • stubZones.upstreamNameserversмассив строк

      Обязательный параметр

      Список IP-адресов рекурсивных DNS-серверов, которые CoreDNS будет использовать для разрешения доменов в этой зоне.

      • Элемент массивастрока

        Шаблон: ^[0-9]{1,}\.[0-9]{1,}\.[0-9]{1,}\.[0-9]{1,}(:[0-9]{1,})?$

    • stubZones.zoneстрока

      Обязательный параметр

      Зона CoreDNS.

      Шаблон: ^[0-9a-zA-Z\.-]+$

      Пример:

      zone: consul.local
  • upstreamNameserversмассив строк

    Список IP-адресов рекурсивных DNS-серверов, которые CoreDNS будет использовать для разрешения внешних доменов.

    По умолчанию - список из /etc/resolv.conf.

    • Элемент массивастрока

      Шаблон: ^[0-9]{1,}\.[0-9]{1,}\.[0-9]{1,}\.[0-9]{1,}(:[0-9]{1,})?$