Управление узлами: custom resources

Описывает runtime-параметры группы узлов.

• specобъект

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

  • chaosобъект

    Настройки chaos monkey.

    Пример:

    mode: DrainAndReboot
    period: 24h
    

    • modeстрока

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

      • DrainAndDelete — при срабатывании делает узлу drain, затем - удаляет его;
      • Disabled — не трогает данную NodeGroup.

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

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

    • periodстрока

      В какой интервал времени сработает chaos monkey (указывать можно в golang формате).

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

      Шаблон: ^[0-9]+[mh]{1}$

  • cloudInstancesобъект

    Параметры заказа облачных виртуальных машин.

    Внимание! Допустимо использовать только совместно с nodeType: CloudEphemeral.

    • classReferenceобъект

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

      Ссылка на объект InstanceClass. Уникален для каждого cloud-provider-модуля.

      • kindстрока

        Тип объекта (например, OpenStackInstanceClass). Тип объекта указан в документации соответствующего cloud-provider-модуля.

        Допустимые значения: OpenStackInstanceClass, GCPInstanceClass, VsphereInstanceClass, AWSInstanceClass, YandexInstanceClass, AzureInstanceClass

      • nameстрока

        Имя нужного InstanceClass-объекта (например, finland-medium).

    • maxPerZoneцелочисленный

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

      Максимальное количество инстансов в зоне. Проставляется как верхняя граница в cluster-autoscaler.

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

    • maxSurgePerZoneцелочисленный

      Сколько инстансов создавать одновременно при scale-up.

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

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

    • maxUnavailablePerZoneцелочисленный

      Сколько инстансов может быть недоступно при RollingUpdate’е.

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

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

    • minPerZoneцелочисленный

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

      Минимальное количество инстансов в зоне. Проставляется в объект MachineDeployment и в качестве нижней границы в cluster-autoscaler.

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

    • standbyстрока или число

      Количество подогретых инстансов для этой NodeGroup.

      Значение может быть абсолютным (например, 2) или процентом желаемых узлов (например, 10%). Абсолютное значение рассчитывается из процента от максимального количества узлов путем округления в меньшую сторону, но минимум — 1.

      Шаблон: ^[0-9]+%?$

    • standbyHolderобъект

      Параметры “занимателя” ресурсов для подогретых инстансов.

      • notHeldResourcesобъект

        Ресурсы, которые не будут заняты.

        • cpuстрока или число

          Количество CPU.

          Значение может быть абсолютным (например, 1) или в millicore-формате (например, 1500m).

          Шаблон: ^[0-9]+m?$

        • memoryстрока или число

          Количество памяти.

          Значение может быть абсолютным в байтах (например, 128974848) или в Kubernetes-формате с суффиксами: G, Gi, M, Mi (например, 750Mi).

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

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

      Переопределение перечня зон, в которых создаются инстансы.

      Значение по умолчанию зависит от выбранного облачного провайдера и обычно соответствует всем зонам используемого региона.

      Пример:

      - Helsinki
      - Espoo
      - Tampere
      

  • criобъект

    Параметры container runtime.

    • containerdобъект

      Параметры работы Containerd.

      При настройке этих параметров, cri.type должен быть — Containerd.

      • maxConcurrentDownloadsцелочисленный

        Максимальное количество параллельных потоков загрузки для каждой операции pull.

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

    • dockerобъект

      Параметры настройки Docker.

      • manageбулевый

        Автоматическое управление версией и параметрами Docker.

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

      • maxConcurrentDownloadsцелочисленный

        Максимальное количество потоков одновременного скачивания Docker-образов.

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

    • typeстрока

      Тип сontainer runtime.

      Если не указан, используется значение defaultCRI из первичной конфигурации кластера (параметр cluster-configuration.yaml секрета d8-cluster-configuration в namespace kube-system), которая создается при инсталляции.

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

      Допустимые значения: Docker, Containerd, NotManaged

  • disruptionsобъект

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

    • approvalModeстрока

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

      Режим выдачи разрешения на disruptive-обновление.

      • Manual — отключить автоматическую выдачу разрешений на disruption. Когда disruption потребуется – загорится специальный алерт.
      • Automatic — автоматически выдавать разрешения на disruption при обновлении (значение по умолчанию).

      Допустимые значения: Manual, Automatic

    • automaticобъект

      Дополнительные параметры для режима Automatic.

      • drainBeforeApprovalбулевый

        Выгон (draining) Pod’ов с узла, перед выдачей разрешения на disruption.

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

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

        Список окон disruption-обновлений узлов.

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

          Дни недели, в которые применяется окно обновлений.

          Допустимые значения элемента массива: Mon, Tue, Wed, Thu, Fri, Sat, Sun

        • fromстрока

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

          Шаблон: ^(?:\d|[01]\d|2[0-3]):[0-5]\d$

          Пример:

          from: '13:00'
          

        • toстрока

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

          Время окончания окна обновления (в часовом поясе UTC).

          Шаблон: ^(?:\d|[01]\d|2[0-3]):[0-5]\d$

          Пример:

          to: '18:30'
          

  • kubeletобъект

    Параметры настройки kubelet.

    • maxPodsцелочисленный

      Максимальное количество pod’ов на узлах данной NodeGroup.

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

    • rootDirстрока

      Путь к каталогу для файлов kubelet’а (volume mounts, и т.д.).

      По умолчанию: "/var/lib/kubelet"

  • nodeTemplateобъект

    Настройки Node-объектов в Kubernetes, которые будут добавлены после регистрации узла.

    Пример:

    labels:
      environment: production
      app: warp-drive-ai
    annotations:
      ai.fleet.com/discombobulate: "true"
    taints:
    - effect: NoExecute
      key: ship-class
      value: frigate
    

    • annotationsобъект

      Аналогично стандартному полю metadata.annotations.

      Пример:

      annotations:
        ai.fleet.com/discombobulate: "true"
      

    • labelsобъект

      Аналогично стандартному полю metadata.labels.

      Пример:

      labels:
        environment: production
        app: warp-drive-ai
      

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

      Аналогично полю .spec.taints из объекта Node.

      Внимание! Доступны только поля effect, key, value.

      Пример:

      taints:
      - effect: NoExecute
        key: ship-class
        value: frigate
      

      • effectстрока

        Допустимые значения: NoSchedule, PreferNoSchedule, NoExecute

      • keyстрока
      • valueстрока
  • nodeTypeстрока

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

    Тип узлов, которые представляет эта группа.

    • Cloud — узлы для этой группы будут автоматически создаваться (и удаляться) в настроенном облачном провайдере.
    • Static — статический узел, размещенный на железном сервере или виртуальной машине. Узел не управляется cloud-controller-manager’ом, даже если включен один из облачных провайдеров.
    • Hybrid – статический узел (созданный вручную или любыми внешними инструментами), размещенный в том же облаке, с которым настроена интеграция у одного из облачных провайдеров, на таком узле работает CSI и такой узел управляется cloud-controller-manager’ом (объект Node автоматически обогащается информацией о зоне и регионе по данным, полученным от облака; при удалении узла из облака, соответствующий ему Node-объект будет удален в Kubernetes).

    Допустимые значения: Cloud, Static, Hybrid

  • operatingSystemобъект

    Параметры операционной системы.

    • manageKernelбулевый

      Автоматическое управление ядром операционной системы.

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

