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

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

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

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

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

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

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

    Пример:

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

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

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

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

    d8 system module enable chrony
    
  • С помощью ModuleConfig chrony.

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

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

    apiVersion: deckhouse.io/v1alpha1
    kind: ModuleConfig
    metadata:
      name: chrony
    spec:
      enabled: true
    

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

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

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

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

    Пример:

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

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

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

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

    d8 k edit mc chrony
    

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

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

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

    d8 k apply -f <FILENAME>
    

    Пример файла манифеста ModuleConfig chrony:

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

Параметры

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

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

      Синхронизация времени на master-узлах при загрузке, до запуска kubelet.

      Не даёт статическим подам control plane запуститься с неверным временем, полученным от аппаратных часов (RTC) или гипервизора. Включение и изменение настроек применяются при следующей загрузке узла. Отключение действует сразу после применения конфигурации.

      • settings.earlyTimeSync.enabled
        булевый

        Включает синхронизацию времени при загрузке, до запуска kubelet.

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

      • settings.earlyTimeSync.timeoutSeconds
        целочисленный

        Максимальное время ожидания синхронизации перед запуском kubelet, в секундах.

        На узлах под управлением bashible отсчёт начинается, когда сеть узла становится доступной. Если за это время ни один NTP-сервер не ответил или ответившие серверы расходятся, kubelet запускается с непроверенным временем. На узлах Deckhouse Engine параметр не действует: там ожидание не больше 30 секунд.

        Если master-узел, на котором уже настроена ранняя синхронизация, не может связаться с NTP-серверами, проверка ждёт до таймаута. Такое возможно в изолированном кластере с сервером по умолчанию pool.ntp.org. Укажите доступные серверы в параметре ntpServers или отключите синхронизацию времени при загрузке.

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

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

    • settings.ntpServers
      массив строк

      Список NTP-серверов для синхронизации времени.

      Каждый сервер задаётся именем хоста или IPv4-адресом, без порта.

      На master-узлах эти серверы также используются для синхронизации времени при загрузке, до запуска kubelet. На узлах Deckhouse Engine при загрузке используются первые 16 из них. Синхронизация времени при загрузке настраивается параметром earlyTimeSync. Пустой список отключает синхронизацию времени при загрузке.

      По умолчанию: ["pool.ntp.org"]

      Примеры:

      ntpServers:
      - pool.ntp.org
      
      ntpServers:
      - pool.ntp.org
      - ntp.ubuntu.com
      - time.google.com
      

Пример конфигурации

apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
  name: chrony
spec:
  enabled: true
  settings:
    ntpServers:
      - pool.ntp.org
      - ntp.ubuntu.com
      - time.google.com
  version: 1