Доступно в редакциях:  Ultimate/EE

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

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

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

Модуль infra-provider-baremetal позволяет node-manager создавать CloudEphemeral-узлы на физических серверах. Он управляет серверами через их контроллеры управления (BMC), устанавливает на них операционную систему по сети и подключает их к кластеру. В основе модуля лежат компоненты проекта Metal3 и сервис Ironic.

Основные возможности

Модуль позволяет выполнять следующие задачи:

  • регистрировать физические серверы по адресу и учётным данным BMC с автоматическим выбором протокола Redfish или IPMI;
  • создавать и удалять узлы в группах узлов с типом CloudEphemeral, в том числе масштабировать группы с нуля с помощью cluster autoscaler;
  • устанавливать на серверы образ операционной системы и очищать метаданные дисков при освобождении сервера;
  • разворачивать Ironic в кластере или подключаться к существующему Ironic;
  • защищать трафик загрузки серверов с помощью TLS.

Принцип работы

Узел на физическом сервере появляется в кластере в следующем порядке:

  1. Администратор описывает сервер в ресурсе BareMetalInstance. Модуль подключается к BMC, находит сервер по его UUID и создаёт для него ресурс BareMetalHost проекта Metal3.
  2. Ironic загружает сервер по сети, собирает сведения об оборудовании и переводит сервер в состояние available.
  3. Когда группе узлов с инстанс-классом BareMetalInstanceClass нужен новый узел, Cluster API выбирает свободный сервер по лейблам, и Ironic записывает на его диск образ из ресурса BareMetalImage.
  4. Сервер загружается с установленной операционной системой, выполняет скрипт начальной настройки и подключается к кластеру как узел группы.
  5. Когда узел удаляется, Ironic по умолчанию очищает метаданные дисков сервера, и сервер снова становится доступен для создания узлов.

Требования

Для работы модуля необходимо следующее:

  • статический кластер, в котором не включены модули облачных провайдеров cloud-provider-*;
  • серверы, BMC которых поддерживает протокол Redfish или IPMI и доступен по сети из кластера;
  • сеть подготовки серверов, в которой серверы загружаются по PXE, и подключённые к ней узлы кластера, на которых может запуститься Ironic, если он работает в кластере;
  • образ операционной системы с cloud-init и python3, в котором cloud-init сам настраивает сетевые интерфейсы, например по DHCP;
  • модуль хранилища, CSI-драйвер которого запускается на создаваемых узлах.

Модуль хранилища нужен, потому что Deckhouse Platform не размещает рабочую нагрузку на новом узле, пока на нём не зарегистрируется CSI-драйвер.

Ограничения

Модуль работает со следующими ограничениями:

  • группы узлов используют одну зону default;
  • сертификат CA для BMC в параметре spec.bmc.tls.caCertRef можно задать, только если Ironic работает в кластере;
  • TLS для загрузки серверов доступен, только если Ironic работает в кластере и использует встроенный DHCP-сервер.

Внешние компоненты

Список стороннего программного обеспечения, используемого в модуле infra-provider-baremetal (информация представлена на английском языке):

  • Cluster API Provider Metal3 v1.9.5

    License: Apache License 2.0

    Infrastructure provider for Kubernetes Cluster API backed by Metal3.

  • Metal3 Bare Metal Operator v0.13.1

    License: Apache License 2.0

    Kubernetes operator for provisioning bare metal hosts with Ironic.

  • Ironic Standalone Operator v0.10.0

    License: Apache License 2.0

    Kubernetes operator managing standalone Ironic deployments for Metal3.

  • Metal3 Ironic Image v39.0.0

    License: Apache License 2.0

    Container image to run OpenStack Ironic as part of Metal3.

  • OpenStack Ironic 752100ac7ff8774510a34963839aaed93bbe8589

    License: Apache License 2.0

    Bare metal provisioning service.

  • OpenStack Ironic Python package 39.0.0

    License: Apache License 2.0

    Python distribution version of the pinned Ironic source commit.

  • Ironic Python Agent ramdisk ipa-centos9-stable-2026.1

    License: Apache License 2.0

    Default IPA deployment kernel and initramfs.

  • pip 25.3

    License: MIT

    Python package installer used during the Ironic build.

  • setuptools 84.2.1

    License: MIT

    Python packaging tools used during the Ironic build.

  • wheel 0.38.4

    License: MIT

    Python wheel builder used during the Ironic build.

  • pbr 7.1.3

    License: Apache License 2.0

    OpenStack Python build backend used for Ironic.

  • Python wheels 0.19

    License: MIT

    Python dependency wheels supplied by the Deckhouse package manager.

  • RPM rpm-4.20.1-release

    License: GPL-2.0-or-later

    Upstream rpm2cpio script used to extract signed EFI boot loaders during the Ironic build.