Playbooks Provision Configuration ProxMox
6 janvier 2026 à 15:55| Variable | Type | Requis | Défaut | Description |
|---|---|---|---|---|
proxmox_endpoint |
FQDN | Oui | Adresse du cluster ProxMox (un des nœuds) | |
proxmox_username |
Identifiant | Oui | Nom de l’utilisateur ayant les permission requise pour créer les ressources | |
proxmox_password |
Chaîne | Si pas proxmox_token_id |
Mot de passe de l’utilisateur | |
proxmox_token_id |
Chaîne | Si pas proxmox_password |
Identifiant du jeton de l’utilisateur à utiliser | |
proxmox_token_secret |
Chaîne | Si proxmox_token_id |
Secret du jeton de l’utilisateur à utiliser | |
proxmox_instance |
Objet instance-proxmox |
Oui | Description de l’instance à créer |
Type instance-proxmox
| Propriété | Type | Requis | Défaut | Description |
|---|---|---|---|---|
vmid |
Entier | Oui | Identifiant de l’instance à créer | |
type |
Choix lxc|kvm |
Oui | Type d’instance à créer | |
node |
Identifiant | Oui | Nœud sur lequel créer l’instance | |
name |
Identifiant | Oui | Nom de l’instance | |
pool |
Chaîne | Non | Nom du pool de ressources à associer | |
cores |
Entier | Oui | Nombre de cœur de processeur | |
description |
Chaîne | Non | Description du conteneur | |
memory |
Entier | Oui | Taille de la mémoire en Mo | |
power_on |
Booléen | Oui | Indique si l’instance doit être démarrée à la création | |
domains |
Liste d’objets domain |
Non | Liste vide | Informations de domaines à mettre en place |
reverses |
Liste d’objets reverse |
Non | Liste vide | Informations de résolutions inverses à mettre en place |
tags |
Liste d’identifiants | Non | Liste vide | Balises associées à l’instance |
autostart |
Booléen | Non | Faux | Indique le démarrage automatique avec le nœud |
startup |
Entier | Si autostart |
Ordre de démarrage automatique avec le nœud |
Type = lxc
Pour les listes de valeurs disponibles : https://pve.proxmox.com/wiki/Linux_Container#pct_options.
| Propriété | Type | Requis | Défaut | Description |
|---|---|---|---|---|
ostype |
Liste de valeur documentation | Non | auto | Type du système du conteneur |
ostemplate |
Object lxc-template |
Oui | Gabarit de conteneur à utiliser | |
swap |
Entier | Non | memory |
Taille du fichier d’échange |
rootfs |
Objet disk-root |
Oui | Paramètres du disque racine | |
networks |
Dictionnaire d’objets lxc-network |
Oui | Liste nommée des interfaces réseau, les noms doivent être ‘net’ + num | |
features |
Dictionnaire de fonctionnalités | Non | Vide | Fonctionnalités à configurer, voir documentation |
unprivileged |
Booléen | Non | Vrai | Indique si le conteneur n’est pas privilégié |
searchdomain |
Nom de domaine | Non | Vide | Domaine de recherche du conteneur |
nameservers |
Liste d’IP séparées par des virgules | Non | Absent | Configurer les serveurs DNS du conteneur, par défaut hérite du parent |
TODO: Points de montage
Note : Les autorisations sur l’identifiant exacte doivent être définis avant. Chemin /vms/{vmid}.
Type = kvm
Pour les listes de valeurs disponibles : https://pve.proxmox.com/wiki/Qemu/KVM_Virtual_Machines#qm_configuration.
| Propriété | Type | Requis | Défaut | Description |
|---|---|---|---|---|
ostype |
Liste de valeur documentation | Non | auto | Type du système du conteneur |
efi |
Booléen | Non | Faux | Activer le démarrage efi |
efidisk |
Object efidisk |
Si efi |
Paramètres du disque efi | |
boot_order |
Liste de périphériques | Non | Ordre de démarrage sur les périphériques | |
machine |
Liste de valeur documentation | Non | ‘pc’ | Type de matériel virtuel |
cpu_type |
Liste de valeur documentation | Non | ‘host’ | Type de processeur virtuel |
networks |
Dictionnaire d’objets kvm-network |
Non | Liste nommée des interfaces réseau, les noms doivent être ‘net’ + num | |
sata_disks |
Dictionnaire d’objets disk-sata |
Non | Liste nommée des disques SATA, les noms doivent être ‘sata’ + num, max 6 | |
scsi_disks |
Dictionnaire d’objets disk-scsi |
Non | Liste nommée des disques SCSI, les noms doivent être ‘scsi’ + num, max 31 | |
virtio_disks |
Dictionnaire d’objets disk-virtio |
Non | Liste nommée des disques VIRTIO, les noms doivent être ‘virtio’ + num, max 16 | |
scsihw |
Liste de valeur documentation | Non | ‘virtio-scsi-single’ | Type de contrôleur SCSI |
video |
Liste de valeur documentation | Non | ‘qxl’ | Type de contrôleur vidéo |
Type lxc-template
| Propriété | Type | Requis | Défaut | Description |
|---|---|---|---|---|
storage |
Identifiant | Oui | Identifiant du stockage contenant le gabarit | |
name |
Chemin | Oui | Nom du fichier contenant le gabarit |
Type disk-root
| Propriété | Type | Requis | Défaut | Description |
|---|---|---|---|---|
storage |
Identifiant | Oui | Identifiant du stockage pour le disque | |
size_gb |
Entier | Oui | Taille du disque | |
options |
Dictionnaire d’option de rootfs | Non | Vide | Options du disque, exemples ci-dessous |
Exemples d’option :
- acl=1
- mountoptions=discard;noatime
Type efidisk
| Propriété | Type | Requis | Défaut | Description |
|---|---|---|---|---|
storage |
Identifiant | Oui | Identifiant du stockage pour le disque | |
efitype |
Choix ‘2m’|‘4m’ | Oui | Taille du disque | |
pre_enrolled_keys |
Booléen | Si efitype == ‘4m’ |
Indique si les clés EFI doivent être intégrés par défaut, et active le démarrage sécurisé | |
format |
Liste de valeur documentation | Non | ‘raw’ | Format du disque |
Type disk-sata / disk-scsi / disk-virtio
Voir les options dans la documentation. Les options usuelles sont rappelées.
| Propriété | Type | Requis | Défaut | Description |
|---|---|---|---|---|
volume |
Référence de volume | Non si cdrom |
Fichier du disque | |
cdrom |
Référence de cdrom | Non si volume |
Fichier du cdrom | |
discard |
Choix ‘ignore’|‘on’ | Non | Prise en charge de discard / rtrim | |
media |
Calculé | N/A | Type de média automatiquement déterminé | |
format |
Liste de valeur documentation | Non | ‘raw’ | Format du disque créé |
La propriété media est définie à disk lorsque volume est défini, à cdrom lorsque cdrom est défini.
La propriété format n’est ajouté que si le disque est créé.
Référence de volume
| Propriété | Type | Requis | Défaut | Description |
|---|---|---|---|---|
storage |
Identifiant | Oui | Identifiant du stockage pour le disque | |
size |
Entier | Si non path |
Taille du disque en Gio | |
path |
Chemin | Si non size |
Nom ou chemin du disque existant |
Référence de cdrom
Valeur “none” ou un objet avec les propriétés :
| Propriété | Type | Requis | Défaut | Description |
|---|---|---|---|---|
storage |
Identifiant | Oui | Identifiant du stockage pour le disque | |
image |
Chemin | Oui | Nom de l’image de CDROM |
Type lxc-network
Voir les options dans la documentation. Les options usuelles sont rappelées.
| Propriété | Type | Requis | Défaut | Description |
|---|---|---|---|---|
name |
Interface (ethx) | Oui | Nom de l’interface dans le conteneur | |
ip |
IPv4/CIDR|‘dhcp’ | Oui | Adresse IPv4 de l’interface | |
gw |
IPv4 | Non | Passerelle par défaut | |
ip6 |
IPv6/CIDR|‘auto’|‘dhcp’ | Non | Adresse IPv6 de l’interface | |
gw6 |
IPv6 | Non | Passerelle par défaut v6 | |
bridge |
Interface | Oui | Nom de l’interface réseau à connecter |
Type kvm-network
Voir les options dans la documentation. Les options usuelles sont rappelées.
| Propriété | Type | Requis | Défaut | Description |
|---|---|---|---|---|
model |
Liste de valeur documentation | Non | virtio | Modèle d’interface |
bridge |
Interface | Oui | Nom de l’interface réseau à connecter |
Type domain
Voir le rôle Domain.
Type reverse
Voir le rôle Reverse.