Aller au contenu

ADR-001 — OpenTofu + provider bpg/proxmox

Statut : accepté (2026-07-13)

Contexte

Besoin d'un outil IaC pour piloter Proxmox VE 8.4 (VMs, CT, SDN, pare-feu), en logiciel libre.

Décision

OpenTofu (fork communautaire de Terraform, licence MPL-2.0) avec le provider bpg/proxmox, complété par Ansible pour la configuration interne des machines.

Justification

  • OpenTofu : 100 % libre (Terraform est passé en licence BUSL), compatible avec l'écosystème Terraform.
  • bpg/proxmox : provider Proxmox le plus actif et le plus complet (SDN, pare-feu, cloud-init), contrairement à telmate/proxmox (peu maintenu).
  • Ansible plutôt que cloud-init seul : idempotent, rejouable sur les machines existantes (Coolify, dev-laravel).

Conséquences

  • L'état (*.tfstate) contient des données sensibles → exclu de Git, stocké localement (évolution possible : backend chiffré).
  • Les ressources non couvertes par le provider (job vzdump, stockages) restent gérées via l'API/UI et documentées.