AzureClusterConfiguration

Version: deckhouse.io/v1

Пример:

layout: Standard
apiVersion: deckhouse.io/v1
kind: AzureClusterConfiguration
sshPublicKey: ssh-rsa <SSH_PUBLIC_KEY>
vNetCIDR: 10.0.0.0/16
subnetCIDR: 10.0.0.0/24
masterNodeGroup:
  replicas: 1
  instanceClass:
    machineSize: Standard_D4ds_v4
    urn: Canonical:UbuntuServer:18.04-LTS:18.04.202207120
provider:
  location: westeurope
  subscriptionId: "<SUBSCRIPTION_ID>"
  clientId: "<CLIENT_ID>"
  clientSecret: "<CLIENT_SECRET>"
  tenantId: "<TENANT_ID>"
  • apiVersionстрока

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

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

  • kindстрока

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

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

  • layoutстрока

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

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

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

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

  • masterNodeGroup

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

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

    • instanceClassобъект

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

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

      • acceleratedNetworkingбулевый

        Accelerated Networking обеспечивает пропускную способность сети до 30 Гбит/с.

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

      • additionalTagsобъект

        Список дополнительных тегов в формате key: value, которые будут назначены инстансам.

        Пример:

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

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

        Пример:

        diskSizeGb: 40
        
      • diskTypeстрока

        Тип созданного диска.

        Список доступных типов дисков можно посмотреть с помощью Azure CLI:

        az vm list-skus -l westeurope --zone
        

        Пример:

        diskType: StandardSSD_LRS
        
      • enableExternalIPбулевый

        Разрешение назначения внешнего IP-адреса для инстанса.

        Параметр доступен только для layout Standard.

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

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

      • machineSizeстрока

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

        Тип заказываемых инстансов.

        Узнать все доступные типы в регионе можно с помощью Azure CLI:

        az vm list-sizes --location westeurope -o table
        

        Пример:

        machineSize: Standard_F4
        
      • urnстрока

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

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

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

        Получить urn образа c помощью Azure CLI (столбец №4):

        az vm image list --location westeurope --publisher Canonical --all --sku 20_04-lts -o table
        az vm image list --location westeurope --publisher OpenLogic --all --sku 7.5 -o table
        

        По умолчанию: образ из AzureCloudDiscoveryData (образ из которого был создан master при развертывании кластера).

        Внимание! Сейчас поддерживается и тестируется только Ubuntu 18.04, Ubuntu 20.04, Ubuntu 22.04, Centos 7, Centos 8, Centos 9, Debian 9, Debian 10, Debian 11.

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

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

      Количество создаваемых master-узлов.

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

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

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

      Доступные зоны для выбранного типа инстанса можно посмотреть с помощью Azure CLI:

      az vm list-skus -l westeurope -o table
      

      По умолчанию: [1,2,3]

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

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

    • instanceClassобъект

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

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

      • acceleratedNetworkingбулевый

        Accelerated Networking обеспечивает пропускную способность сети до 30 Гбит/с.

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

      • additionalTagsобъект

        Список дополнительных тегов в формате key: value, которые будут назначены инстансам.

        Пример:

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

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

        Пример:

        diskSizeGb: 40
        
      • diskTypeстрока

        Тип созданного диска.

        Список доступных типов дисков можно посмотреть с помощью Azure CLI:

        az vm list-skus -l westeurope --zone
        

        Пример:

        diskType: StandardSSD_LRS
        
      • enableExternalIPбулевый

        Разрешение назначения внешнего IP-адреса для инстанса.

        Параметр доступен только для layout Standard.

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

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

      • machineSizeстрока

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

        Тип заказываемых инстансов.

        Узнать все доступные типы в регионе можно с помощью Azure CLI:

        az vm list-sizes --location westeurope -o table
        

        Пример:

        machineSize: Standard_F4
        
      • urnстрока

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

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

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

        Получить urn образа c помощью Azure CLI (столбец №4):

        az vm image list --location westeurope --publisher Canonical --all --sku 20_04-lts -o table
        az vm image list --location westeurope --publisher OpenLogic --all --sku 7.5 -o table
        

        По умолчанию: образ из AzureCloudDiscoveryData (образ из которого был создан master при развертывании кластера).

        Внимание! Сейчас поддерживается и тестируется только Ubuntu 18.04, Ubuntu 20.04, Ubuntu 22.04, Centos 7, Centos 8, Centos 9, Debian 9, Debian 10, Debian 11.

    • nameстрока

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

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

    • nodeTemplate

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

      • 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, values.

        Пример:

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

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

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

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

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

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

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

      Доступные зоны для выбранного типа инстанса можно посмотреть с помощью Azure CLI:

      az vm list-skus -l westeurope -o table
      

      По умолчанию: [1,2,3]

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

    Массив VNet, с которыми будет объединена сеть кластера.

    Service account должен иметь доступ ко всем перечисленным VNet. Если доступа нет, то пиринговое соединение необходимо настраивать вручную.

    • resourceGroupNameстрока

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

      Имя группы ресурсов, в которой находится VNet.

    • vnetNameстрока

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

      Имя VNet.

  • providerобъект

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

    • clientIdстрока

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

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

    • clientSecretстрока

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

      Secret клиента.

    • locationстрока

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

      Имя географического региона, в котором будут созданы все ресурсы. Получение списка доступных локаций через Azure CLI:

      az account list-locations -o table
      
    • subscriptionIdстрока

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

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

    • tenantIdстрока

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

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

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

    Список CIDR, разрешенных для подключения к узлам по ssh.

    По умолчанию, *.

  • sshPublicKeyстрока

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

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

  • standardобъект

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

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

      Количество IP-адресов для NAT Gateway (тарификация).

      NAT Gateway не используется, если установлено 0.

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

  • subnetCIDRстрока

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

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

    Шаблон: ^(([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]))$

    Пример:

    subnetCIDR: 10.1.2.0/24
    
  • tagsобъект

    Словарь тегов, которые будут созданы на всех ресурсах, имеющих такую возможность.

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

  • vNetCIDRстрока

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

    Адресное пространство виртуальной сети в формате CIDR.

    Шаблон: ^(([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]))$

    Пример:

    vNetCIDR: 10.0.0.0/16
    
  • zonesмассив строк

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