Aller au contenu

Automatisation

admin@pve:~# ls automatisation/ | wc -l → 5 pages · 5 disponibles

CLI, API REST, Terraform, Ansible, installation automatisée.

Cette rubrique vous apprend à piloter Proxmox VE autrement qu'à la souris : commandes en ligne, API REST, Terraform ou OpenTofu pour décrire vos VM en code, Ansible pour les opérations répétitives, et installation automatisée des nœuds. Elle s'adresse aux administrateurs qui veulent industrialiser l'exploitation courante et aux équipes DevOps qui intègrent Proxmox dans leur chaîne de déploiement, dans le respect du périmètre confié au MSP.

Ce que vous saurez faire

  • Utiliser au quotidien qm, pct, pvesh, pvesm, vzdump et ha-manager, et lire pvecm et pveceph en diagnostic.
  • Interroger l'API REST avec curl et un jeton API, et suivre une tâche asynchrone par son UPID.
  • Créer des VM par clonage de template cloud-init avec Terraform ou OpenTofu et le provider communautaire bpg/proxmox.
  • Générer un inventaire Ansible dynamique depuis le cluster et lancer des playbooks types (snapshot, démarrage, mises à jour des invités).
  • Préparer une ISO d'installation automatisée avec un fichier answer.toml.

Prérequis

Ordre de lecture conseillé

  1. CLI essentielles : qm, pct, pvesh, pvecm, pveceph
  2. API REST Proxmox : premiers appels
  3. Terraform / OpenTofu avec Proxmox
  4. Ansible : inventaire dynamique et playbooks types
  5. Installation automatisée (answer file)
  6. Runbooks liés : RB-10 VM verrouillée · RB-12 Restaurer une VM depuis PBS

Notions clés

Terme Définition
pvesh Client en ligne de commande de l'API REST, exécuté sur un nœud.
/api2/json Racine de l'API REST, sur le port 8006 de chaque nœud.
PVEAPIToken En-tête d'authentification par jeton : PVEAPIToken=user@realm!id=secret.
UPID Identifiant d'une tâche asynchrone, à suivre pour savoir si une action a réussi.
Provider Extension Terraform/OpenTofu qui traduit le code en appels API ; ceux de Proxmox sont communautaires.
State Fichier d'état Terraform/OpenTofu, à stocker dans un backend distant verrouillé.
Inventaire dynamique Liste d'hôtes Ansible construite à la volée depuis l'API Proxmox.
answer.toml Fichier de réponses de l'installeur automatique de Proxmox VE.

Les pages de la rubrique

Page Format Phase Niv. Statut
CLI essentielles : qm, pct, pvesh, pvecm, pveceph Fiche Day 1 · Déployer 2 Rédigé
Installation automatisée (answer file) Procédure Day 1 · Déployer 3 Rédigé
API REST Proxmox : premiers appels Cours Day 2 · Exploiter 3 Rédigé
Terraform / OpenTofu avec Proxmox Procédure Day 2 · Exploiter 3 Rédigé
Ansible : inventaire dynamique et playbooks types Procédure Day 2 · Exploiter 3 Rédigé