OpenTofu¶
Couche : Hyperviseur et réseau · Où : poste opérateur et CI (jamais sur le serveur) · Version : >= 1.10.0 (version du devshell Nix)
À quoi elle sert ici et pourquoi ce choix¶
OpenTofu décrit l'infrastructure : bridges, routeur, LXC, image Talos, IdP, VPN, bastion, règles pare-feu et DNS.
Il apporte un graphe de dépendances, un plan/diff et un chiffrement natif du state, ce qui le distingue de
Terraform (licence BSL, pas de chiffrement). Décision : ADR 3.
Où elle tourne et comment elle est déployée¶
Il s'exécute sur le poste de l'opérateur (ou en CI pour validate), via task tofu:apply-stack STACK=<nom>.
Neuf stacks, un state par stack, enchaînés par task up dans cet ordre : 00-host-network, 10-router,
15-talos-image, 60-opnsense-rules, 20-services-lxc, 30-authentik, 40-netbird, 50-warpgate, 70-dns.
task destroy les détruit dans l'ordre inverse.
Version épinglée¶
- Binaire :
opentofudu devshell, figé parflake.lock(Nix). Contrainterequired_version = ">= 1.10.0"dans chaqueversions.tf. - Providers : version exacte dans
required_providersde chaqueinfra/tofu/stacks/*/versions.tfet dansinfra/tofu/modules/*/versions.tf, plus.terraform.lock.hclcommité (task tofu:lock). Détail : pages bpg/proxmox, OPNsense, Authentik, NetBird, Warpgate, OVH, SOPS.
Fichiers de configuration dans le dépôt¶
infra/tofu/stacks/<nn>-<nom>/:main.tf,providers.tf,variables.tf,versions.tf,outputs.tf.infra/tofu/modules/:proxmox-network,lxc-service,opnsense-vm,talos-image.infra/tofu/Taskfile.yml:apply-stack,plan-stack,destroy-stack,fmt,validate-all,lock.- Chaque stack lit
infra/contracts.yamlparyamldecode(file(...))(localc).
Interactions avec les autres briques¶
- Lit le contrat et les secrets SOPS (provider sops).
- Pilote Proxmox, OPNsense, Authentik, NetBird, Warpgate et OVH par leurs providers.
- Génère l'inventaire Ansible (
hosts.generated.yml) à la fin de20-services-lxc: voir Ansible.
Sécurité¶
- State chiffré : bloc
encryptionavecpbkdf2(passphraseTF_VAR_state_passphrase) etaes_gcm,enforced = truepour le state et les plans. Backend local.state/tofu/<stack>.tfstate, ignoré par Git. - Secrets lus à l'exécution depuis SOPS, jamais en variable en clair dans le dépôt.
- La CI ne fait que
fmt -checketvalidate; aucunapplyn'est lancé hors du poste de l'opérateur.
Supervision¶
Pas de métrique propre. La dérive est visible par task tofu:plan-stack. Les ressources créées sont supervisées par
les briques correspondantes. Procédures : Up, Destroy.
Opérations courantes¶
export TF_VAR_state_passphrase=... # chiffrement du state (à garder avec la clé age)
task tofu:plan-stack STACK=20-services-lxc
task tofu:apply-stack STACK=20-services-lxc
task tofu:validate-all # fmt -check + validate sans accès serveur
task tofu:lock # régénère les .terraform.lock.hcl
Pièges connus¶
- Perdre la passphrase ou le dossier
.state/rend les stacks illisibles : à sauvegarder avec la clé age. destroy-stackignore silencieusement une stack sans state.- Les registries tofu sont bloqués dans l'environnement cloud des agents :
validatey est limité.