Rechercher

3.2. À propos de la ressource BareMetalHost

download PDF

Metal3 introduit le concept de ressource BareMetalHost, qui définit un hôte physique et ses propriétés. La ressource BareMetalHost contient deux sections :

  1. La spécification BareMetalHost
  2. Le statut BareMetalHost

3.2.1. La spécification BareMetalHost

La section spec de la ressource BareMetalHost définit l'état souhaité de l'hôte.

Tableau 3.1. Spécification BareMetalHost
ParametersDescription

automatedCleaningMode

Interface permettant d'activer ou de désactiver le nettoyage automatique pendant l'approvisionnement et le déprovisionnement. Si la valeur est disabled, le nettoyage automatique est ignoré. Lorsqu'il est défini sur metadata, le nettoyage automatique est activé. Le paramètre par défaut est metadata.

bmc:
  address:
  credentialsName:
  disableCertificateVerification:

Le paramètre de configuration bmc contient les informations de connexion pour le contrôleur de gestion de carte de base (BMC) sur l'hôte. Les champs sont les suivants :

  • address: L'URL pour communiquer avec le contrôleur BMC de l'hôte.
  • credentialsName: Une référence à un secret contenant le nom d'utilisateur et le mot de passe pour le BMC.
  • disableCertificateVerification: Un booléen qui permet d'ignorer la validation du certificat lorsqu'il est défini sur true.

bootMACAddress

L'adresse MAC de la carte réseau utilisée pour le provisionnement de l'hôte.

bootMode

Le mode de démarrage de l'hôte. Il est défini par défaut sur UEFI, mais il peut également être défini sur legacy pour le démarrage du BIOS, ou sur UEFISecureBoot.

consumerRef

Une référence à une autre ressource qui utilise l'hôte. Elle peut être vide si une autre ressource n'utilise pas actuellement l'hôte. Par exemple, une ressource Machine peut utiliser l'hôte lorsque machine-api utilise l'hôte.

description

Chaîne de caractères fournie par l'homme pour aider à identifier l'hôte.

externallyProvisioned

Un booléen indiquant si le provisionnement et le déprovisionnement de l'hôte sont gérés en externe. Lorsqu'il est défini :

  • L'état de l'alimentation peut toujours être géré à l'aide du champ en ligne.
  • L'inventaire du matériel sera contrôlé, mais aucune opération de provisionnement ou de déprovisionnement n'est effectuée sur l'hôte.

firmware

Contient des informations sur la configuration du BIOS des hôtes bare metal. Actuellement, firmware n'est pris en charge que par les BMC iRMC, iDRAC, iLO4 et iLO5. Les sous-champs sont les suivants

  • simultaneousMultithreadingEnabled: Permet à un seul cœur de processeur physique d'apparaître comme plusieurs processeurs logiques. Les paramètres valides sont true ou false.
  • sriovEnabled: La prise en charge du SR-IOV permet à un hyperviseur de créer des instances virtuelles d'un périphérique PCI-express, ce qui peut améliorer les performances. Les paramètres valides sont true ou false.
  • virtualizationEnabled: Prend en charge la virtualisation du matériel de la plate-forme. Les paramètres valides sont true ou false.
image:
  url:
  checksum:
  checksumType:
  format:

Le paramètre de configuration image contient les détails de l'image à déployer sur l'hôte. Ironic a besoin des champs relatifs à l'image. Toutefois, lorsque le paramètre de configuration externallyProvisioned est défini sur true et que la gestion externe ne nécessite pas de contrôle de l'alimentation, les champs peuvent être vides. Les champs sont les suivants

  • url: L'URL d'une image à déployer sur l'hôte.
  • checksum: La somme de contrôle réelle ou l'URL d'un fichier contenant la somme de contrôle de l'image à l'adresse image.url.
  • checksumType: Vous pouvez spécifier des algorithmes de somme de contrôle. Actuellement, image.checksumType ne prend en charge que md5, sha256 et sha512. Le type de somme de contrôle par défaut est md5.
  • format: Il s'agit du format de disque de l'image. Il peut être l'un des formats suivants : raw, qcow2, vdi, vmdk, live-iso ou ne pas être défini. La valeur raw permet le streaming d'images brutes dans l'agent Ironic pour cette image. La valeur live-iso permet aux images iso de démarrer en direct sans être déployées sur le disque, et ignore les champs checksum.

networkData

Une référence au secret contenant les données de configuration du réseau et son espace de noms, afin qu'il puisse être attaché à l'hôte avant que celui-ci ne démarre pour configurer le réseau.

