Глобальные настройки

• Обновление из версии 1 в 2:

  Описание конверсии отсутствует.

  Преобразования, выполняемые конверсией (синтаксис jq)...

  • if .storageClass and .modules.storageClass == null then .modules.storageClass = .storageClass end

  • del(.storageClass)

  • del(.modules.resourcesRequests.everyNode)

  • del(.modules.resourcesRequests.masterNode)

  • del(.modules.proxy)

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

• settings

  объект
  • settings.defaultClusterStorageClass

    строка

    Имя StorageClass, который DKP определит как StorageClass используемый в кластере по умолчанию.

    DKP запрещает вручную добавлять или изменять default-аннотацию (storageclass.kubernetes.io/is-default-class='true') у StorageClass. Используйте параметр, чтобы определять или изменять StorageClass используемый в кластере по умолчанию.

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

    • StorageClass в кластере, имеющий default-аннотацию (storageclass.kubernetes.io/is-default-class='true');
    • Первый (по алфавиту) StorageClass из создаваемых модулем облачного провайдера (если какой-либо модуль облачного провайдера используется).

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

  • settings.highAvailability

    булевый

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

    Если значение не указано, оно определяется автоматически как true для кластеров с более чем одним master-узлом. В остальных случаях значение определяется как false.

    Примеры:

    1highAvailability: true
    

    1highAvailability: false
    

  • settings.modules

    объект

    Общие параметры модулей Deckhouse.

    • settings.modules.https

      объект

      Способ реализации протокола HTTPS, используемый модулями Deckhouse.

      Примеры:

      1https:
      2  certManager:
      3    clusterIssuerName: letsencrypt
      4  mode: CertManager
      

      1https:
      2  mode: Disabled
      

      1https:
      2  mode: OnlyInURI
      

      1https:
      2  mode: CustomCertificate
      3  customCertificate:
      4    secretName: plainstring
      

      • settings.modules.https.certManager

        объект
        • settings.modules.https.certManager.clusterIssuerName

          строка

          Имя ClusterIssuer, используемого модулями Deckhouse.

          В модуле cert-manager доступны следующие ClusterIssuer: letsencrypt, letsencrypt-staging, selfsigned, clouddns, cloudflare, digitalocean, route53. Также вы можете использовать свой ClusterIssuer.

          По умолчанию: "letsencrypt"

      • settings.modules.https.customCertificate

        объект
        • settings.modules.https.customCertificate.secretName

          строка

          Имя Secret’а в пространстве имен d8-system, который будет использоваться модулями Deckhouse.

          Указанный Secret должен быть в формате kubernetes.io/tls.

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

      • settings.modules.https.mode

        строка

        Режим работы HTTPS:

        • CertManager — модули Deckhouse будут работать по HTTPS, самостоятельно заказывая сертификат с помощью ClusterIssuer, указанного в параметре certManager.clusterIssuerName;
        • CustomCertificate — модули Deckhouse будут работать по HTTPS, используя сертификат из пространства имен d8-system;
        • Disabled — модули Deckhouse будут работать только по HTTP (некоторые модули могут не работать, например user-authn);
        • OnlyInURI — модули Deckhouse будут работать по HTTP, подразумевая, что перед ними стоит внешний HTTPS-балансировщик, который терминирует HTTPS. Балансировщик должен обеспечивать перенаправление с HTTP на HTTPS.

        По умолчанию: "CertManager"

        Допустимые значения: Disabled, CertManager, CustomCertificate, OnlyInURI

    • settings.modules.ingressClass

      строка

      Имя класса Ingress-контроллера (IngressClass), используемый для модулей Deckhouse.

      Если имя IngressClass задано как nginx, соответствующий Ingress-контроллер автоматически считается Ingress-контроллером, используемым по умолчанию для всех модулей. При использовании любого другого имени Ingress-контроллера, он не будет использоваться по умолчанию.

      По умолчанию: "nginx"

      Шаблон: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$

      Пример:

      1ingressClass: nginx
      

    • settings.modules.placement

      объект

      Настройки, определяющие расположение компонентов модулей Deckhouse по умолчанию.

      • settings.modules.placement.customTolerationKeys

        массив строк

        Список ключей пользовательских toleration.

        Необходимо указывать, чтобы позволить планировщику размещать критически важные компоненты Deckhouse, такие как cni и csi, на выделенных узлах.

        Пример:

        1customTolerationKeys:
        2- dedicated.example.com
        3- node-dedicated.example.com/master
        

    • settings.modules.publicDomainTemplate

      строка

      Шаблон DNS-имен c ключом %s в качестве динамической части строки.

      Модули Deckhouse используют этот шаблон при создании Ingress-ресурсов.

      Например, для шаблона %s.kube.company.my модуль prometheus создаст Ingress-ресурс на адрес grafana.kube.company.my для доступа к Grafana.

      Обратите внимание:

      • Если параметр не указан, Ingress-ресурсы создаваться не будут.
      • Домен, указанный в шаблоне, не может совпадать или быть поддоменом домена, заданного в параметре clusterDomain. Мы не рекомендуем менять значение clusterDomain без особой необходимости.
      • Для корректной работы шаблона необходимо предварительно настроить службы DNS как в сетях, где будут располагаться узлы кластера, так и в сетях, из которых к служебным веб-интерфейсам необходим доступ.
      • В случае, если шаблон совпадает с доменом сети узлов (например, если для узлов заведена зона company.my, а шаблон имеет вид %s.company.my), используйте только А-записи адресов frontend-узлов для назначения веб-интерфейсам платформы..

      Шаблон: ^(%s([-a-z0-9]*[a-z0-9])?|[a-z0-9]([-a-z0-9]*)?%s([-a-z0-9]*)?[a-z0-9]|[a-z0-9]([-a-z0-9]*)?%s)(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$

      Примеры:

      1publicDomainTemplate: "%s.kube.company.my"
      

      1publicDomainTemplate: kube-%s.company.my
      

    • settings.modules.resourcesRequests

      объект

      Количество ресурсов (CPU и памяти), выделяемых для работы компонентов Deckhouse, работающих на каждом узле кластера (обычно это DaemonSet’ы, например cni-flannel, monitoring-ping).

      Подробнее про единицы измерения ресурсов.

      • settings.modules.resourcesRequests.controlPlane

        объект

        Количество ресурсов (CPU и памяти), выделяемых для компонентов control plane, работающих на каждом master-узле кластера. Не работает для not-managed-облаков (например, GKE).

        Пример:

        1controlPlane:
        2  cpu: 1000m
        3  memory: 500M
        

        • settings.modules.resourcesRequests.controlPlane.cpu

          Количество CPU, выделяемых для компонентов control plane, работающих на каждом master-узле кластера.

        • settings.modules.resourcesRequests.controlPlane.memory

          строка

          Объем памяти, выделяемой для компонентов control plane, работающих на каждом master-узле кластера.

          Шаблон: ^[0-9]+(\.[0-9]+)?(E|P|T|G|M|K|Ei|Pi|Ti|Gi|Mi|Ki)?$

    • settings.modules.storageClass

      строка

      Имя StorageClass, который будет использоваться для всех компонентов Deckhouse Kubernetes Platform (Prometheus, Grafana, OpenVPN и т. д.).

      • Если значение не указано, то используется StorageClass по умолчанию, установленный в кластере.
      • Этот параметр имеет смысл использовать только в исключительных ситуациях.
      • Этот параметр применяется в процессе включения модуля.

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

  • settings.storageClass

    Параметр устарел

    строка

    Устарел. Используйте параметр settings.modules.storageClass.

    Имя StorageClass, который будет использоваться для всех компонентов Deckhouse Kubernetes Platform (Prometheus, Grafana, OpenVPN и т. д.).

    • Если значение не указано, то используется StorageClass по умолчанию, установленный в кластере.
    • Этот параметр имеет смысл использовать только в исключительных ситуациях.
    • Этот параметр применяется в процессе включения модуля.

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