Deckhouse Platform устанавливает CRD, но не удаляет их при отключении модуля. Если вам больше не нужны созданные CRD, удалите их.

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

У модуля есть требования для установки

Перед включением модуля необходимо разрешить использование экспериментальных модулей в ModuleConfig deckhouse. Для этого установите параметр allowExperimentalModules в true.

BareMetalImage

Scope: Cluster
Version: v1

  • metadata
    объект
  • spec
    объект

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

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

    • spec.direct
      объект

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

      Источник образа и данные для проверки его целостности.

      Нельзя изменить после создания. Чтобы обновить образ операционной системы, создайте BareMetalImage с новым именем и измените imageRef в BareMetalInstanceClass.

      • spec.direct.checksum
        строка

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

        Контрольная сумма образа в шестнадцатеричном формате.

        Длина должна соответствовать алгоритму в параметре checksumType.

        Шаблон: ^[a-fA-F0-9]+$

        Длина: 1..128

      • spec.direct.checksumType
        строка

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

        Алгоритм контрольной суммы.

        Допустимые значения: md5, sha256, sha512

      • spec.direct.format
        строка

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

        Формат образа диска.

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

      • spec.direct.url
        строка

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

        URL-адрес образа.

        Образ должен быть доступен по этому URL-адресу для Ironic и для серверов во время установки операционной системы.

        Шаблон: ^https?://

        Максимальная длина: 2048

BareMetalInstance

Short names: bmi

