Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Fournisseurs et machines créées

Cette page décrit les fournisseurs de machines et les machines que l’installeur crée chez eux (installeur 0.7.0) : prérequis, champs de openiam.yaml, contrôles, étiquettes, délais, fichiers et limites. La marche à suivre est dans le guide Créer les machines depuis l’installeur.

Types de fournisseur

Type (type)Libellé à l’écranÉtat
xen_orchestraXen OrchestraLivré : XCP-ng piloté par Xen Orchestra (API REST et JSON-RPC)
xapiXCP-ng (XAPI directe)Grisé à l’écran, refusé à l’import : « … n’est pas encore pris en charge (plan M8, tranche 14). »

Niveau de vérification

État au 2026-11-16, après la recette contre un vrai Xen Orchestra : XOA, API REST 0.40.2, pool XCP-ng 8.3 d’un seul hôte et modèle « Debian 13 Cloud-init » du Hub.

FonctionTests de l’installeurLabo
Déclaration, relevé et confirmation du certificat, test de connexionOuiÉprouvé
Catalogue en direct : pools, modèles, réseaux, stockagesOuiÉprouvé
Vérification d’un modèle par machine d’essaiOuiÉprouvé : « conforme », agent invité présent
Machine prévue, calcul du plan (OpenTofu, fournisseur vatesfr/xenorchestra 0.41.2)OuiÉprouvé
Création confirmée et disponibilité (adresse fixe)OuiÉprouvé
Retrait d’une machine crééeOuiÉprouvé
Modèle durciOuiÉprouvé, sans agent installé depuis l’ISO
Détection de l’ISO guest-tools du poolOuiÉprouvé en lecture
Orphelins, adresse en DHCPOuiNon éprouvé
Renouvellement des clés d’hôte au premier déploiementOui (Molecule)Non éprouvé
Installation complète sur des machines créées, évolution qui ajoute une machinePartielNon éprouvé

Prérequis du poste

OutilRôleContrôle
OpenTofu (tofu) 1.8 ou plusCalcul du plan, création et retrait des machinesÀ la vérification préalable, seulement si un serveur est une machine à créer. Messages bloquants : « OpenTofu n’est pas installé. » ou « OpenTofu … est trop ancien : la version 1.8 au moins est requise. »
opensslLecture du certificat relevé chez le fournisseurAucun ; sans lui, le relevé échoue
ssh-keygenClés d’hôte générées pour chaque machine à créerContrôle « Client SSH » de l’accueil

fournisseurs[] dans openiam.yaml

Le jeton n’y figure jamais. Il reste dans les secrets de l’assistant, et « Terminer » l’efface.

ChampContenuRègle
nomNom court, cité par les machines1 à 32 caractères parmi a-z, 0-9 et le tiret. Unique. Ni certificat, ni suffixe -essai
typexen_orchestraVoir Types de fournisseur
urlhttps://hôte[:port]Commence par https://. Le certificat doit porter l’hôte, ce que l’installeur contrôle au calcul du plan
tls.empreinte_sha256Empreinte du certificat feuille, confirmée à l’écran32 octets en hexadécimal séparés par « : »
tls.autoriteAutorité (PEM) qui a signé le certificatFormat PEM. L’un des deux champs tls est obligatoire

Exemple écrit par l’installeur :

fournisseurs:
- nom: xo
  type: xen_orchestra
  url: https://xo.nuage.ebii
  tls:
    empreinte_sha256: 98:A8:58:2A:53:BC:3D:88:03:CC:4D:26:BC:CF:61:E5:0B:93:C8:0E:1A:BF:94:55:3F:06:90:77:D1:10:63:F6

deploiement.hotes[].machine

Un serveur qui porte machine est à créer chez un fournisseur ; sans machine, c’est un serveur existant, joint en SSH.

