Skip to content

Commit 6952412

Browse files
MakFlyclaude
andcommitted
fix(iac): lit la passerelle du site sur le nœud au lieu de l'écrire en dur
Le module du catalogue posait « default = "192.168.1.1" » pour vm_ipv4_gateway, et les deux fichiers en tiraient aussi les résolveurs. Cette adresse était vraie sur le lab où le module a été écrit ; ailleurs elle produit un invité qui démarre, prend son adresse, répond au ping sur le LAN, et n'a aucune sortie IPv4. Constaté sur 225, 221 et 222 : ARP FAILED sur 192.168.1.1, le routeur du site étant en .254. « iac scaffold » rend désormais les deux défauts au moment où il pose les fichiers : iac.ipv4_gateway / iac.dns_servers s'ils sont posés, sinon la passerelle du pont du nœud (GET /nodes/{node}/network), sinon null — et Terraform refuse franchement plutôt que de router vers le vide. Le rendu précède la comparaison « modifié localement », sans quoi tout lab dont la passerelle n'est pas celle du catalogue verrait son module signalé comme édité à la main. Aucune adresse n'est plus écrite dans les .tf embarqués, ce qu'un test vérifie sur les fichiers réellement écrits. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HcvsqPWd1DQBHnmwhY6bqu
1 parent a89977a commit 6952412

10 files changed

Lines changed: 408 additions & 10 deletions

File tree

‎cmd/scaffold.go‎

Lines changed: 74 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ import (
1212
"github.com/spf13/cobra"
1313

1414
"github.com/dev-toolings/pvecli/internal/catalog"
15+
"github.com/dev-toolings/pvecli/internal/config"
1516
"github.com/dev-toolings/pvecli/internal/iac"
1617
"github.com/dev-toolings/pvecli/internal/output"
1718
)
@@ -79,7 +80,13 @@ Pour la même raison, les collections dont les rôles ont besoin sont listées d
7980
« pvecli-requirements.yml » : un dossier existant a déjà son requirements.yml, et
8081
l'écraser retirerait silencieusement les collections qu'il déclarait.
8182
82-
ansible-galaxy collection install -r <ansible_dir>/pvecli-requirements.yml`,
83+
ansible-galaxy collection install -r <ansible_dir>/pvecli-requirements.yml
84+
85+
La passerelle et les résolveurs du site ne sont pas écrits dans le catalogue :
86+
ils sont rendus ici. « iac.ipv4_gateway » et « iac.dns_servers » gagnent s'ils
87+
sont posés ; sinon le nœud est interrogé (GET /nodes/{node}/network, la
88+
passerelle de son pont) ; sinon le défaut reste null et Terraform refuse — une
89+
adresse plausible mais fausse route les invités vers le vide sans rien dire.`,
8390
Args: usage(cobra.NoArgs),
8491
RunE: func(cmd *cobra.Command, args []string) error {
8592
eff, err := resolveConfig(cmd)
@@ -93,12 +100,15 @@ l'écraser retirerait silencieusement les collections qu'il déclarait.
93100
return err
94101
}
95102

96-
files, err := scaffoldPlan(eff.IaC.TerraformDir, eff.IaC.AnsibleDir)
103+
errW := cmd.ErrOrStderr()
104+
site := resolveSite(cmd, eff)
105+
_, _ = fmt.Fprintln(errW, siteLine(site))
106+
107+
files, err := scaffoldPlan(eff.IaC.TerraformDir, eff.IaC.AnsibleDir, site)
97108
if err != nil {
98109
return err
99110
}
100111