Scope: Cluster
Version: v1

  • metadata
    объект
  • spec
    объект

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

    Кластерный ресурс физического сервера и параметры доступа к его контроллеру управления (BMC).

    • spec.bmc
      объект

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

      Параметры подключения к BMC сервера.

      • spec.bmc.allowHTTP
        булевый

        Разрешает подключаться к BMC по Redfish через HTTP, если подключиться по HTTPS не удалось.

        В этом случае учётные данные BMC передаются в открытом виде. Нельзя использовать вместе с параметром tls.caCertRef.

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

      • spec.bmc.credentialsRef
        объект

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

        Ссылка на секрет с учётными данными BMC. Если namespace не указан, секрет читается из неймспейса d8-infra-provider-baremetal.

        Секрет должен иметь тип cloud-provider.deckhouse.io/credentials и содержать следующие ключи:

        • authScheme со значением userPassword;
        • identity с именем пользователя BMC;
        • secret с паролем пользователя BMC.
        • spec.bmc.credentialsRef.kind
          строка

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

          Тип ресурса с учётными данными BMC.

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

        • spec.bmc.credentialsRef.name
          строка

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

          Имя секрета с учётными данными BMC.

          Длина: 1..253

        • spec.bmc.credentialsRef.namespace
          строка

          Неймспейс секрета с учётными данными BMC.

          Шаблон: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$

          Длина: 1..63

      • spec.bmc.insecure
        булевый

        Отключает проверку сертификата BMC.

        Нельзя использовать вместе с параметром tls.caCertRef.

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

      • spec.bmc.ipAddress
        строка

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

        IPv4-адрес BMC.

      • spec.bmc.port
        целочисленный

        Порт BMC.

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

        • 443 для Redfish по HTTPS;
        • 80 для Redfish по HTTP, если включён параметр allowHTTP;
        • 623 для IPMI.

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

      • spec.bmc.systemUUID
        строка

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

        UUID сервера, который сообщает его BMC.

        При подключении по Redfish модуль сравнивает это значение с UUID системы, который возвращает BMC, а при подключении по IPMI с идентификатором системы (System GUID).

      • spec.bmc.tls
        объект

        Параметры проверки сертификата BMC при подключении по Redfish.

        • spec.bmc.tls.caCertRef
          объект

          Ссылка на ключ секрета с сертификатом CA в формате PEM, которым выпущен сертификат BMC.

          Секрет должен находиться в неймспейсе d8-infra-provider-baremetal.

          Поддерживается, только если Ironic работает в кластере. Если модуль подключён к внешнему Ironic, в статусе ресурса появляется ошибка, и модуль не создаёт для него BareMetalHost.

          • spec.bmc.tls.caCertRef.key
            строка

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

            Ключ секрета, в котором хранится сертификат CA для BMC в формате PEM.

            Длина: 1..253

          • spec.bmc.tls.caCertRef.kind
            строка

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

            Тип ресурса с сертификатом CA для BMC.

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

          • spec.bmc.tls.caCertRef.name
            строка

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

            Имя секрета с сертификатом CA для BMC.

            Длина: 1..253

    • spec.bootMACAddress
      строка

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

      MAC-адрес сетевого интерфейса сервера, через который он загружается по PXE.

      Шаблон: ^([0-9a-fA-F]{2}:){5}[0-9a-fA-F]{2}$

    • spec.online
      булевый

      Желаемое состояние питания сервера.

      Применяется при создании физического хоста и при изменении параметра, если сервер не используется для узла.

      Пока сервер используется для узла, питанием управляет CAPM3; изменения этого параметра игнорируются. После удаления узла модуль сохраняет заданное CAPM3 состояние питания до явного изменения параметра.

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

    • spec.rootDeviceHints
      объект

      Признаки системного диска сервера.

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

      • spec.rootDeviceHints.deviceName
        строка

        Имя диска в Linux, например /dev/vda, или путь к диску в директории /dev/disk/by-path/.

        Подходит только диск с точно таким же значением.

        Максимальная длина: 256

      • spec.rootDeviceHints.hctl
        строка

        Адрес диска на шине SCSI, например 0:0:0:0.

        Подходит только диск с точно таким же адресом.

        Максимальная длина: 256

      • spec.rootDeviceHints.minSizeGigabytes
        целочисленный

        Минимальный размер диска в гигабайтах.

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

      • spec.rootDeviceHints.model
        строка

        Модель диска.

        Подходит диск, в названии модели которого есть указанная строка. Например, значение 860 EVO подходит для модели Samsung SSD 860 EVO 500GB.

        Максимальная длина: 256

      • spec.rootDeviceHints.rotational
        булевый

        Тип диска.

        Если true, выбирается жёсткий диск (HDD). Если false, выбирается твердотельный накопитель, например SSD или NVMe.

      • spec.rootDeviceHints.serialNumber
        строка

        Серийный номер диска.

        Подходит только диск с точно таким же серийным номером.

        Максимальная длина: 256

      • spec.rootDeviceHints.vendor
        строка

        Производитель диска.

        Подходит диск, в названии производителя которого есть указанная строка. Например, значение Samsung подходит для производителя Samsung Electronics.

        Максимальная длина: 256

      • spec.rootDeviceHints.wwn
        строка

        Идентификатор диска World Wide Name (WWN).

        Подходит только диск с точно таким же WWN.

        Максимальная длина: 256

      • spec.rootDeviceHints.wwnVendorExtension
        строка

        Расширение производителя для WWN диска.

        Подходит только диск с точно таким же значением.

        Максимальная длина: 256

      • spec.rootDeviceHints.wwnWithExtension
        строка

        WWN диска вместе с расширением производителя.

        Подходит только диск с точно таким же значением.

        Максимальная длина: 256

  • status
    объект

    Текущее состояние сервера и результат обработки ресурса модулем.

    • status.conditions
      массив объектов

      Условия, которые описывают состояние ресурса.

      При каждой обработке ресурса модуль выставляет условие BMCResolved. Условие принимает значение True, если модуль подключился к BMC, нашёл сервер с UUID из параметра spec.bmc.systemUUID и создал или обновил для него ресурс BareMetalHost.

      Если модулю не удалось выполнить один из этих шагов, условие принимает значение False. Шаг указан в поле reason, а пояснение ошибки приведено в поле message.

      • status.conditions.lastTransitionTime
        строка

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

        Время последнего изменения значения или причины условия.

      • status.conditions.message
        строка

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

        Пояснение к значению условия.

        Если условие имеет значение True, сообщение пустое. Основные сообщения для значения False описаны в разделе «Проверка состояния серверов».

      • status.conditions.observedGeneration
        целочисленный

        Поколение ресурса (metadata.generation), для которого выставлено условие.

      • status.conditions.reason
        строка

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

        Код причины, по которой условие имеет текущее значение.

        Если условие имеет значение True, причина равна BMCResolved. Если условие имеет значение False, причина указывает шаг, который модулю не удалось выполнить, например CredentialsInvalid или BMCResolutionFailed.

      • status.conditions.status
        строка

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

        Значение условия.

        Принимает значение True или False.

        Допустимые значения: True, False, Unknown

      • status.conditions.type
        строка

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

        Тип условия.

    • status.host
      объект

      Состояние сервера по данным ресурса BareMetalHost с тем же именем в неймспейсе d8-cloud-instance-manager.

      Поле заполнено, только если последняя обработка ресурса прошла успешно.

      • status.host.desiredOnline
        булевый

        Желаемое состояние питания сервера.

      • status.host.error
        строка

        Сообщение об ошибке, если операция с сервером не удалась.

        Подробное описание ошибки приведено в поле status.errorMessage ресурса BareMetalHost с тем же именем.

      • status.host.poweredOn
        булевый

        Фактическое состояние питания сервера.

      • status.host.state
        строка

        Текущее состояние сервера по данным ресурса BareMetalHost, например available или provisioned.

    • status.message
      строка

      Сообщение об ошибке, если модулю не удалось обработать ресурс.

    • status.observedGeneration
      целочисленный

      Поколение ресурса (metadata.generation), которое модуль обработал последним.

BareMetalInstanceClass