ChampContenuRègle ou défaut
fournisseurNom d’un fournisseur de fournisseurs[]Doit exister
emplacement.poolIdentifiant du pool XCP-ngChoisi dans la liste lue en direct
modeleIdentifiant du modèleRefusé s’il est « non conforme »
cpuvCPUAu moins 1 ; proposé : 2
memoire_moMémoire en MoAu moins 512. Proposée : 512 plus l’estimation des rôles cochés, 1024 au moins (4096 avant tout rôle coché). Avertissement sous l’estimation du catalogue. Le modèle peut exiger davantage
disques[]stockage (identifiant) et taille_goDisque système (20 Go proposés), puis /var : 5 Go proposés plus l’estimation des rôles cochés, 10 au moins, 20 avant tout rôle coché. Au moins 10 Go au total
reseauIdentifiant du réseauChoisi dans la liste lue en direct
adressage.modefixe ou dhcpfixe par défaut ; dhcp seulement si le verdict du modèle atteste l’agent invité
adressage.cidr, adressage.passerelle, adressage.dnsAdresse avec préfixe, passerelle, serveurs DNSMode fixe ; le domaine de recherche est celui de l’organisation
macAdresse MAC de l’interfacePosée par l’installeur au premier calcul de plan
idIdentifiant de la machine chez le fournisseurPosé une fois la machine créée

Exemple d’une machine prévue, après un premier calcul de plan :

- nom: srv-annuaire.exemple.fr
  adresse: 192.168.12.210
  port: 22
  utilisateur: root
  roles: [annuaire, outils, supervision]
  machine:
    fournisseur: xo
    emplacement:
      pool: 05a67233-4c23-f73a-a45b-c2d016132f15
    modele: 19baa983-ec14-4818-27fc-3e7d990aeeee
    cpu: 2
    memoire_mo: 2944
    disques:
    - stockage: 8dbd36bd-879d-0052-5e41-cd5b5234fc9a
      taille_go: 20
    - stockage: 8dbd36bd-879d-0052-5e41-cd5b5234fc9a
      taille_go: 38
    reseau: f29229aa-1a1f-ca8d-0691-1759affc01ef
    adressage:
      mode: fixe
      cidr: 192.168.12.210/23
      passerelle: 192.168.13.1
      dns: [192.168.13.11]
    mac: 02:dd:fb:ce:a3:8e

Ce que la machine reçoit au premier démarrage (cloud-init)

ÉlémentValeur
Nom d’hôtePremier label du nom du serveur ; nom complet en FQDN
Comptesroot seul, mot de passe verrouillé, clé publique de l’installeur
SSHAuthentification par mot de passe refusée ; clés d’hôte générées par l’installeur, celles du modèle supprimées
PaquetsMise à jour et mise à niveau au premier démarrage
Réseau (adresse fixe)network-config version 1 : l’interface de la MAC choisie, renommée eth0, adresse, passerelle, DNS, domaine de recherche
Disque de configurationDétruit après le premier démarrage
Topologie CPUUn cœur par socket, quel que soit le modèle

Statut d’un serveur dans « Mode et cibles »

BadgeSignificationAction proposée
« prévue »Machine décrite, pas encore crééeCorbeille : retire le serveur de la liste, sans rien changer chez le fournisseur
« créée »Machine créée par l’installeur, jamais installée« Retirer » : plan de destruction, nom à ressaisir
aucunServeur déclaré en SSHCorbeille : retire de la liste

Une machine installée ne se retire pas. Tant qu’une machine est « prévue », l’installeur refuse « Enregistrer et continuer » : « Créez les machines prévues ou retirez-les. »

Verdicts des modèles

VerdictConditionEffet sur l’écran Nouvelle machine
« non vérifié »Aucune vérificationModèle accepté ; DHCP indisponible
« conforme »Vérification réussie depuis moins de 90 joursAccepté ; DHCP proposé si l’agent invité est présent ; « Construire un modèle durci » proposé
« non vérifié (verdict ancien) »Vérification réussie il y a plus de 90 joursAccepté
« non conforme »Vérification en échec, raisons listéesRefusé : « Modèle non conforme (…) »

La vérification contrôle sur la machine d’essai : système, cloud-init terminé, root sans mot de passe, authentification SSH par mot de passe refusée, présence de l’agent invité.

Travaux et phases

