Стадия жизненного цикла модуля: Experimental
У модуля есть требования для установки
Перед включением модуля необходимо разрешить использование экспериментальных модулей в ModuleConfig deckhouse. Для этого установите параметр allowExperimentalModules в true.
Создание узла с Ironic в кластере
В этом примере Ironic работает в кластере со встроенным DHCP-сервером, а на физическом сервере создаётся один CloudEphemeral-узел. Замените адреса, учётные данные, UUID сервера и данные образа на значения своего окружения.
-
Включите модуль и настройте Ironic:
apiVersion: deckhouse.io/v1alpha1 kind: ModuleConfig metadata: name: infra-provider-baremetal spec: enabled: true version: 1 settings: nodes: parameters: ironic: provisioningNetwork: interface: enp7s0 ipAddress: 192.168.223.85 dhcp: internal: networkCIDR: 192.168.223.0/24 rangeBegin: 192.168.223.160 rangeEnd: 192.168.223.171 gatewayAddress: 192.168.223.254 dnsAddress: 192.168.223.1 -
Создайте секрет с учётными данными контроллера управления сервером (BMC) и ресурс BareMetalInstance, который описывает сервер:
apiVersion: v1 kind: Secret metadata: name: worker-01-bmc namespace: d8-infra-provider-baremetal type: cloud-provider.deckhouse.io/credentials stringData: authScheme: userPassword identity: <BMC_USER> secret: <BMC_PASSWORD> --- apiVersion: deckhouse.io/v1 kind: BareMetalInstance metadata: name: worker-01 labels: pool: workers spec: bootMACAddress: "f0:3f:03:01:1d:22" bmc: ipAddress: 192.168.201.32 systemUUID: "00583f1d-2903-e203-0010-d21de0c7571b" credentialsRef: namespace: d8-infra-provider-baremetal kind: Secret name: worker-01-bmcЗамените
<BMC_USER>и<BMC_PASSWORD>на имя пользователя и пароль BMC. Инстанс-класс на четвёртом шаге выбирает сервер по лейблуpool: workers. -
Дождитесь, пока сервер перейдёт в состояние
available:d8 k get baremetalinstances worker-01 -
Создайте ресурс BareMetalImage с образом операционной системы и ресурс BareMetalInstanceClass с параметрами узлов:
apiVersion: deckhouse.io/v1 kind: BareMetalImage metadata: name: ubuntu-24-04-amd64 spec: direct: url: http://images.example.com/ubuntu-24.04-amd64.qcow2 checksum: 6695ad25a7a930accfd1e004f151578c4152338191eb7598fd89745ab93d3160 checksumType: sha256 format: qcow2 --- apiVersion: deckhouse.io/v1 kind: BareMetalInstanceClass metadata: name: workers spec: imageRef: kind: BareMetalImage name: ubuntu-24-04-amd64 hostSelector: matchLabels: pool: workers capacity: cpu: "4" memory: 8Gi -
Создайте NodeGroup с типом узлов
CloudEphemeral:apiVersion: deckhouse.io/v1 kind: NodeGroup metadata: name: workers spec: nodeType: CloudEphemeral cloudInstances: minPerZone: 1 maxPerZone: 1 classReference: kind: BareMetalInstanceClass name: workers -
Проверьте, что узел появился в кластере:
d8 k get nodes -l node.deckhouse.io/group=workersКогда Ironic установит операционную систему и сервер подключится к кластеру, узел появится в выводе команды.
Подключение к внешнему Ironic
В этом примере модуль подключается к Ironic, развёрнутому вне кластера, с аутентификацией по паролю и проверкой сертификата API.
-
Создайте секрет с учётными данными API Ironic и секрет с сертификатом CA:
d8 k -n d8-infra-provider-baremetal create secret generic ironic-credentials \ --from-literal=identity=<IRONIC_USER> \ --from-literal=secret=<IRONIC_PASSWORD> d8 k -n d8-infra-provider-baremetal create secret generic ironic-ca \ --from-file=ca.crt=<CA_FILE>Замените
<IRONIC_USER>и<IRONIC_PASSWORD>на имя пользователя и пароль API Ironic, а<CA_FILE>на путь к файлу с сертификатом CA, которым подписан сертификат API. -
Включите модуль и укажите параметры подключения в параметре
externalInstance:apiVersion: deckhouse.io/v1alpha1 kind: ModuleConfig metadata: name: infra-provider-baremetal spec: enabled: true version: 1 settings: nodes: parameters: ironic: externalInstance: endpoint: https://ironic.example.com:6385/v1/ credentialsRef: kind: Secret name: ironic-credentials namespace: d8-infra-provider-baremetal tls: caCertRef: kind: Secret name: ironic-ca namespace: d8-infra-provider-baremetal key: ca.crt
Серверы и узлы в этом режиме создаются так же, как в предыдущем примере, начиная со второго шага.
Включение TLS для загрузки серверов
В этом примере модуль защищает трафик загрузки серверов с помощью TLS. Пример дополняет настройки из первого примера.
-
Создайте секрет с сертификатом Ironic и добавьте на него лейбл:
d8 k -n d8-infra-provider-baremetal create secret generic ironic-tls \ --type=kubernetes.io/tls \ --from-file=tls.crt=<CERT_FILE> \ --from-file=tls.key=<KEY_FILE> \ --from-file=ca.crt=<CA_FILE> d8 k -n d8-infra-provider-baremetal label secret ironic-tls \ environment.metal3.io/ironic-standalone-operator=trueЗамените
<CERT_FILE>и<KEY_FILE>на пути к сертификату Ironic и его закрытому ключу, а<CA_FILE>на путь к сертификату CA, которым выпущен сертификат Ironic. -
Создайте ресурс BareMetalRamdiskImage с образом Ironic Python Agent (IPA) и ресурс BareMetalIPXEFirmware с прошивками iPXE:
apiVersion: deckhouse.io/v1 kind: BareMetalRamdiskImage metadata: name: ipa-tls spec: direct: kernelURL: https://images.example.com/ipa/ironic-python-agent.kernel initramfsURL: https://images.example.com/ipa/ironic-python-agent.initramfs --- apiVersion: deckhouse.io/v1 kind: BareMetalIPXEFirmware metadata: name: ipxe-tls spec: direct: bios: url: https://images.example.com/ipxe/undionly.kpxe sha256: <BIOS_FIRMWARE_SHA256> uefiX86_64: url: https://images.example.com/ipxe/snponly.efi sha256: <UEFI_FIRMWARE_SHA256>Замените
<BIOS_FIRMWARE_SHA256>и<UEFI_FIRMWARE_SHA256>на контрольные суммы SHA-256 файлов прошивок в нижнем регистре. -
Добавьте в настройки модуля параметры
provisioningTLS,ramdiskImageRefиipxeFirmwareRef:apiVersion: deckhouse.io/v1alpha1 kind: ModuleConfig metadata: name: infra-provider-baremetal spec: enabled: true version: 1 settings: nodes: parameters: ironic: provisioningNetwork: interface: enp7s0 ipAddress: 192.168.223.85 dhcp: internal: networkCIDR: 192.168.223.0/24 rangeBegin: 192.168.223.160 rangeEnd: 192.168.223.171 provisioningTLS: certificateRef: name: ironic-tls ramdiskImageRef: kind: BareMetalRamdiskImage name: ipa-tls ipxeFirmwareRef: kind: BareMetalIPXEFirmware name: ipxe-tls -
Проверьте, что модуль создал Ironic:
d8 k -n d8-infra-provider-baremetal get ironics.ironic.metal3.ioЕсли в выводе нет ресурса
ironic, проверьте, что все три ресурса из параметров TLS созданы и секрет соответствует требованиям.