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

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

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

Создание узла с Ironic в кластере

В этом примере Ironic работает в кластере со встроенным DHCP-сервером, а на физическом сервере создаётся один CloudEphemeral-узел. Замените адреса, учётные данные, UUID сервера и данные образа на значения своего окружения.

  1. Включите модуль и настройте 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
    
  2. Создайте секрет с учётными данными контроллера управления сервером (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.

  3. Дождитесь, пока сервер перейдёт в состояние available:

    d8 k get baremetalinstances worker-01
    
  4. Создайте ресурс 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
    
  5. Создайте NodeGroup с типом узлов CloudEphemeral:

    apiVersion: deckhouse.io/v1
    kind: NodeGroup
    metadata:
      name: workers
    spec:
      nodeType: CloudEphemeral
      cloudInstances:
        minPerZone: 1
        maxPerZone: 1
        classReference:
          kind: BareMetalInstanceClass
          name: workers
    
  6. Проверьте, что узел появился в кластере:

    d8 k get nodes -l node.deckhouse.io/group=workers
    

    Когда Ironic установит операционную систему и сервер подключится к кластеру, узел появится в выводе команды.

Подключение к внешнему Ironic

В этом примере модуль подключается к Ironic, развёрнутому вне кластера, с аутентификацией по паролю и проверкой сертификата API.

  1. Создайте секрет с учётными данными 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.

  2. Включите модуль и укажите параметры подключения в параметре 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. Пример дополняет настройки из первого примера.

  1. Создайте секрет с сертификатом 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.

  2. Создайте ресурс 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 файлов прошивок в нижнем регистре.

  3. Добавьте в настройки модуля параметры 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
    
  4. Проверьте, что модуль создал Ironic:

    d8 k -n d8-infra-provider-baremetal get ironics.ironic.metal3.io
    

    Если в выводе нет ресурса ironic, проверьте, что все три ресурса из параметров TLS созданы и секрет соответствует требованиям.