Valeurs de site¶
Le dépôt est public : il ne décrit aucun hôte réel. Les valeurs propres à votre hôte Proxmox sont des entrées que
vous fournissez dans secrets/site.sops.yaml, un fichier chiffré (SOPS + age) comme les autres secrets d'infra.
Le modèle est secrets/site.example.yaml : il liste les clés avec une valeur vide et une description.
| Fichier | Versionné | Rôle |
|---|---|---|
secrets/site.example.yaml |
oui | modèle : les clés attendues, valeurs vides |
secrets/site.sops.yaml |
oui, chiffré | vos valeurs, lisibles avec la clé age de l'opérateur |
Utilisation¶
task secrets:init # crée secrets/site.sops.yaml (vide) avec les autres secrets manquants
sops secrets/site.sops.yaml
task secrets:pending # liste les clés de site encore vides
Clés¶
| Clé | Rôle | Requis |
|---|---|---|
proxmox_url |
URL de l'API Proxmox, sans chemin (schéma, hôte, port) | oui |
ssh_host |
adresse par laquelle le poste joint réellement l'hôte Proxmox : de préférence une IP (ex. l'IP du VPN maillé) plutôt qu'un nom. Utilisée par Ansible et par le provider bpg/proxmox d'OpenTofu (SSH de la phase 2, stack 10-router), qui ne prend pas l'adresse annoncée par l'API |
oui |
ssh_user |
utilisateur SSH de l'hôte (sudo pour le rôle host-tuning) |
oui |
wan.ip |
IPv4 publique de la plateforme (DNS publics, WAN d'OPNsense) | oui |
wan.gateway |
passerelle IPv4 du WAN | en mode routed_ip |
wan.mac |
MAC dédiée de la NIC WAN du routeur | seulement si l'hébergeur l'exige |
Modes WAN¶
Le mode se choisit dans le contrat (wan.mode) :
routed_ip: une IP publique supplémentaire est routée vers la VM routeur (avec une MAC dédiée si l'hébergeur l'exige).wan.ipest cette IP,wan.gatewayla passerelle de l'hôte.nat: l'hôte garde son IP publique et redirige les ports publics vers OPNsense par DNAT.wan.ipest l'IP publique de l'hôte ;wan.gatewayetwan.macsont inutilisés.
Qui lit quoi¶
| Consommateur | Mécanisme |
|---|---|
| OpenTofu | data "sops_file" "site" (provider carlpett/sops) dans les stacks concernées |
| Ansible | variable pad_site (lookup('community.sops.sops', ...)), adresse et utilisateur de l'inventaire |
| Scripts | sops --decrypt puis yq (fonction site_get de bootstrap/scripts/lib.sh) |
Nom du nœud Proxmox¶
Le contrat fixe host.node: pve, nom par défaut de l'installeur Proxmox. Pour un autre nom :
task site:node -- <nom> met à jour le contrat et tous les manifests marqués # contracts: host.node.
Prérequis sur l'hôte¶
L'hôte Proxmox doit être vierge, ou sans conflit de VMID ni de bridge avec le contrat (Contrat). La plateforme ne supprime rien de ce qu'elle n'a pas créé.
Dans cette documentation¶
Les exemples utilisent des valeurs fictives : example.net, CHANGEME. Le domaine public (domain) reste dans le
contrat et se remplace dans votre copie du dépôt.