Scope: Cluster
Version: v1

  • metadata
    объект
  • spec
    объект

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

    Параметры CloudEphemeral-узлов, которые создаются на физических серверах.

    • spec.capacity
      объект

      Ресурсы узла, которые cluster autoscaler учитывает при масштабировании группы с нуля.

      • spec.capacity.cpu
        строка или число

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

        Процессорные ресурсы узла, доступные для рабочей нагрузки.

        Шаблон: ^[0-9]+m?$

        Пример:

        cpu: 4000m
        
      • spec.capacity.memory
        строка или число

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

        Объём памяти узла, доступный для рабочей нагрузки.

        Шаблон: ^[0-9]+(\.[0-9]+)?(E|P|T|G|M|k|Ei|Pi|Ti|Gi|Mi|Ki)?$

        Пример:

        memory: 8Gi
        
    • spec.disableAutomatedCleaning
      булевый

      Отключает автоматическую очистку дисков на серверах, которые используются для узлов группы.

      По умолчанию Ironic очищает метаданные дисков.

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

    • spec.hostSelector
      объект

      Селектор, который выбирает серверы по лейблам ресурсов BareMetalInstance.

      Если параметр не задан, узлы создаются на любых свободных серверах.

      • spec.hostSelector.matchExpressions
        массив объектов

        Выбирает серверы с помощью выражений селектора лейблов Kubernetes.

        • spec.hostSelector.matchExpressions.key
          строка

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

          Ключ лейбла.

          Максимальная длина: 253

        • spec.hostSelector.matchExpressions.operator
          строка

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

          Оператор сравнения значения лейбла со значениями из параметра values.

          Допустимые значения: In, NotIn, Exists, DoesNotExist

        • spec.hostSelector.matchExpressions.values
          массив строк

          Значения лейбла для операторов In и NotIn.

          Не указывайте для операторов Exists и DoesNotExist.

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

            Максимальная длина: 63

      • spec.hostSelector.matchLabels
        объект

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

    • spec.imageRef
      объект

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

      Ссылка на ресурс BareMetalImage с образом операционной системы для узлов.

      • spec.imageRef.kind
        строка

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

        Тип ресурса с образом операционной системы.

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

      • spec.imageRef.name
        строка

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

        Имя ресурса BareMetalImage.

        Длина: 1..253

    • spec.nodeReuse
      булевый

      Разрешает использовать те же серверы при обновлении узлов группы.

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

  • status
    объект
    • status.nodeGroupConsumers
      массив строк

      Группы узлов, которые используют этот инстанс-класс.

BareMetalIPXEFirmware

Scope: Cluster
Version: v1

  • metadata
    объект
  • spec
    объект

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

    Прошивки iPXE для загрузки серверов, если для Ironic в кластере включён TLS.

    • spec.direct
      объект

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

      Файлы прошивок и их контрольные суммы SHA-256 для поддерживаемых режимов загрузки.

      • spec.direct.bios
        объект

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

        Прошивка iPXE для загрузки в режиме legacy BIOS.

        • spec.direct.bios.sha256
          строка

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

          Контрольная сумма SHA-256 прошивки iPXE для BIOS.

          Шаблон: ^[a-f0-9]{64}$

        • spec.direct.bios.url
          строка

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

          URL-адрес прошивки iPXE для BIOS.

          Поддерживается только HTTPS.

          Шаблон: ^https://

          Максимальная длина: 2048

      • spec.direct.uefiArm64
        объект

        Прошивка iPXE для загрузки в режиме UEFI на ARM64.

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

        • spec.direct.uefiArm64.sha256
          строка

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

          Контрольная сумма SHA-256 прошивки iPXE для UEFI на ARM64.

          Шаблон: ^[a-f0-9]{64}$

        • spec.direct.uefiArm64.url
          строка

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

          URL-адрес прошивки iPXE для UEFI на ARM64.

          Поддерживается только HTTPS.

          Шаблон: ^https://

          Максимальная длина: 2048

      • spec.direct.uefiX86_64
        объект

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

        Прошивка iPXE для загрузки в режиме UEFI на x86_64.

        • spec.direct.uefiX86_64.sha256
          строка

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

          Контрольная сумма SHA-256 прошивки iPXE для UEFI на x86_64.

          Шаблон: ^[a-f0-9]{64}$

        • spec.direct.uefiX86_64.url
          строка

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

          URL-адрес прошивки iPXE для UEFI на x86_64.

          Поддерживается только HTTPS.

          Шаблон: ^https://

          Максимальная длина: 2048

BareMetalRamdiskImage

Scope: Cluster
Version: v1

  • metadata
    объект
  • spec
    объект

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

    Образ Ironic Python Agent (IPA), с которого загружаются серверы, пока Ironic собирает сведения об оборудовании и устанавливает операционную систему.

    • spec.direct
      объект

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

      URL-адреса ядра и initramfs образа IPA.

      • spec.direct.architecture
        строка

        Архитектура процессора, для которой собран образ.

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

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

      • spec.direct.initramfsURL
        строка

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

        URL-адрес initramfs IPA.

        Файл должен быть доступен по этому URL-адресу для Ironic и для серверов.

        Шаблон: ^https?://

        Максимальная длина: 2048

      • spec.direct.kernelURL
        строка

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

        URL-адрес ядра IPA.

        Файл должен быть доступен по этому URL-адресу для Ironic и для серверов.

        Шаблон: ^https?://

        Максимальная длина: 2048