Экспериментальная версия. Функциональность может сильно измениться. Совместимость с будущими версиями не гарантируется.

Если control plane кластера размещен на виртуальных машинах или bare-metal-серверах, cloud-провайдер использует настройки модуля cloud-provider-zvirt в конфигурации Deckhouse. Иначе, если control plane кластера размещен в облаке, cloud-провайдер использует структуру ZvirtClusterConfiguration для настройки.

ZvirtClusterConfiguration

Version: deckhouse.io/v1

Описывает конфигурацию облачного кластера в Zvirt.

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

Выполните следующую команду, чтобы изменить конфигурацию в работающем кластере:

1kubectl -n d8-system exec -ti svc/deckhouse-leader -c deckhouse -- deckhouse-controller edit provider-cluster-configuration

После изменения параметров узлов необходимо выполнить команду dhctl converge, чтобы изменения вступили в силу.

Пример:

1apiVersion: deckhouse.io/v1
2kind: ZvirtClusterConfiguration
3layout: Standard
4clusterID: b46372e7-0d52-40c7-9bbf-fda31e187088
5masterNodeGroup:
6  replicas: 1
7  instanceClass:
8    numCPUs: 4
9    memory: 8192
10    template: debian-bookworm
11    vnicProfileID: 49bb4594-0cd4-4eb7-8288-8594eafd5a86
12    storageDomainID: c4bf82a5-b803-40c3-9f6c-b9398378f424
13nodeGroups:
14- name: worker
15  replicas: 1
16  instanceClass:
17    numCPUs: 4
18    memory: 8192
19    template: debian-bookworm
20    vnicProfileID: 49bb4594-0cd4-4eb7-8288-8594eafd5a86
21provider:
22  server: "<SERVER>"
23  username: "<USERNAME>"
24  password: "<PASSWORD>"
25  insecure: true
  • apiVersion
    строка

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

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

  • clusterID
    строка

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

    ID кластера с общими доменами хранения и ЦП одного типа для создания виртуальны машин.

    Шаблон: ^[\da-fA-F]{8}\-[\da-fA-F]{4}\-4[\da-fA-F]{3}\-[\da-fA-F]{4}\-[\da-fA-F]{12}$

    Пример:

    1clusterID: 49bb4594-0cd4-4eb7-8288-8594eafd5a86
  • kind
    строка

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

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

  • layout
    строка

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

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

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

  • masterNodeGroup
    объект

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

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

    Чтобы изменения вступили в силу, после изменения параметров секции masterNodeGroup выполните команду dhctl converge.

    • masterNodeGroup.instanceClass
      объект

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

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

      • masterNodeGroup.instanceClass.etcdDiskSizeGb
        целочисленный

        Etcd disk size in GiB.

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

        Пример:

        1etcdDiskSizeGb: 10
      • masterNodeGroup.instanceClass.memory
        целочисленный

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

        Память в MiB для выделения виртуальным машинам.

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

        Пример:

        1memory: 8192
      • masterNodeGroup.instanceClass.numCPUs
        целочисленный

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

        Количество vCPU, выделяемых виртуальным машинам.

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

        Пример:

        1numCPUs: 2
      • masterNodeGroup.instanceClass.rootDiskSizeGb
        целочисленный

        Root disk size in GiB to use in zVirt VirtualMachines.

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

        Пример:

        1rootDiskSizeGb: 50
      • masterNodeGroup.instanceClass.storageDomainID
        строка

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

        ID домена хранения.

        Шаблон: ^[\da-fA-F]{8}\-[\da-fA-F]{4}\-4[\da-fA-F]{3}\-[\da-fA-F]{4}\-[\da-fA-F]{12}$

        Пример:

        1storageDomainID: 49bb4594-0cd4-4eb7-8288-8594eafd5a86
      • masterNodeGroup.instanceClass.template
        строка

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

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

        Пример:

        1template: debian-bookworm
      • masterNodeGroup.instanceClass.vnicProfileID
        строка

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

        ID профиля vNIC.

        Шаблон: ^[\da-fA-F]{8}\-[\da-fA-F]{4}\-4[\da-fA-F]{3}\-[\da-fA-F]{4}\-[\da-fA-F]{12}$

        Пример:

        1vnicProfileID: 49bb4594-0cd4-4eb7-8288-8594eafd5a86
    • masterNodeGroup.replicas
      целочисленный

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

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

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

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

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

    • nodeGroups.instanceClass
      объект

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

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

      • nodeGroups.instanceClass.etcdDiskSizeGb
        целочисленный

        Etcd disk size in GiB.

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

        Пример:

        1etcdDiskSizeGb: 10
      • nodeGroups.instanceClass.memory
        целочисленный

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

        Память в MiB для выделения виртуальным машинам.

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

        Пример:

        1memory: 8192
      • nodeGroups.instanceClass.numCPUs
        целочисленный

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

        Количество vCPU, выделяемых виртуальным машинам.

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

        Пример:

        1numCPUs: 2
      • nodeGroups.instanceClass.rootDiskSizeGb
        целочисленный

        Root disk size in GiB to use in zVirt VirtualMachines.

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

        Пример:

        1rootDiskSizeGb: 50
      • nodeGroups.instanceClass.storageDomainID
        строка

        ID домена хранения.

        Шаблон: ^[\da-fA-F]{8}\-[\da-fA-F]{4}\-4[\da-fA-F]{3}\-[\da-fA-F]{4}\-[\da-fA-F]{12}$

        Пример:

        1storageDomainID: 49bb4594-0cd4-4eb7-8288-8594eafd5a86
      • nodeGroups.instanceClass.template
        строка

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

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

        Пример:

        1template: debian-bookworm
      • nodeGroups.instanceClass.vnicProfileID
        строка

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

        ID профиля vNIC.

        Шаблон: ^[\da-fA-F]{8}\-[\da-fA-F]{4}\-4[\da-fA-F]{3}\-[\da-fA-F]{4}\-[\da-fA-F]{12}$

        Пример:

        1vnicProfileID: 49bb4594-0cd4-4eb7-8288-8594eafd5a86
    • nodeGroups.name
      строка

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

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

    • nodeGroups.nodeTemplate

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

      • nodeGroups.nodeTemplate.annotations
        объект

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

        Пример:

        1annotations:
2  ai.fleet.com/discombobulate: 'true'
      • nodeGroups.nodeTemplate.labels
        объект

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

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

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

        Пример:

        1labels:
2  environment: production
3  app: warp-drive-ai
      • nodeGroups.nodeTemplate.taints
        массив объектов

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

        Доступны только поля effect, key, values.

        Пример:

        1taints:
2- effect: NoExecute
3  key: ship-class
4  value: frigate
        • nodeGroups.nodeTemplate.taints.effect
          строка

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

        • nodeGroups.nodeTemplate.taints.key
          строка
        • nodeGroups.nodeTemplate.taints.value
          строка
    • nodeGroups.replicas
      целочисленный

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

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

  • provider
    объект

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

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

    • provider.caBundle
      строка

      CA сертификат закодированный base64.

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

    • provider.insecure
      булевый

      Установите значение true, если Zvirt имеет самоподписанный сертификат.

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

    • provider.password
      строка

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

      Пароль.

    • provider.server
      строка

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

      Хост или IP-адрес zvirt сервера.

    • provider.username
      строка

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

      Логин.

  • sshPublicKey
    строка

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

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