YandexClusterConfiguration

Version: deckhouse.io/v1

  • apiVersion (строка)

    Допустимые значения: deckhouse.io/v1, deckhouse.io/v1alpha1

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

  • dhcpOptions (объект)

    Cписок DHCP-опций, которые будут установлены на все подсети.

    Возможные проблемы при использовании.

    • domainName (строка)

      Search-домен.

    • domainNameServers (массив строк)

      Список адресов рекурсивных DNS.

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

  • existingNetworkID (строка)

    ID существующей VPC Network.

  • kind (строка)

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

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

  • labels (объект)

    Лейблы, проставляемые на ресурсы, создаваемые в Yandex.Cloud.

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

  • layout (строка)

    Название схемы размещения.

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

    Допустимые значения: Standard, WithoutNAT, WithNATInstance

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

  • masterNodeGroup (объект)

    Спецификация для описания NodeGroup master-узлов.

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

    • instanceClass (объект)

      Частичное содержимое полей YandexInstanceClass.

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

      • additionalLabels (объект)

        Дополнительные label’ы, которые будут присвоены созданным инстансам.

        Пример:

        project: cms-production
        severity: critical
        
      • coreFraction (целочисленный)

        Базовый уровень производительности каждого ядра CPU у создаваемых инстансов. Подробнее…

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

        Допустимые значения: 0, 5, 20, 50, 100

        Пример: 20

      • cores (целочисленный)

        Количество ядер у создаваемых инстансов.

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

      • diskSizeGB (целочисленный)

        Размер диска (в гигабайтах) у инстансов.

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

        Пример: 20

      • externalIPAddresses (массив строк)

        Список внешних адресов. Количество элементов массива должно соответствовать replicas.

        При отсутствии опции externalSubnetID нужно использовать или зарезервированные публичные IP адреса или константу Auto.

        При наличии опции externalSubnetID необходимо выбрать конкретные свободные IP из указанной подсети.

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

      • externalSubnetID (строка) УСТАРЕЛ!

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

      • externalSubnetIDs (массив строк)

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

        Также будет добавлен маршрут для internal-интерфейса узла на всю подсеть, указанную в nodeNetworkCIDR.

        Количество элементов массива должно соответствовать replicas.

      • imageID (строка)

        Идентификатор образа, который будет установлен в заказанные инстансы.

        Пример: "fd8nb7ecsbvj76dfaa8b"

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

      • memory (целочисленный)

        Количество оперативной памяти (в мегабайтах) у создаваемых инстансов.

        Пример: 8192

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

      • networkType (строка)

        Тип сети.

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

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

      • platform (строка)

        Платформа виртуальной машины. По умолчанию ‘standard-v2’.

    • replicas (целочисленный)

      Сколько master-узлов создавать.

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

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

    • zones (массив)

      Список зон, в которых допустимо создавать узлы.

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

      Допустимые значения элемента массива: ru-central1-a, ru-central1-b, ru-central1-c

  • nodeGroups (массив объектов)

    Массив дополнительных NodeGroup для создания статичных узлов (например, для выделенных frontend-узлов или шлюзов).

    • instanceClass (объект)

      Частичное содержимое полей YandexInstanceClass.

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

      • additionalLabels (объект)

        Дополнительные label’ы, которые будут присвоены созданным инстансам.

        Пример:

        project: cms-production
        severity: critical
        
      • coreFraction (целочисленный)

        Базовый уровень производительности каждого ядра CPU у создаваемых инстансов. Подробнее…

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

        Допустимые значения: 0, 5, 20, 50, 100

        Пример: 20

      • cores (целочисленный)

        Количество ядер у создаваемых инстансов.

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

      • diskSizeGB (целочисленный)

        Размер диска (в гигабайтах) у инстансов.

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

        Пример: 20

      • externalIPAddresses (массив строк)

        Список внешних адресов. Количество элементов массива должно соответствовать replicas.

        При отсутствии опции externalSubnetID нужно использовать или зарезервированные публичные IP адреса или константу Auto.

        При наличии опции externalSubnetID необходимо выбрать конкретные свободные IP из указанной подсети.

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

      • externalSubnetID (строка) УСТАРЕЛ!

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

      • externalSubnetIDs (массив строк)

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

        Также будет добавлен маршрут для internal-интерфейса узла на всю подсеть, указанную в nodeNetworkCIDR.

        Количество элементов массива должно соответствовать replicas.

      • imageID (строка)

        Идентификатор образа, который будет установлен в заказанные инстансы.

        Пример: "fd8nb7ecsbvj76dfaa8b"

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

      • memory (целочисленный)

        Количество оперативной памяти (в мегабайтах) у создаваемых инстансов.

        Пример: 8192

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

      • networkType (строка)

        Тип сети.

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

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

      • platform (строка)

        Платформа виртуальной машины. По умолчанию ‘standard-v2’.

    • name (строка)

      Имя NodeGroup, будет использоваться для генерации имен узлов.

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

    • nodeTemplate

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

      • annotations (объект)

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

        Пример:

        annotations:
          ai.fleet.com/discombobulate: "true"
        
      • labels (объект)

        Список лейблов, которые будут прикреплены ко всем ресурсам кластера (которые это поддерживают).

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

        Если поменять теги в рабочем кластере, то после конвержа необходимо пересоздать все машины, чтобы теги применились.

        Формат — key: value.

        Пример:

        labels:
          environment: production
          app: warp-drive-ai
        
      • taints (массив объектов)

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

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

        Пример:

        taints:
        - effect: NoExecute
          key: ship-class
          value: frigate
        
        • effect (строка)

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

        • key (строка)
        • value (строка)
    • replicas (целочисленный)

      Количество узлов.

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

    • zones (массив)

      Список зон, в которых допустимо создавать узлы.

      Допустимые значения элемента массива: ru-central1-a, ru-central1-b, ru-central1-c

  • nodeNetworkCIDR (строка)

    Данная подсеть будет разделена на три равных части и использована для создания подсетей в трёх зонах Yandex.Cloud.

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

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

  • provider (объект)

    Параметры подключения к API Yandex.Cloud.

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

    • cloudID (строка)

      Идентификатор облака.

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

    • folderID (строка)

      Идентификатор директории.

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

    • serviceAccountJSON (строка)

      JSON, выдаваемый yc iam key create (отформатированный в одну строку).

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

  • sshPublicKey (строка)

    Публичный ключ для доступа на узлы.

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

  • withNATInstance (объект)

    Настройки для схемы размещения WithNATInstance.

    • externalSubnetID (строка)

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

    • internalSubnetID (строка)

      ID подсети для внутреннего интерфейса.

    • natInstanceExternalAddress (строка)

      Внешний зарезервированный IP адрес или адрес из externalSubnetID при указании опции.

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

    • natInstanceInternalAddress (строка) УСТАРЕЛ!

      Лучше не использовать эту опцию, а использовать автоматически назначаемые адреса.

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

  • zones (массив)

    Глобальное ограничение набора зон, с которыми работает данный cloud-provider.

    Допустимые значения элемента массива: ru-central1-a, ru-central1-b, ru-central1-c