В большинстве случаев нет необходимости в ручной конфигурации модуля. Модуль настраивается автоматически, исходя из выбранной схемы размещения (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

  • settings
    объект
    • settings.storageClass
      объект
      • settings.storageClass.default
        Параметр устарел
        строка

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

        Если значение не указано, фактический StorageClass по умолчанию будет определен следующим образом:

        • присутствующий StorageClass в кластере, имеющий default-аннотацию;
        • первый (по алфавиту) StorageClass из тех, что создаются модулем.

        Параметр устарел. Вместо этого параметра используйте глобальный параметр global.defaultClusterStorageClass

        Пример:

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

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

        Пример:

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

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

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

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

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

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

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

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

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

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

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

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

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

          Тип диска.

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