Provider netbirdio/netbird¶
Couche : Hyperviseur et réseau · Où : poste opérateur (via OpenTofu) · Version : 0.0.10
À quoi elle sert ici et pourquoi ce choix¶
Provider OpenTofu netbirdio/netbird. Configure NetBird : groupes, networks (pad-instances, pad-bastion), routing peers, clés d'installation, connecteur d'identité Authentik, utilisateur de service pour netbird-sync et policy staff vers bastion.
Utilisé par : 40-netbird. Cadre général : OpenTofu et ADR 3.
Où elle tourne et comment elle est déployée¶
Pas de déploiement propre : le provider est téléchargé par tofu init (registry) lors de task tofu:apply-stack, sur
le poste de l'opérateur. Stacks concernées : 40-netbird.
Version épinglée¶
netbirdio/netbird 0.0.10, épinglé exactement dans required_providers des fichiers versions.tf des stacks concernées
(infra/tofu/stacks/*/versions.tf), avec le verrou .terraform.lock.hcl commité. Renovate propose les mises à jour.
Fichiers de configuration dans le dépôt¶
infra/tofu/stacks/40-netbird/(groups.tf,networks.tf,policies.tf,identity_provider.tf,service_users.tf,setup_keys.tf)- Source des valeurs :
infra/contracts.yaml(noms, IP, ports) etsecrets/*.sops.yaml(accès).
Interactions avec les autres briques¶
Parle à l'API de NetBird ; crée l'utilisateur de service et les groupes consommés par netbird-sync. Orchestré par OpenTofu ; secrets lus par le provider sops.
Sécurité¶
Jeton d'accès personnel dans secrets/netbird-tofu.sops.yaml. Aucune policy joueur n'est créée ici : sans policy d'instance, un joueur n'atteint rien.
Supervision¶
Aucune métrique propre. La dérive se voit par task tofu:plan-stack STACK=<nom> ; les ressources pilotées sont
supervisées par leurs briques. En cas de panne d'une stack : Incident générique.
Opérations courantes¶
task tofu:plan-stack STACK=<stack>
task tofu:apply-stack STACK=<stack>
task tofu:lock # régénère les verrous après un changement de version
Pièges connus¶
La policy « Default » (tout vers tout) créée par NetBird doit être désactivée pour obtenir le deny all par défaut (voir infra/tofu/stacks/40-netbird/README.md). Le stack exige NetBird déjà déployé et un PAT.