В большинстве случаев нет необходимости в ручной конфигурации модуля. Модуль настраивается автоматически, исходя из выбранной схемы размещения (custom resource AWSClusterConfiguration).

Количество и параметры процесса заказа машин в облаке настраиваются в custom resource NodeGroup модуля node-manager, в котором также указывается название используемого для этой группы узлов инстанс-класса (параметр cloudInstances.classReference NodeGroup). Инстанс-класс для cloud-провайдера AWS — это custom resource AWSInstanceClass, в котором указываются конкретные параметры самих машин.

Модуль автоматически создает StorageClasses, которые есть в AWS: gp3, gp2, sc1 и st1, позволяет сконфигурировать диски с необходимым IOPS, а также отфильтровать ненужные StorageClass, указав их в параметре exclude.

Чтобы настроить модуль, используйте custom resource ModuleConfig с именем cloud-provider-aws (подробнее о настройке Deckhouse…).

Пример ресурса ModuleConfig/cloud-provider-aws для настройки модуля:

apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
  name: cloud-provider-aws
spec:
  version: 1
  enabled: true
  settings: # <-- Параметры модуля из раздела "Параметры" ниже.

Параметры

Версия схемы: 1

  • storageClassобъект
    • storageClass.defaultстрока

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

      • Если не задан, фактическим StorageClass по умолчанию будет:
        • присутствующий в кластере произвольный StorageClass с default-аннотацией;
        • лексикографически первый StorageClass из создаваемых модулем.

      Пример:

      default: gp3
    • storageClass.excludeмассив строк

      Полные имена (или regex выражения имен) StorageClass, которые не будут созданы в кластере.

      Пример:

      exclude:
- sc.*
- st1
    • storageClass.provisionмассив объектов

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

      • storageClass.provision.iopsстрока

        I/O операций в секунду для дисков типа gp3:

        • Допустимые значения: от 3000 до 16000.
        • Если не задан, будет использоваться значение 3000 согласно документации.
        • Изменение этого параметра не приводит к изменению аналогичных параметров для уже созданных дисков. Их необходимо править вручную через консоль управления AWS.
      • storageClass.provision.iopsPerGBстрока

        I/O операций в секунду на каждый Гб для дисков типа io1 или io2 (у дисков gp2 этот параметр 3):

        • Внимание! Если это значение, умноженное на размер запрошенного диска, будет меньше 100 или больше 64000, создание такого диска завершится ошибкой.
        • Подробное описание типов дисков и их IOPS вы найдете в официальной документации.
      • storageClass.provision.nameстрока

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

        Имя будущего класса.

      • storageClass.provision.throughputстрока

        Пропускная способность в MiB/s для дисков типа gp3:

        • Допустимые значения: от 125 до 1000.
        • Если не задан, будет использоваться значение 125 согласно документации.
        • Изменение этого параметра не приводит к изменению аналогичных параметров для уже созданных дисков. Их необходимо править вручную через консоль управления AWS.
      • storageClass.provision.typeстрока

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

        Тип диска.

        Допустимые значения: gp3, gp2, sc1, st1, io1, io2