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

HuaweiCloudClusterConfiguration

Version: deckhouse.io/v1

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

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

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

d8 system edit provider-cluster-configuration

Пример:

apiVersion: deckhouse.io/v1
kind: HuaweiCloudClusterConfiguration
layout: Standard
sshPublicKey: "<SSH_PUBLIC_KEY>"
zones:
- eu-3a
standard:
  externalNetworkName: external-network
provider:
  domainName: "<DOMAIN_NAME>"
  region: eu-3
  accessKey: "<USERNAME>"
  secretKey: "<PASSWORD>"
masterNodeGroup:
  replicas: 1
  instanceClass:
    flavorName: m1.large
    rootDiskSize: 50
    imageName: debian-11-genericcloud-amd64-20220911-1135
  volumeTypeMap:
    eu-1a: fast-eu-1a
    eu-1b: fast-eu-1b
nodeGroups:
- name: front
  replicas: 2
  instanceClass:
    flavorName: m1.large
    imageName: debian-11-genericcloud-amd64-20220911-1135
    rootDiskSize: 50
  volumeTypeMap:
    eu-1a: fast-eu-1a
    eu-1b: fast-eu-1b
  • apiVersion
    строка

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

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

  • kind
    строка

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

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

  • layout
    строка

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

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

    Возможные схемы размещения провайдера описаны на странице Схемы размещения.

  • masterNodeGroup

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

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

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

    • masterNodeGroup.instanceClass
      объект

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

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

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

        Размер диска для etcd. Значение указывается в гигабайтах.

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

        Пример:

        etcdDiskSizeGb: 10
      • masterNodeGroup.instanceClass.flavorName
        строка

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

        Тип заказываемых виртуальных машин.

      • masterNodeGroup.instanceClass.imageName
        строка

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

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

        Список поддерживаемых Deckhouse ОС и их версий можно найти на странице Поддерживаемые версии Kubernetes и ОС (учитывайте используемую версию Deckhouse).

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

        Размер root-диска. Значение указывается в гигабайтах.

        Параметр также влияет на тип диска.

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

        Пример:

        rootDiskSize: 50
    • masterNodeGroup.replicas
      целочисленный

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

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

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

    • masterNodeGroup.serverGroup
      объект

      ServerGroup объединяет инстансы в группу. Инстансы в такой группе будут размещены на одном гипервизоре (affinity) или на разных гипервизорах (anti-affinity). Это позволяет повысить отказоустойчивость кластера.

      • masterNodeGroup.serverGroup.policy
        строка

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

        Политика распределения инстансов:

        • AntiAffinity — размещает инстансы на разных гипервизорах. Данной политикой управляет Deckhouse.

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

    • masterNodeGroup.volumeTypeMap
      объект

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

      Словарь, сопоставляющий зонам доступности типы дисков для worker-узлов группы.

      Формат записи: <ЗОНА ДОСТУПНОСТИ>: <ТИП ДИСКА> (см. пример).

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

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

      Если свойство volumeTypeMap не задано для группы узлов, для этой группы в качестве значения по умолчанию используется volumeTypeMap из masterNodeGroup.

      Если значение replicas превышает число записей в словаре, назначение типов выполняется по кругу (с начала словаря). Например, при replicas: 5 для группы front и словаре, где первым указан fast-eu-1a, а вторым — fast-eu-1b, узлы front-0, front-2, front-4 получат fast-eu-1a, а front-1 и front-3 — fast-eu-1b.

      Пример:

      volumeTypeMap:
  eu-1a: fast-eu-1a
  eu-1b: fast-eu-1b
  • nodeGroups
    массив объектов

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

    • nodeGroups.instanceClass
      объект

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

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

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

        Размер диска для etcd. Значение указывается в гигабайтах.

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

        Пример:

        etcdDiskSizeGb: 10
      • nodeGroups.instanceClass.flavorName
        строка

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

        Тип заказываемых виртуальных машин.

      • nodeGroups.instanceClass.imageName
        строка

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

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

        Список поддерживаемых Deckhouse ОС и их версий можно найти на странице Поддерживаемые версии Kubernetes и ОС (учитывайте используемую версию Deckhouse).

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

        Размер root-диска. Значение указывается в гигабайтах.

        Параметр также влияет на тип диска.

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

        Пример:

        rootDiskSize: 50
    • nodeGroups.name
      строка

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

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

    • nodeGroups.nodeTemplate

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

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

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

        Пример:

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

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

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

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

        Пример:

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

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

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

        Пример:

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

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

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

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

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

    • nodeGroups.volumeTypeMap
      объект

      Словарь типов дисков для рабочих узлов группы.

      Формат элементов словаря: <ЗОНА ДОСТУПНОСТИ>: <ТИП ДИСКА> (см. пример).

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

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

      Если свойство volumeTypeMap не указано для группы узлов, будет использовано значение volumeTypeMap из masterNodeGroup в качестве запасного варианта для этой группы узлов.

      Если значение, указанное в replicas, превышает количество элементов в словаре, узлы, чьи номера превышают длину словаря, получают значения, начиная с начала словаря. Если для словаря из примера для группы front указано replicas: 5, с типом диска fast-eu-1a будут front-0, front-2 и front-4, а с типом диска fast-eu-1b будут front-1 и front-3.

      Пример:

      volumeTypeMap:
  eu-1a: fast-eu-1a
  eu-1b: fast-eu-1b
  • provider
    объект

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

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

    • provider.accessKey
      строка

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

      Ключ доступа к облаку Huawei Cloud.

    • provider.authURL
      строка

      URL-адрес аутентификации личности.

    • provider.cloud
      строка

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

      Конечная точка поставщика облачных услуг.

    • provider.domainName
      строка

      Имя учетной записи IAM для охвата.

    • provider.enterpriseProjectID
      строка

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

    • provider.insecure
      булевый

      Доверять самоподписанным SSL-сертификатам.

    • provider.projectID
      строка

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

    • provider.region
      строка

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

      Регион Huawei Cloud, в котором будет развернут кластер.

    • provider.secretKey
      строка

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

      Секретный ключ облака Huawei Cloud.

  • sshPublicKey
    строка

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

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

  • standard
    объект

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

    • standard.enableEIP
      булевый

      Включите Elastic IP для мастер узлов.

      Шаблон: ^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])(\/(3[0-2]|[1-2][0-9]|[0-9]))$

    • standard.internalNetworkCIDR
      строка

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

      Адресация для внутренней сети узлов кластера.

      Шаблон: ^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])(\/(3[0-2]|[1-2][0-9]|[0-9]))$

    • standard.internalNetworkDNSServers
      массив строк

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

      • Элемент массива
        строка

        Шаблон: ^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$

    • standard.internalNetworkSecurity
      булевый

      Флаг, который определяет необходимость настройки SecurityGroups на портах внутренней сети.

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

  • vpcPeering
    объект

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

    • vpcPeering.internalNetworkCIDR
      строка

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

      Адресация для внутренней сети узлов кластера.

      Шаблон: ^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])(\/(3[0-2]|[1-2][0-9]|[0-9]))$

    • vpcPeering.internalNetworkDNSServers
      массив строк

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

      • Элемент массива
        строка

        Шаблон: ^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$

    • vpcPeering.internalNetworkSecurity
      булевый

      Флаг, который определяет необходимость настройки SecurityGroups на портах внутренней сети.

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

    • vpcPeering.subnet
      строка

      Имя подсети в сети VPC.

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

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

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