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.