online

Un booléen indiquant si l'hôte doit être mis sous tension (true) ou hors tension (false). La modification de cette valeur déclenche un changement de l'état d'alimentation de l'hôte physique.

raid:
  hardwareRAIDVolumes:
  softwareRAIDVolumes:

(Facultatif) Contient les informations relatives à la configuration RAID pour les hôtes métalliques nus. Si elle n'est pas spécifiée, elle conserve la configuration actuelle.

Note

OpenShift Container Platform 4.12 prend en charge le RAID matériel pour les BMC utilisant le protocole iRMC uniquement. OpenShift Container Platform 4.12 ne prend pas en charge le RAID logiciel.

Voir les paramètres de configuration suivants :

  • hardwareRAIDVolumes: Contient la liste des lecteurs logiques pour le RAID matériel et définit la configuration de volume souhaitée dans le RAID matériel. Si vous ne spécifiez pas rootDeviceHints, le premier volume est le volume racine. Les sous-champs sont les suivants :

    • level: Le niveau RAID pour le lecteur logique. Les niveaux suivants sont pris en charge : 0,1,2,5,6,1 0,5 0,6 0.
    • name: Le nom du volume sous forme de chaîne de caractères. Il doit être unique au sein du serveur. S'il n'est pas spécifié, le nom du volume sera généré automatiquement.
    • numberOfPhysicalDisks: Le nombre de disques physiques sous forme de nombre entier à utiliser pour le disque logique. La valeur par défaut est le nombre minimum de disques requis pour le niveau RAID en question.
    • physicalDisks: La liste des noms des lecteurs de disques physiques sous forme de chaîne de caractères. Ce champ est facultatif. S'il est spécifié, le champ contrôleur doit l'être également.
    • controller(Facultatif) Le nom du contrôleur RAID sous forme de chaîne à utiliser dans le volume RAID matériel.
    • rotational: S'il est défini sur true, il ne sélectionnera que les lecteurs de disques rotatifs. S'il est défini sur false, il ne sélectionnera que les lecteurs à semi-conducteurs et NVMe. S'il n'est pas défini, il sélectionne tous les types de disques, ce qui est le comportement par défaut.
    • sizeGibibytes: La taille du lecteur logique en tant qu'entier à créer en GiB. Si elle n'est pas spécifiée ou si elle est définie sur 0, la capacité maximale du lecteur physique sera utilisée pour le lecteur logique.
  • softwareRAIDVolumes: OpenShift Container Platform 4.12 ne prend pas en charge le RAID logiciel. Les informations suivantes sont données à titre de référence uniquement. Cette configuration contient la liste des disques logiques pour le RAID logiciel. Si vous ne spécifiez pas rootDeviceHints, le premier volume est le volume racine. Si vous définissez HardwareRAIDVolumes, cet élément sera invalide. Les RAID logiciels sont toujours supprimés. Le nombre de périphériques RAID logiciels créés doit être 1 ou 2. S'il n'y a qu'un seul périphérique RAID logiciel, il doit être RAID-1. S'il y a deux périphériques RAID, le premier doit être RAID-1, tandis que le niveau RAID du deuxième périphérique peut être 0, 1 ou 1 0. Le premier périphérique RAID sera le périphérique de déploiement. Par conséquent, l'application de RAID-1 réduit le risque de non-démarrage d'un nœud en cas de défaillance d'un dispositif. Le champ softwareRAIDVolume définit la configuration souhaitée du volume dans le RAID logiciel. Les sous-champs sont les suivants :

    • level: Le niveau RAID pour le lecteur logique. Les niveaux suivants sont pris en charge : 0,1,1 0.
    • physicalDisks: Une liste de conseils sur les appareils. Le nombre d'éléments doit être supérieur ou égal à 2.
    • sizeGibibytes: La taille de l'unité de disque logique en tant qu'entier à créer en GiB. Si elle n'est pas spécifiée ou si elle est définie à 0, la capacité maximale du lecteur physique sera utilisée pour le lecteur logique.

Vous pouvez définir le site hardwareRAIDVolume comme une tranche vide pour effacer la configuration RAID matérielle. Par exemple :

spec:
   raid:
     hardwareRAIDVolume: []

Si vous recevez un message d'erreur indiquant que le pilote ne prend pas en charge le RAID, attribuez la valeur nil à raid, hardwareRAIDVolumes ou softwareRAIDVolumes. Vous devrez peut-être vous assurer que l'hôte dispose d'un contrôleur RAID.