TravailDéclenché parPhases affichées
Calcul du plan des machines« Créer les machines prévues (n) », « Calculer le plan », « Recalculer le plan », « Retirer »Initialisation, Plan
Création (ou retrait) des machines« Confirmer la création », « Confirmer le retrait »Création des machines, Disponibilité
Vérification d’un modèle« Lancer la vérification »Initialisation, Plan, Création de la VM d’essai, Essai, Nettoyage
Construction d’un modèle durci« Construire le modèle »Initialisation, Plan, Création de la VM intermédiaire, Disponibilité, Durcissement, Conformité, Nettoyage, Modèle

Un seul travail tourne à la fois. Pendant un travail, l’assistant renvoie vers son suivi, et une modification reçoit « Un travail sur les machines est en cours : attendez sa fin. ».

Actions d’un plan

ActionSens
« créer »Machine à créer
« inchangée »Machine déjà créée, conservée
« détruire »Machine dont le retrait est demandé
« modifier », « remplacer »Changement chez le fournisseur. Le garde-fou refuse un remplacement ou une destruction non demandée, et rien n’est appliqué

Étiquettes posées chez le fournisseur

ÉtiquettePosée sur
open-iamToute machine créée par l’installeur
open-iam:instance=<identifiant>Toute machine. L’identifiant de l’installation sert à repérer les orphelins
open-iam:serveur=<nom>Machine d’un serveur
open-iam:essai=<modèle>Machine d’essai d’une vérification, machine intermédiaire d’un modèle durci
open-iam:modele=durci, open-iam:source=<modèle source>Modèle durci, avec open-iam et open-iam:instance

Délais

DélaiValeur
Appels de l’installeur au fournisseur (relevé, test, catalogue)10 s
Validité d’un plan15 minutes, et tant que la configuration des machines ne change pas
Disponibilité d’une machine crééeUn essai toutes les 10 s, 10 minutes au plus par machine
Création d’une machine côté OpenTofu20 minutes au plus
Validité d’un verdict de modèle90 jours

Flux réseau

DepuisVersPortQuand
Poste de l’installeurXen Orchestra443 (HTTPS et WebSocket wss)Relevé, test, catalogue, plan, création, retrait
Poste de l’installeurregistry.opentofu.org, github.com443Premier calcul de plan : téléchargement du fournisseur vatesfr/xenorchestra. Ensuite, il vient du cache
Poste de l’installeurMachine créée22Disponibilité, puis installation

Fichiers sous le répertoire d’état

Chemins relatifs au répertoire d’état de l’installeur (~/.local/state/open-iam depuis un poste).

CheminContenuDroitsAprès « Terminer »
machines/etat.cleClé de chiffrement des états OpenTofu0600Gardée : sans elle, plus aucun retrait ni ajout
machines/cache/Fournisseurs OpenTofu téléchargés—Gardé
machines/<fournisseur>/confiance.pemCertificat confirmé ou autorité fournie0600Gardé
machines/<fournisseur>/tofurcConfiguration d’OpenTofu : sans télémétrie, cache local, miroir s’il existe—Gardé
machines/<fournisseur>/racines/xcp-ng/terraform.tfvars.jsonMachines à créer, cloud-init compris0600Gardé, cloud-init effacé
machines/<fournisseur>/racines/xcp-ng/terraform.tfstateÉtat OpenTofu, chiffré—Gardé
machines/<fournisseur>/racines/xcp-ng/plan.tfplan, plan.json, plan-show.jsonDernier plan calculé—Effacés
machines/<fournisseur>/modeles.jsonVerdicts des modèles—Gardé
machines/<fournisseur>-essai/Travail des vérifications de modèles—Gardé
machines/miroir/Miroir hors ligne des fournisseurs, s’il a été installé—Gardé

Ce qui n’est pas livré

SujetSuivi
XCP-ng en XAPI directe, sans Xen OrchestraOI-163
Modifier un fournisseur ou une machine prévue : retirer puis recréer—
Ressaisir le jeton d’un fournisseur après « Terminer »—
Historique des verdicts d’un modèle—
Import de l’image Debian officielle par l’installeurAbandonné
Autres fournisseurs (Proxmox, KubeVirt, OVH, Scaleway, Hetzner, AWS, Azure)Plan M8

Voir aussi