101-
errW := cmd.ErrOrStderr()
102112
var modified []string
103113
for _, f := range files {
104114
if f.state == fileModified {
@@ -170,7 +180,7 @@ Ensuite, dans cet ordre :
170180
// scaffoldPlan resolves every embedded asset to its destination and reads what
171181
// is already there. Nothing is written by this function: the caller decides,
172182
// and --dry-run must be able to print the exact same list.
173-
func scaffoldPlan(terraformDir, ansibleDir string) ([]scaffoldFile, error) {
183+
func scaffoldPlan(terraformDir, ansibleDir string, site iac.Site) ([]scaffoldFile, error) {
174184
hasProvider, err := declaresProxmoxProvider(terraformDir)
175185
if err != nil {
176186
return nil, err
@@ -204,6 +214,9 @@ func scaffoldPlan(terraformDir, ansibleDir string) ([]scaffoldFile, error) {
204214
if err != nil {
205215
return err
206216
}
217+
if strings.HasPrefix(rel, "terraform/") {
218+
body = iac.RenderTerraform(body, site)
219+
}
207220
state, err := inspectFile(dst, body)
208221
if err != nil {
209222
return err
@@ -263,6 +276,63 @@ func declaresProxmoxProvider(dir string) (bool, error) {
263276
return false, nil
264277
}
265278

279+
// resolveSite answers the one question the embedded module cannot: which
280+
// gateway, and which resolvers, the guests of THIS lab must use.
281+
//
282+
// Order, and why: the configuration wins, because an operator who typed
283+
// `pvecli config set iac.ipv4_gateway` has already met the case where the
284+
// node's own route is not the guests' route. Failing that, the node is asked —
285+
// it carries the answer in the `gateway` of its bridge, and asking beats
286+
// guessing. Failing that too, nothing: the module renders a null default and
287+
// Terraform refuses, which is the honest outcome. A literal fallback is what
288+
// produced guests routed to an address nobody answers on.
289+
//
290+
// No error is returned. Scaffolding must stay possible with no credential and
291+
// no node reachable — writing the module is a local gesture. What the operator
292+
// gets in that case is a line saying the gateway is unknown, and the command
293+
// to fix it.
294+
func resolveSite(cmd *cobra.Command, eff *config.Effective) iac.Site {
295+
site := iac.Site{DNSServers: eff.IaC.DNSServers}
296+
297+
if eff.IaC.IPv4Gateway != "" {
298+
site.IPv4Gateway, site.Source = eff.IaC.IPv4Gateway, "iac.ipv4_gateway"
299+
return site
300+
}
301+
if eff.Node == "" {
302+
return site
303+
}
304+
client, err := newClient(cmd)
305+
if err != nil {
306+
return site
307+
}
308+
netcfg, err := client.Network(cmd.Context(), eff.Node, "")
309+
if err != nil {
310+
return site
311+
}
312+
gw, iface := iac.GatewayFromNetwork(netcfg.Ifaces)
313+
if gw == "" {
314+
return site
315+
}
316+
site.IPv4Gateway, site.Source = gw, fmt.Sprintf("%s de %s", iface, eff.Node)
317+
return site
318+
}
319+
320+
// siteLine is what scaffold prints about the network it just wrote in. It names
321+
// the source: « 192.0.2.254 lu sur vmbr0 » is checkable, « 192.0.2.254 » is not.
322+
func siteLine(site iac.Site) string {
323+
if site.IPv4Gateway == "" {
324+
return `passerelle du site INCONNUE — « vm_ipv4_gateway » reste à null, et
325+
« terraform plan » refusera de router les invités. Pose-la :
326+
327+
pvecli config set iac.ipv4_gateway <ip> puis relance « pvecli iac scaffold »`
328+
}
329+
line := fmt.Sprintf("passerelle du site : %s (%s)", site.IPv4Gateway, site.Source)
330+
if len(site.DNSServers) > 0 {
331+
return line + fmt.Sprintf(" — résolveurs : %s", strings.Join(site.DNSServers, ", "))
332+
}
333+
return line + " — résolveurs : la passerelle"
334+
}
335+
266336
// files2data is what `-o json` renders: the plan, without the file bodies.
267337
func files2data(files []scaffoldFile) any {
268338
type row struct {

‎cmd/scaffold_test.go‎

Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -201,3 +201,66 @@ func TestScaffoldIsIdempotent(t *testing.T) {
201201
t.Errorf("le second passage doit annoncer zéro écriture :\n%s", stderr)
202202
}
203203
}
204+
205+
// La passerelle du site n'est plus un littéral du catalogue : elle vient de la
206+
// configuration (ou du nœud), et le module posé ne doit contenir aucune adresse
207+
// écrite en dur — c'est exactement ce qui avait routé les invités vers une
208+
// passerelle inexistante.
209+
func TestScaffoldWritesTheSiteGateway(t *testing.T) {
210+
tfDir, ansDir := t.TempDir(), t.TempDir()
211+
cfg := filepath.Join(t.TempDir(), "config.yaml")
212+
doc := "current_context: test\ncontexts:\n test:\n iac:\n" +
213+
" terraform_dir: " + tfDir + "\n" +
214+
" ansible_dir: " + ansDir + "\n" +
215+
" ipv4_gateway: 192.0.2.254\n" +
216+
" dns_servers: [192.0.2.53]\n"
217+
if err := os.WriteFile(cfg, []byte(doc), 0o600); err != nil {
218+
t.Fatal(err)
219+
}
220+
t.Setenv("PVECLI_CONFIG", cfg)
221+
222+
if _, stderr, err := run(t, "iac", "scaffold"); err != nil {
223+
t.Fatalf("iac scaffold : %v\n%s", err, stderr)
224+
}
225+
226+
base, err := os.ReadFile(filepath.Join(tfDir, "pvecli-base.tf"))
227+
if err != nil {
228+
t.Fatal(err)
229+
}
230+
for _, want := range []string{`default = "192.0.2.254"`, `default = ["192.0.2.53"]`} {
231+
if !strings.Contains(string(base), want) {
232+
t.Errorf("pvecli-base.tf sans %q :\n%s", want, base)
233+
}
234+
}
235+
236+
entries, err := filepath.Glob(filepath.Join(tfDir, "*.tf"))
237+
if err != nil {
238+
t.Fatal(err)
239+
}
240+
for _, f := range entries {
241+
raw, err := os.ReadFile(f)
242+
if err != nil {
243+
t.Fatal(err)
244+
}
245+
if strings.Contains(string(raw), "192.168.1.") {
246+
t.Errorf("%s contient une adresse en dur", f)
247+
}
248+
}
249+
}
250+
251+
// Sans nœud joignable et sans clé de configuration, scaffold écrit quand même —
252+
// mais avec un défaut nul, jamais une passerelle inventée.
253+
func TestScaffoldWithoutSiteLeavesTheGatewayNull(t *testing.T) {
254+
tfDir, _ := scaffoldDirs(t)
255+
256+
if _, stderr, err := run(t, "iac", "scaffold"); err != nil {
257+
t.Fatalf("iac scaffold : %v\n%s", err, stderr)
258+
}
259+
base, err := os.ReadFile(filepath.Join(tfDir, "pvecli-base.tf"))
260+
if err != nil {
261+
t.Fatal(err)
262+
}
263+
if !strings.Contains(string(base), "default = null # pvecli:ipv4_gateway") {
264+
t.Errorf("le défaut doit rester nul :\n%s", base)
265+
}
266+
}

‎docs/LEARNING-LOG.md‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1645,3 +1645,38 @@ pour l'outil qu'il encadre quand les deux ne construisent pas leur confiance de
16451645
la même manière. Quand un outil tiers ne sait pas vérifier ce que pvecli
16461646
vérifie, la réponse est de lui tendre une connexion déjà vérifiée, pas de lui
16471647
apprendre à ne plus vérifier.
1648+
1649+
## 2026-09-06 — une passerelle écrite en dur ne se trompe qu'une fois, mais partout
1650+
1651+
**Le symptôme.** Sur la VM 225, `ohb-alerting` échouait toutes les 35 s sur
1652+
`alerting.webhook_failed: The operation timed out`. Discord n'était pas en
1653+
cause : depuis 225, 221 et 222, `curl -4 https://1.1.1.1/` ne rendait rien du
1654+
tout. Les trois invités portaient `default via 192.168.1.1`, et l'ARP pour
1655+
cette adresse restait FAILED — personne ne répond là. Le routeur du site est
1656+
la Freebox, en `192.168.1.254`. L'IPv6 marchait, ce qui rendait le diagnostic
1657+
plus lent : une partie du trafic sortait.
1658+
1659+
**La cause.** `internal/catalog/assets/terraform/pvecli-base.tf` posait
1660+
`default = "192.168.1.1"` pour `vm_ipv4_gateway`, et les deux modules en
1661+
tiraient aussi les résolveurs (`servers = [var.vm_ipv4_gateway]`). Cette
1662+
adresse était vraie sur le lab où le module a été écrit. Ailleurs, elle produit
1663+
exactement ce qu'on a vu : un invité qui démarre, prend son adresse, répond au
1664+
ping sur le LAN, et n'a aucune sortie. `vm declare` la recopiait ensuite dans
1665+
`pvecli.auto.tfvars.json`, invité par invité — un littéral faux se duplique.
1666+
1667+
**Ce qui a été écarté.** Changer le littéral pour `192.168.1.254` : c'est la
1668+
même faute, décalée d'un cran, et elle serait fausse sur le lab suivant.
1669+
1670+
**Ce qui a été fait.** Le module ne contient plus d'adresse. `pvecli iac
1671+
scaffold` rend les deux défauts au moment où il pose les fichiers, dans cet
1672+
ordre : `iac.ipv4_gateway` / `iac.dns_servers` de la configuration, sinon la
1673+
passerelle du pont du nœud lue par `GET /nodes/{node}/network` (le nœud sait :
1674+
`vmbr0` porte `gateway: 192.168.1.254`), sinon `null` — et Terraform refuse
1675+
franchement. Le rendu a lieu avant la comparaison « modifié localement », sans
1676+
quoi tout lab dont la passerelle n'est pas celle du catalogue verrait son module
1677+
signalé comme édité à la main.
1678+
1679+
**Règle retenue.** Une valeur que le nœud connaît n'a pas à être devinée par le
1680+
catalogue. Et quand elle ne peut pas être connue, le défaut honnête est `null`,
1681+
qui échoue fort, pas une adresse plausible, qui échoue en silence trente jours
1682+
plus tard.

‎internal/catalog/assets/terraform/pvecli-base.tf‎

Lines changed: 21 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,26 @@ variable "bridge" {
6565
default = "vmbr0"
6666
}
6767

68+
# Passerelle et résolveurs du SITE. Ni l'une ni les autres ne sont écrites en
69+
# dur dans le module : une passerelle littérale est juste sur le lab où elle a
70+
# été écrite, et silencieusement fausse partout ailleurs — l'invité démarre,
71+
# prend son adresse, répond au ping sur le LAN, et n'a aucune sortie.
72+
#
73+
# « pvecli iac scaffold » remplit ces deux défauts, dans cet ordre :
74+
# 1. iac.ipv4_gateway / iac.dns_servers de la configuration, s'ils sont posés
75+
# 2. sinon la passerelle du pont du nœud, lue par GET /nodes/{node}/network
76+
# 3. sinon « null » — Terraform échoue franchement, plutôt que d'envoyer les
77+
# invités vers une adresse où personne ne répond
78+
#
79+
# pvecli config set iac.ipv4_gateway 192.0.2.254
6880
variable "vm_ipv4_gateway" {
69-
type = string
70-
default = "192.168.1.1"
81+
description = "Passerelle IPv4 par défaut, quand un invité ne nomme pas la sienne."
82+
type = string
83+
default = null # pvecli:ipv4_gateway
84+
}
85+
86+
variable "vm_dns_servers" {
87+
description = "Résolveurs par défaut. Vide : la passerelle, comme le fait une box."
88+
type = list(string)
89+
default = null # pvecli:dns_servers
7190
}

‎internal/catalog/assets/terraform/pvecli-lxc.tf‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ variable "lxcs" {
1313
cores = number
1414
memory = number # MIBIOCTETS. 8 Go = 8192. Écrire 8 donne 8 Mio.
1515
disk = optional(number, 8)
16-
ip = optional(string, "dhcp") # "192.168.1.220/24" ou "dhcp"
16+
ip = optional(string, "dhcp") # "192.0.2.220/24" ou "dhcp"
1717
gateway = optional(string)
1818
node = optional(string)
1919
# ctid à cloner. Pas de défaut partagé comme var.template_vm_id côté VM :
@@ -82,7 +82,7 @@ resource "proxmox_virtual_environment_container" "pvecli" {
8282
}
8383
}
8484
dns {
85-
servers = [var.vm_ipv4_gateway]
85+
servers = var.vm_dns_servers != null ? var.vm_dns_servers : [var.vm_ipv4_gateway]
8686
}
8787
user_account {
8888
keys = [var.ssh_public_key]

‎internal/catalog/assets/terraform/pvecli-vms.tf‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ variable "vms" {
1919
cores = number
2020
memory = number # MIBIOCTETS. 8 Go = 8192. Écrire 8 donne 8 Mio.
2121
disk = optional(number, 20)
22-
ip = optional(string, "dhcp") # "192.168.1.220/24" ou "dhcp"
22+
ip = optional(string, "dhcp") # "192.0.2.220/24" ou "dhcp"
2323
gateway = optional(string)
2424
node = optional(string)
2525
template = optional(number)
@@ -90,7 +90,7 @@ resource "proxmox_virtual_environment_vm" "pvecli" {
9090
}
9191
}
9292
dns {
93-
servers = [var.vm_ipv4_gateway]
93+
servers = var.vm_dns_servers != null ? var.vm_dns_servers : [var.vm_ipv4_gateway]
9494
}
9595
user_account {
9696
username = each.value.user

‎internal/config/config.go‎

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ package config
99

1010
import (
1111
"fmt"
12+
"net"
1213
"os"
1314
"path/filepath"
1415
"strconv"
@@ -113,6 +114,14 @@ type IaC struct {
113114

114115
// ManagedTag overrides DefaultManagedTag for the ownership guard.
115116
ManagedTag string `yaml:"managed_tag,omitempty"`
117+
118+
// IPv4Gateway and DNSServers are the site's network answers, and they are
119+
// stored here for one reason: nothing else knows them for sure. Proxmox can
120+
// be asked (the `gateway` of its bridge), and that is what `iac scaffold`
121+
// does by default — these two keys exist for the lab where the node's own
122+
// route is not the one the guests must take, and they win over the node.
123+
IPv4Gateway string `yaml:"ipv4_gateway,omitempty"`
124+
DNSServers []string `yaml:"dns_servers,omitempty"`
116125
}
117126

118127
// CF locates the Cloudflare account the tunnels are created in.
@@ -138,6 +147,8 @@ var WritableKeys = []string{
138147
"iac.terraform_dir",
139148
"iac.ansible_dir",
140149
"iac.managed_tag",
150+
"iac.ipv4_gateway",
151+
"iac.dns_servers",
141152
"cf.account_id",
142153
"secret_source",
143154
"secret_command",
@@ -184,6 +195,21 @@ func SetKey(c *Context, key, value string) error {
184195
case "iac.managed_tag":
185196
c.IaC.ManagedTag = value
186197

198+
// The site's network, checked on the way in: a gateway that is not an IP
199+
// address is a typo, and Terraform would only say so once the guest is
200+
// already declared with it.
201+
case "iac.ipv4_gateway":
202+
if value != "" && net.ParseIP(value) == nil {
203+
return fmt.Errorf("« iac.ipv4_gateway » attend une adresse IP, pas %q", value)
204+
}
205+
c.IaC.IPv4Gateway = value
206+
case "iac.dns_servers":
207+
servers, err := parseIPList(value)
208+
if err != nil {
209+
return fmt.Errorf("« iac.dns_servers » : %w", err)
210+
}
211+
c.IaC.DNSServers = servers
212+
187213
// The account id, and only the account id. The Cloudflare API token is a
188214
// secret and follows the same rule as the PVE one: environment only, fed
189215
// from the keychain, never written to a file this tool manages.
@@ -217,6 +243,23 @@ func SetKey(c *Context, key, value string) error {
217243
return nil
218244
}
219245

246+
// parseIPList reads « 192.0.2.1,192.0.2.2 » into a list of resolvers. An empty
247+
// value clears the key rather than storing a list of one empty string.
248+
func parseIPList(value string) ([]string, error) {
249+
var out []string
250+
for _, f := range strings.Split(value, ",") {
251+
f = strings.TrimSpace(f)
252+
if f == "" {
253+
continue
254+
}
255+
if net.ParseIP(f) == nil {
256+
return nil, fmt.Errorf("%q n'est pas une adresse IP", f)
257+
}
258+
out = append(out, f)
259+
}
260+
return out, nil
261+
}
262+
220263
// absPath turns a path typed on the command line into an absolute one,
221264
// expanding a leading ~ itself: the shell does that expansion for a bare `~`,
222265
// but not inside a quoted argument, and the config file is the wrong place to

‎internal/config/resolve.go‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -119,6 +119,12 @@ func Resolve(fl *pflag.FlagSet, f *File) (*Effective, error) {
119119
e.IaC.TerraformDir = set("iac.terraform_dir", pick(fl, "terraform-dir", "", c.IaC.TerraformDir, ""))
120120
e.IaC.AnsibleDir = set("iac.ansible_dir", pick(fl, "ansible-dir", "", c.IaC.AnsibleDir, ""))
121121
e.IaC.ManagedTag = set("iac.managed_tag", pick(fl, "", "", c.IaC.ManagedTag, DefaultManagedTag))
122+
e.IaC.IPv4Gateway = set("iac.ipv4_gateway", pick(fl, "", "", c.IaC.IPv4Gateway, ""))
123+
e.IaC.DNSServers = c.IaC.DNSServers
124+
e.Sources["iac.dns_servers"] = "fichier"
125+
if len(c.IaC.DNSServers) == 0 {
126+
e.Sources["iac.dns_servers"] = "défaut"
127+
}
122128
e.CF.AccountID = set("cf.account_id", pick(fl, "", EnvAccountID, c.CF.AccountID, ""))
123129

124130
if fl != nil && fl.Changed("insecure") {

0 commit comments

Comments
 (0)