rootDeviceHints:
  deviceName:
  hctl:
  model:
  vendor:
  serialNumber:
  minSizeGigabytes:
  wwn:
  wwnWithExtension:
  wwnVendorExtension:
  rotational:

Le paramètre rootDeviceHints permet le provisionnement de l'image RHCOS sur un dispositif particulier. Il examine les périphériques dans l'ordre où il les découvre et compare les valeurs découvertes avec les valeurs indicatives. Il utilise le premier périphérique découvert qui correspond à la valeur de l'indice. La configuration peut combiner plusieurs indices, mais un appareil doit correspondre à tous les indices pour être sélectionné. Les champs sont les suivants :

  • deviceName: Une chaîne contenant un nom de périphérique Linux comme /dev/vda. L'indice doit correspondre exactement à la valeur réelle.
  • hctl: Une chaîne contenant une adresse de bus SCSI comme 0:0:0:0. L'indice doit correspondre exactement à la valeur réelle.
  • model: Une chaîne de caractères contenant un identifiant d'appareil spécifique au fournisseur. L'indice peut être une sous-chaîne de la valeur réelle.
  • vendor: Une chaîne contenant le nom du vendeur ou du fabricant de l'appareil. L'indice peut être une sous-chaîne de la valeur réelle.
  • serialNumber: Une chaîne de caractères contenant le numéro de série de l'appareil. L'indice doit correspondre exactement à la valeur réelle.
  • minSizeGigabytes: Un nombre entier représentant la taille minimale du dispositif en gigaoctets.
  • wwn: Une chaîne de caractères contenant l'identifiant unique de stockage. L'indice doit correspondre exactement à la valeur réelle.
  • wwnWithExtension: Une chaîne de caractères contenant l'identifiant unique de stockage avec l'extension du fournisseur en annexe. L'indice doit correspondre exactement à la valeur réelle.
  • wwnVendorExtension: Une chaîne contenant l'identifiant unique de stockage du fournisseur. L'indice doit correspondre exactement à la valeur réelle.
  • rotational: Un booléen indiquant si le dispositif doit être un disque rotatif (true) ou non (false).

3.2.2. L'état de BareMetalHost

L'état BareMetalHost représente l'état actuel de l'hôte et comprend les informations d'identification testées, les détails du matériel actuel et d'autres informations.

Tableau 3.2. Statut de l'hôte BareMetal
ParametersDescription

goodCredentials

Référence au secret et à son espace de noms contenant le dernier jeu d'informations d'identification du contrôleur de gestion de carte de base (BMC) que le système a pu valider comme étant fonctionnel.

errorMessage

Détails de la dernière erreur signalée par le backend de provisionnement, le cas échéant.

errorType

Indique la classe du problème qui a fait entrer l'hôte dans un état d'erreur. Les types d'erreur sont les suivants :

  • provisioned registration error: Se produit lorsque le contrôleur ne parvient pas à réenregistrer un hôte déjà provisionné.
  • registration error: Se produit lorsque le contrôleur ne parvient pas à se connecter au contrôleur de gestion de carte de base de l'hôte.
  • inspection error: Se produit lorsqu'une tentative d'obtenir des informations sur le matériel auprès de l'hôte échoue.
  • preparation error: Se produit lorsque le nettoyage échoue.
  • provisioning error: Se produit lorsque le contrôleur ne parvient pas à approvisionner ou à déprovisionner l'hôte.
  • power management error: Se produit lorsque le contrôleur n'est pas en mesure de modifier l'état d'alimentation de l'hôte.
  • detach error: Se produit lorsque le contrôleur ne parvient pas à détacher l'hôte du provisionneur.
hardware:
  cpu
    arch:
    model:
    clockMegahertz:
    flags:
    count:

Le champ hardware.cpu fournit des détails sur la ou les unités centrales du système. Les champs comprennent :

  • arch: L'architecture de l'unité centrale.
  • model: Le modèle de l'unité centrale sous forme de chaîne de caractères.
  • clockMegahertz: La vitesse en MHz de l'unité centrale.
  • flags: La liste des drapeaux de l'unité centrale. Par exemple, 'mmx','sse','sse2','vmx' etc.
  • count: Le nombre de CPU disponibles dans le système.
hardware:
  firmware:

Contient des informations sur le micrologiciel du BIOS. Par exemple, le fournisseur et la version du matériel.

