Доступно в редакциях: 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.
Принцип работы
Узел на физическом сервере появляется в кластере в следующем порядке:
- Администратор описывает сервер в ресурсе BareMetalInstance. Модуль подключается к BMC, находит сервер по его UUID и создаёт для него ресурс BareMetalHost проекта Metal3.
- Ironic загружает сервер по сети, собирает сведения об оборудовании и переводит сервер в состояние
available. - Когда группе узлов с инстанс-классом BareMetalInstanceClass нужен новый узел, Cluster API выбирает свободный сервер по лейблам, и Ironic записывает на его диск образ из ресурса BareMetalImage.
- Сервер загружается с установленной операционной системой, выполняет скрипт начальной настройки и подключается к кластеру как узел группы.
- Когда узел удаляется, 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.