Доступно в редакциях: Ultimate/EE
Стадия жизненного цикла модуля: Experimental
У модуля есть требования для установки
Перед включением модуля необходимо разрешить использование экспериментальных модулей в ModuleConfig deckhouse. Для этого установите параметр allowExperimentalModules в true.
Модуль выключен по умолчанию. Чтобы включить его, создайте ModuleConfig infra-provider-baremetal и задайте в нём параметр nodes.parameters.ironic. Пока параметр не задан, компоненты модуля не запускаются.
Выбор режима работы Ironic и порядок настройки описаны на странице «Использование».
Модуль не включен по умолчанию в каком-либо наборе модулей.
Требования
К версии Deckhouse: 1.68.0 и выше.
Параметры
Версия схемы: 1
- объектsettings
- объектsettings.nodes
Настройки создания узлов кластера на физических серверах.
- объектsettings.nodes.parameters
Обязательный параметр
Параметры создания узлов кластера на физических серверах.
- объектsettings.nodes.parameters.ironic
Обязательный параметр
Настройки сервиса Ironic, с помощью которого модуль управляет серверами и устанавливает на них операционную систему.
Чтобы подключиться к Ironic, развёрнутому вне кластера, задайте параметр
externalInstance. Чтобы развернуть Ironic в кластере, задайте параметрыprovisioningNetworkиdhcp.- целочисленныйsettings.nodes.parameters.ironic.bmcProbeTimeoutSeconds
Тайм-аут одной проверки протокола при подключении к контроллеру управления сервером (BMC), в секундах.
По умолчанию:
15Допустимые значения:
1 <= X <= 300 - объектsettings.nodes.parameters.ironic.dhcp
- объектsettings.nodes.parameters.ironic.dhcp.external
Параметры внешнего DHCP-сервера в сети подготовки серверов.
Модуль не разворачивает DHCP-сервер и не настраивает внешний. Настройте загрузку серверов по PXE на внешнем DHCP-сервере самостоятельно.
- объектsettings.nodes.parameters.ironic.dhcp.external.pxeBootFile
Имена загрузочных файлов, заданные на внешнем DHCP-сервере.
- строкаsettings.nodes.parameters.ironic.dhcp.external.pxeBootFile.bios
Имя загрузочного файла для серверов в режиме legacy BIOS.
Длина:
1..1024 - строкаsettings.nodes.parameters.ironic.dhcp.external.pxeBootFile.uefi
Имя загрузочного файла для серверов в режиме UEFI.
Длина:
1..1024
- строкаsettings.nodes.parameters.ironic.dhcp.external.pxeBootServer
Обязательный параметр
IPv4-адрес PXE-сервера, который внешний DHCP-сервер передаёт серверам.
- объектsettings.nodes.parameters.ironic.dhcp.internal
Параметры встроенного DHCP-сервера, который Ironic запускает в сети подготовки серверов.
- булевыйsettings.nodes.parameters.ironic.dhcp.internal.disableDNS
Отключает встроенный DNS-сервер и передачу адреса DNS-сервера через DHCP.
По умолчанию DHCP передаёт
dnsAddress, если он задан. Иначе Ironic предоставляет DNS и пересылает запросы с помощью резолвера своего pod.Задайте
trueдля изолированной сети подготовки серверов, в которой DNS не требуется.При значении
trueнельзя использовать вместе с параметромdnsAddress.По умолчанию:
false - строкаsettings.nodes.parameters.ironic.dhcp.internal.dnsAddress
Адрес DNS-сервера, который DHCP-сервер передаёт серверам.
Нельзя использовать, если параметр
disableDNSимеет значениеtrue. - строкаsettings.nodes.parameters.ironic.dhcp.internal.gatewayAddress
Адрес шлюза по умолчанию, который DHCP-сервер передаёт серверам.
- строкаsettings.nodes.parameters.ironic.dhcp.internal.networkCIDR
Обязательный параметр
Подсеть сети подготовки серверов в формате CIDR.
- строкаsettings.nodes.parameters.ironic.dhcp.internal.rangeBegin
Обязательный параметр
Первый IPv4-адрес диапазона, из которого DHCP-сервер выдаёт адреса серверам.
- строкаsettings.nodes.parameters.ironic.dhcp.internal.rangeEnd
Обязательный параметр
Последний IPv4-адрес диапазона, из которого DHCP-сервер выдаёт адреса серверам.
- объектsettings.nodes.parameters.ironic.externalInstance
Параметры подключения к Ironic, развёрнутому вне кластера.
Если параметр задан, модуль не разворачивает Ironic и DHCP-сервер. Нельзя использовать вместе с параметрами
provisioningNetwork,dhcp,ramdiskImageRef,ipxeFirmwareRefиprovisioningTLS.- объектsettings.nodes.parameters.ironic.externalInstance.credentialsRef
Ссылка на секрет с учётными данными API внешнего Ironic.
Секрет должен содержать ключ
identityс именем пользователя и ключsecretс паролем.- строкаsettings.nodes.parameters.ironic.externalInstance.credentialsRef.kind
Обязательный параметр
Тип ресурса с учётными данными API внешнего Ironic.
Допустимые значения:
Secret - строкаsettings.nodes.parameters.ironic.externalInstance.credentialsRef.name
Обязательный параметр
Имя секрета с учётными данными API внешнего Ironic.
Длина:
1..253 - строкаsettings.nodes.parameters.ironic.externalInstance.credentialsRef.namespace
Обязательный параметр
Неймспейс секрета с учётными данными API внешнего Ironic.
Поддерживается только неймспейс
d8-infra-provider-baremetal.Шаблон:
^d8-infra-provider-baremetal$
- строкаsettings.nodes.parameters.ironic.externalInstance.endpoint
Обязательный параметр
URL-адрес API внешнего Ironic.
URL-адрес должен заканчиваться на
/v1или/v1/и быть доступен из кластера.Шаблон:
^https?://.+/v1/?$Максимальная длина:
2048 - объектsettings.nodes.parameters.ironic.externalInstance.tls
Параметры TLS для подключения к внешнему Ironic.
- объектsettings.nodes.parameters.ironic.externalInstance.tls.caCertRef
Ссылка на ключ секрета с сертификатом CA, которым выпущен сертификат API внешнего Ironic.
- строкаsettings.nodes.parameters.ironic.externalInstance.tls.caCertRef.key
Обязательный параметр
Ключ секрета, в котором хранится сертификат CA внешнего Ironic.
Длина:
1..253 - строкаsettings.nodes.parameters.ironic.externalInstance.tls.caCertRef.kind
Обязательный параметр
Тип ресурса с сертификатом CA внешнего Ironic.
Допустимые значения:
Secret - строкаsettings.nodes.parameters.ironic.externalInstance.tls.caCertRef.name
Обязательный параметр
Имя секрета с сертификатом CA внешнего Ironic.
Длина:
1..253 - строкаsettings.nodes.parameters.ironic.externalInstance.tls.caCertRef.namespace
Обязательный параметр
Неймспейс секрета с сертификатом CA внешнего Ironic.
Поддерживается только неймспейс
d8-infra-provider-baremetal.Шаблон:
^d8-infra-provider-baremetal$
- объектsettings.nodes.parameters.ironic.externalInstance.tls.clientCertRef
Ссылка на секрет с клиентским сертификатом и закрытым ключом для взаимной TLS-аутентификации.
- строкаsettings.nodes.parameters.ironic.externalInstance.tls.clientCertRef.certKey
Обязательный параметр
Ключ секрета, в котором хранится клиентский сертификат.
Длина:
1..253 - строкаsettings.nodes.parameters.ironic.externalInstance.tls.clientCertRef.kind
Обязательный параметр
Тип ресурса с клиентским сертификатом.
Допустимые значения:
Secret - строкаsettings.nodes.parameters.ironic.externalInstance.tls.clientCertRef.name
Обязательный параметр
Имя секрета с клиентским сертификатом и закрытым ключом.
Длина:
1..253 - строкаsettings.nodes.parameters.ironic.externalInstance.tls.clientCertRef.namespace
Обязательный параметр
Неймспейс секрета с клиентским сертификатом и закрытым ключом.
Поддерживается только неймспейс
d8-infra-provider-baremetal.Шаблон:
^d8-infra-provider-baremetal$ - строкаsettings.nodes.parameters.ironic.externalInstance.tls.clientCertRef.privateKey
Обязательный параметр
Ключ секрета, в котором хранится закрытый ключ клиента.
Длина:
1..253
- булевыйsettings.nodes.parameters.ironic.externalInstance.tls.insecure
Отключает проверку сертификата API внешнего Ironic.
Не используйте в production-окружении.
По умолчанию:
false
- объектsettings.nodes.parameters.ironic.ipxeFirmwareRef
Ссылка на ресурс BareMetalIPXEFirmware с прошивками iPXE для загрузки серверов по TLS.
Используется только вместе с параметром
provisioningTLS. Если параметр задан безprovisioningTLS, модуль не создаёт Ironic.- строкаsettings.nodes.parameters.ironic.ipxeFirmwareRef.kind
Обязательный параметр
Тип ресурса с прошивками iPXE.
Допустимые значения:
BareMetalIPXEFirmware - строкаsettings.nodes.parameters.ironic.ipxeFirmwareRef.name
Обязательный параметр
Имя ресурса BareMetalIPXEFirmware.
Длина:
1..253
- объектsettings.nodes.parameters.ironic.provisioningNetwork
Параметры сети подготовки серверов, в которой серверы загружаются по PXE.
Используется, только если модуль разворачивает Ironic в кластере.
- строкаsettings.nodes.parameters.ironic.provisioningNetwork.interface
Обязательный параметр
Имя сетевого интерфейса, подключённого к сети подготовки серверов, на узле, где запущен Ironic.
Шаблон:
^[A-Za-z0-9_.:-]{1,15}$ - строкаsettings.nodes.parameters.ironic.provisioningNetwork.ipAddress
Обязательный параметр
Свободный IPv4-адрес в сети подготовки серверов.
Ironic назначает этот адрес интерфейсу из параметра
interfaceи принимает на нём подключения серверов.
- объектsettings.nodes.parameters.ironic.provisioningTLS
Включает TLS для API Ironic и для загрузки файлов серверами.
Поддерживается только со встроенным DHCP-сервером (
dhcp.internal). Требует параметровramdiskImageRefиipxeFirmwareRef. Модуль создаёт Ironic, только когда секрет и ресурсы из этих параметров готовы.- объектsettings.nodes.parameters.ironic.provisioningTLS.certificateRef
Обязательный параметр
Ссылка на секрет с TLS-сертификатом Ironic в неймспейсе
d8-infra-provider-baremetal.Секрет должен иметь тип
kubernetes.io/tls, содержать ключиtls.crt,tls.keyиca.crtи иметь лейблenvironment.metal3.io/ironic-standalone-operator: "true".- строкаsettings.nodes.parameters.ironic.provisioningTLS.certificateRef.name
Обязательный параметр
Имя секрета с TLS-сертификатом Ironic.
Длина:
1..253
- объектsettings.nodes.parameters.ironic.ramdiskImageRef
Ссылка на ресурс BareMetalRamdiskImage с образом Ironic Python Agent (IPA) для загрузки серверов.
Если параметр не задан, используется встроенный образ IPA. Параметр обязателен, если задан параметр
provisioningTLS.- строкаsettings.nodes.parameters.ironic.ramdiskImageRef.kind
Обязательный параметр
Тип ресурса с образом IPA.
Допустимые значения:
BareMetalRamdiskImage - строкаsettings.nodes.parameters.ironic.ramdiskImageRef.name
Обязательный параметр
Имя ресурса BareMetalRamdiskImage.
Длина:
1..253