hardware:
  nics:
  - ip:
    name:
    mac:
    speedGbps:
    vlans:
    vlanId:
    pxe:

Le champ hardware.nics contient une liste des interfaces réseau de l'hôte. Les champs sont les suivants :

  • ip: L'adresse IP du NIC, si elle a été attribuée lors de l'exécution de l'agent de découverte.
  • name: Chaîne de caractères identifiant l'appareil de réseau. Par exemple, nic-1.
  • mac: L'adresse MAC du NIC.
  • speedGbps: Vitesse de l'appareil en Gbps.
  • vlans: Une liste contenant tous les VLAN disponibles pour ce NIC.
  • vlanId: L'ID du VLAN non marqué.
  • pxe: Indique si la carte d'interface réseau est capable de démarrer à l'aide de PXE.
hardware:
  ramMebibytes:

La quantité de mémoire de l'hôte en Mebibytes (MiB).

hardware:
  storage:
  - name:
    rotational:
    sizeBytes:
    serialNumber:

Le champ hardware.storage contient une liste des périphériques de stockage disponibles pour l'hôte. Les champs sont les suivants :

  • name: Chaîne de caractères identifiant le dispositif de stockage. Par exemple, disk 1 (boot).
  • rotational: Indique si le disque est rotatif et renvoie true ou false.
  • sizeBytes: Taille de l'unité de stockage.
  • serialNumber: Le numéro de série de l'appareil.
hardware:
  systemVendor:
    manufacturer:
    productName:
    serialNumber:

Contient des informations sur les sites manufacturer, productName et serialNumber de l'hôte.

lastUpdated

Date de la dernière mise à jour de l'état de l'hôte.

operationalStatus

L'état du serveur. L'état est l'un des suivants :

  • OK: Indique que tous les détails de l'hôte sont connus, qu'il est correctement configuré, qu'il fonctionne et qu'il peut être géré.
  • discovered: Implique que certains détails de l'hôte ne fonctionnent pas correctement ou sont manquants. Par exemple, l'adresse du BMC est connue mais les identifiants de connexion ne le sont pas.
  • error: Indique que le système a trouvé une sorte d'erreur irrécupérable. Pour plus de détails, voir le champ errorMessage dans la section status.
  • delayed: Indique que le provisionnement est retardé pour limiter le provisionnement simultané de plusieurs hôtes.
  • detached: Indique que l'hôte est marqué unmanaged.

poweredOn

Booléen indiquant si l'hôte est sous tension.

provisioning:
  state:
  id:
  image:
  raid:
  firmware:
  rootDeviceHints:

Le champ provisioning contient des valeurs relatives au déploiement d'une image sur l'hôte. Les sous-champs sont les suivants :

  • state: L'état actuel de toute opération de provisionnement en cours. Les états sont les suivants :

    • <empty string>: Il n'y a pas de provisionnement pour le moment.
    • unmanaged: Les informations disponibles sont insuffisantes pour enregistrer l'hôte.
    • registering: L'agent vérifie les détails du BMC de l'hôte.
    • match profile: L'agent compare les détails du matériel découvert sur l'hôte avec les profils connus.
    • available: L'hôte est disponible pour le provisionnement. Cet état était précédemment connu sous le nom de ready.
    • preparing: La configuration existante sera supprimée et la nouvelle configuration sera définie sur l'hôte.
    • provisioning: Le provisionneur écrit une image dans la mémoire de l'hôte.
    • provisioned: Le provisionneur a écrit une image dans la mémoire de l'hôte.
    • externally provisioned: Metal3 ne gère pas l'image sur l'hôte.
    • deprovisioning: Le provisionneur efface l'image du stockage de l'hôte.
    • inspecting: L'agent recueille des informations sur le matériel de l'hôte.
    • deleting: L'agent supprime le de la grappe.
  • id: L'identifiant unique du service dans l'outil de provisionnement sous-jacent.
  • image: L'image la plus récemment fournie à l'hôte.
  • raid: La liste des volumes RAID matériels ou logiciels récemment définis.
  • firmware: La configuration du BIOS pour le serveur bare metal.
  • rootDeviceHints: Les instructions de sélection du périphérique racine utilisées pour l'opération de provisionnement la plus récente.

triedCredentials

Une référence au secret et à son espace de noms contenant le dernier ensemble d'informations d'identification BMC qui ont été envoyées au backend de provisionnement.

Red Hat logoGithubRedditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez leBlog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

© 2024 Red Hat, Inc.