Доступно в редакциях:  CE, BE, SE, SE+, EE

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

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

Как явно включить или отключить модуль…

Явно включить или выключить модуль можно одним из следующих способов:

  • С помощью веб-интерфейса Deckhouse. В разделе «Система» → «Управление системой» → «Deckhouse» → «Модули», откройте модуль cloud-provider-aws, включите (или выключите) переключатель «Модуль включен». Сохраните изменения.

    Пример:

    Интерфейс включения и выключения модуля

  • С помощью Deckhouse CLI (d8).

    Используйте команду d8 system module enable для включения модуля, или d8 system module disable для выключения модуля (требуется Deckhouse CLI (d8), настроенный на работу с кластером).

    Пример включения модуля cloud-provider-aws:

    d8 system module enable cloud-provider-aws

  • С помощью ModuleConfig cloud-provider-aws.

    Установите spec.enabled в true или false в ModuleConfig cloud-provider-aws (создайте его, при необходимости).

    Пример манифеста для включения модуля cloud-provider-aws:

    apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
  name: cloud-provider-aws
spec:
  enabled: true

Как настроить модуль…

Настроить модуль можно одним из следующих способов:

  • С помощью веб-интерфейса Deckhouse.

    В разделе «Система» → «Управление системой» → «Deckhouse» → «Модули», откройте модуль cloud-provider-aws, включите переключатель «Дополнительные настройки». Заполните необходимые поля формы на вкладке «Конфигурация», или укажите настройки модуля в формате YAML на вкладке «YAML», не включая секцию settings. Сохраните изменения.

    Пример:

    Интерфейс настройки модуля

    Вы также можете отредактировать объект ModuleConfig cloud-provider-aws на вкладке «YAML» в окне настроек модуля («Система» → «Управление системой» → «Deckhouse» → «Модули», откройте модуль cloud-provider-aws), указав версию схемы в параметре spec.version и необходимые параметры модуля в секции spec.settings.

  • С помощью Deckhouse CLI (d8) (требуется Deckhouse CLI (d8), настроенный на работу с кластером).

    Отредактируйте существующий ModuleConfig cloud-provider-aws (подробнее о настройке Deckhouse читайте в документации), выполнив следующую команду:

    d8 k edit mc cloud-provider-aws

    Внесите необходимые изменения в секцию spec.settings. При необходимости укажите версию схемы в параметре spec.version. Сохраните изменения.

    Вы также можете создать файл манифеста ModuleConfig cloud-provider-aws, используя пример ниже. Заполните секцию spec.settings необходимыми параметрами модуля. При необходимости укажите версию схемы в параметре spec.version.

    Примените манифест с помощью следующей команды (укажите имя файла манифеста):

    d8 k apply -f <FILENAME>

    Пример файла манифеста 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