Описывает runtime-параметры группы узлов.

• specобъект

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

  • chaosобъект

    Настройки chaos monkey.

    Пример:

    mode: DrainAndReboot
    period: 24h
    

    • modeстрока

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

      • DrainAndDelete — при срабатывании делает узлу drain, затем - удаляет его;
      • Disabled — не трогает данную NodeGroup.

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

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

    • periodстрока

      В какой интервал времени сработает chaos monkey (указывать можно в golang формате).

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

      Шаблон: ^[0-9]+[mh]{1}$

  • cloudInstancesобъект

    Параметры заказа облачных виртуальных машин.

    Внимание! Допустимо использовать только совместно с nodeType: CloudEphemeral.

    • classReferenceобъект

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

      Ссылка на объект InstanceClass. Уникален для каждого cloud-provider-модуля.

      • kindстрока

        Тип объекта (например, OpenStackInstanceClass). Тип объекта указан в документации соответствующего cloud-provider-модуля.

        Допустимые значения: OpenStackInstanceClass, GCPInstanceClass, VsphereInstanceClass, AWSInstanceClass, YandexInstanceClass, AzureInstanceClass

      • nameстрока

        Имя нужного InstanceClass-объекта (например, finland-medium).

    • maxPerZoneцелочисленный

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

      Максимальное количество инстансов в зоне. Проставляется как верхняя граница в cluster-autoscaler.

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

    • maxSurgePerZoneцелочисленный

      Сколько инстансов создавать одновременно при scale-up.

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

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

    • maxUnavailablePerZoneцелочисленный

      Сколько инстансов может быть недоступно при RollingUpdate’е.

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

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

    • minPerZoneцелочисленный

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

      Минимальное количество инстансов в зоне. Проставляется в объект MachineDeployment и в качестве нижней границы в cluster-autoscaler.

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

    • standbyстрока или число

      Количество подогретых инстансов для этой NodeGroup.

      Значение может быть абсолютным (например, 2) или процентом желаемых узлов (например, 10%). Абсолютное значение рассчитывается из процента от максимального количества узлов путем округления в меньшую сторону, но минимум — 1.

      Шаблон: ^[0-9]+%?$

    • standbyHolderобъект

      Параметры “занимателя” ресурсов для подогретых инстансов.

      • notHeldResourcesобъект

        Ресурсы, которые не будут заняты.

        • cpuстрока или число

          Количество CPU.

          Значение может быть абсолютным (например, 1) или в millicore-формате (например, 1500m).

          Шаблон: ^[0-9]+m?$

        • memoryстрока или число

          Количество памяти.

          Значение может быть абсолютным в байтах (например, 128974848) или в Kubernetes-формате с суффиксами: G, Gi, M, Mi (например, 750Mi).

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

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

      Переопределение перечня зон, в которых создаются инстансы.

      Значение по умолчанию зависит от выбранного облачного провайдера и обычно соответствует всем зонам используемого региона.

      Пример:

      - Helsinki
      - Espoo
      - Tampere
      

  • criобъект

    Параметры container runtime.

    • containerdобъект

      Параметры работы Containerd.

      При настройке этих параметров, cri.type должен быть — Containerd.

      • maxConcurrentDownloadsцелочисленный

        Максимальное количество параллельных потоков загрузки для каждой операции pull.

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

    • typeстрока

      Тип сontainer runtime.

      Если не указан, используется значение defaultCRI из первичной конфигурации кластера (параметр cluster-configuration.yaml секрета d8-cluster-configuration в namespace kube-system), которая создается при инсталляции.

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

      Допустимые значения: Docker, Containerd, NotManaged

  • disruptionsобъект

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

    • approvalModeстрока

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

      Режим выдачи разрешения на disruptive-обновление.

      • Manual — отключить автоматическую выдачу разрешений на disruption. Когда disruption потребуется – загорится специальный алерт.
      • Automatic — автоматически выдавать разрешения на disruption при обновлении (значение по умолчанию).

      Допустимые значения: Manual, Automatic

    • automaticобъект

      Дополнительные параметры для режима Automatic.

      • drainBeforeApprovalбулевый

        Выгон (draining) Pod’ов с узла, перед выдачей разрешения на disruption.

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

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

        Список окон disruption-обновлений узлов.

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

          Дни недели, в которые применяется окно обновлений.

          Допустимые значения элемента массива: Mon, Tue, Wed, Thu, Fri, Sat, Sun

        • fromстрока

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

          Шаблон: ^(?:\d|[01]\d|2[0-3]):[0-5]\d$

          Пример:

          from: '13:00'
          

        • toстрока

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

          Время окончания окна обновления (в часовом поясе UTC).

          Шаблон: ^(?:\d|[01]\d|2[0-3]):[0-5]\d$

          Пример:

          to: '18:30'
          

  • dockerобъект

    Параметры настройки Docker.

    При настройке этих параметров, cri.type должен быть — Docker.

    • manageбулевый

      Автоматическое управление версией и параметрами Docker.

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

    • maxConcurrentDownloadsцелочисленный

      Максимальное количество потоков одновременного скачивания Docker-образов.

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

  • kubeletобъект

    Параметры настройки kubelet.

    • maxPodsцелочисленный

      Максимальное количество pod’ов на узлах данной NodeGroup.

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

    • rootDirстрока

      Путь к каталогу для файлов kubelet’а (volume mounts, и т.д.).

      По умолчанию: "/var/lib/kubelet"

  • kubernetesVersionстрока

    Желаемая minor-версия Kubernetes.

    По умолчанию соответствует глобально выбранной для кластера версии (см. документацию по установке) или, если таковая не определена, текущей версии control-plane’а.

    Допустимые значения: 1.14, 1.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.21

    Пример:

    kubernetesVersion: '1.19'
    

  • nodeTemplateобъект

    Настройки Node-объектов в Kubernetes, которые будут добавлены после регистрации узла.

    Пример:

    labels:
      environment: production
      app: warp-drive-ai
    annotations:
      ai.fleet.com/discombobulate: "true"
    taints:
    - effect: NoExecute
      key: ship-class
      value: frigate
    

    • annotationsобъект

      Аналогично стандартному полю metadata.annotations.

      Пример:

      annotations:
        ai.fleet.com/discombobulate: "true"
      

    • labelsобъект

      Аналогично стандартному полю metadata.labels.

      Пример:

      labels:
        environment: production
        app: warp-drive-ai
      

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

      Аналогично полю .spec.taints из объекта Node.

      Внимание! Доступны только поля effect, key, value.

      Пример:

      taints:
      - effect: NoExecute
        key: ship-class
        value: frigate
      

      • effectстрока

        Допустимые значения: NoSchedule, PreferNoSchedule, NoExecute

      • keyстрока
      • valueстрока
  • nodeTypeстрока

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

    Тип узлов, которые представляет эта группа.

    • Cloud — узлы для этой группы будут автоматически создаваться (и удаляться) в настроенном облачном провайдере.
    • Static — статический узел, размещенный на железном сервере или виртуальной машине. Узел не управляется cloud-controller-manager’ом, даже если включен один из облачных провайдеров.
    • Hybrid – статический узел (созданный вручную или любыми внешними инструментами), размещенный в том же облаке, с которым настроена интеграция у одного из облачных провайдеров, на таком узле работает CSI и такой узел управляется cloud-controller-manager’ом (объект Node автоматически обогащается информацией о зоне и регионе по данным, полученным от облака; при удалении узла из облака, соответствующий ему Node-объект будет удален в Kubernetes).

    Допустимые значения: Cloud, Static, Hybrid

  • operatingSystemобъект

    Параметры операционной системы.

    • manageKernelбулевый

      Автоматическое управление ядром операционной системы.

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

  • staticобъект

    Параметры статического узла.

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

      CIDR подсети.