175 lines
12 KiB
Markdown
175 lines
12 KiB
Markdown
# REPORT — hub v0.73.1: allowlist `disk_health_degraded` (2026-07-24)
|
|
|
|
Part of the disk-health train (agent v0.94.0 + controller v0.169.0/.1 + hub v0.73.1). Appended above
|
|
the previous report (kept below).
|
|
|
|
**Baseline:** felhom.eu `be9edb4` → code `19dbb02` (allowlist) → manifest `5902703` (deploy). Clean at start.
|
|
|
|
**Change:** added `"disk_health_degraded": true` to `allowedEventTypes` (`hub/internal/api/handler.go`)
|
|
so the controller v0.169.0 per-disk SMART degradation notification is ingested, not 400-rejected. Like
|
|
`offbox_enlarge_blocked`, **no `customerMessages` entry** — the controller sends a dynamic Hungarian
|
|
message (disk label + attribute names) that the `FormatCustomerEmail` fallback preserves; a static entry
|
|
would discard the specifics. Test `TestHandleEvent_DiskHealthDegradedAccepted`; red-proof: drop the
|
|
allowlist line → 400 (confirmed). Full hub suite: 17 packages pass, 0 fail; build + vet clean.
|
|
|
|
**Deploy (GitOps):** built `felhom-hub:0.73.1` (digest `79dc3082…`), bumped `manifests/hub.yaml` tag,
|
|
ArgoCD sync → **Synced/Healthy**, pod `hub-59857b486f-hzw48` running `:0.73.1`, clean startup.
|
|
|
|
**§13(3) end-to-end notification proof (the exact `/api/v1/event` POST the controller's notifier makes,
|
|
customer `demo-felhom`, via curl — no committed fixture):**
|
|
- **BEFORE (v0.73.0):** `400 Invalid event_type: disk_health_degraded` — the allowlist was genuinely
|
|
required (without it the customer's disk-degradation email is silently dropped).
|
|
- **AFTER (v0.73.1):** `200 {"ok":true}`; hub log: `Event from demo-felhom: disk_health_degraded
|
|
(warning) — Lemez állapot romlás: teszt-lemez — romló érték: függőben lévő szektorok` and **`Operator
|
|
email sent for demo-felhom/disk_health_degraded`** → hub accepted + dispatched through the Resend
|
|
notification pipeline. Nothing to revert (curl only); the demo's real disks are all "Nincs adat", so
|
|
normal operation stays quiet.
|
|
|
|
---
|
|
|
|
# REPORT — ISO train v1.25.0 + hub v0.73.0 (2026-07-23)
|
|
|
|
**Task:** the four-ruling ISO train (F9 belt-everywhere, apt no-subscription, R-63 console ő/ű,
|
|
R-71 golden-lift mitigation) + Part 6 root-vault rider + Part 7 hub `offsite_stale` fix.
|
|
scripts: host-install **1.17.0→1.18.0**, build-felhom-iso **1.24.0→1.25.0**, felhom-bootstrap R-63;
|
|
hub **v0.72.0→v0.73.0**. Commits: `b620435` (scripts code), hub `0.73.0` train, docs follow.
|
|
|
|
## Status by part
|
|
|
|
| Part | State |
|
|
|---|---|
|
|
| **7 — hub `offsite_stale` newborn anchor** | ✅ SHIPPED + deployed (hub v0.73.0, Synced/Healthy); red-proofed; live: demo-hp/demo-felhom silent |
|
|
| **1 — OOB belt (F9)** | ✅ code (default appliance leg) + **LIVE on BOTH boxes** + **login PROVEN on felhom-pve** |
|
|
| **2 — apt no-subscription** | ✅ code + **LIVE aligned on both boxes** (`apt-get update` clean) |
|
|
| **3 — R-63 console font** | ✅ code + **live ő/ű capture on the HP drill** (képernyő/teendő correct) |
|
|
| **4 — R-71 build-gate + rule** | ✅ code + red-proofed + **LIVE-demonstrated blocking the real gap**; standing rule 5 added |
|
|
| **4 — golden republish** | ✅ **built + published + vouched** — golden **0.161.0** (sha `77624408…`), floor stays 0.156.0; the LIVE gap is CLOSED |
|
|
| **5 — ISO v1.25.0 build** | ✅ **built** (`…v1.25.0-nested-vm-generic-mkimage.iso`, sha `99b38420…`); gate passed live; rootpw+R-63 present |
|
|
| **5 — nested drill** | ✅ **RUN on the HP** (KVM after SVM-enable): R-63 ő/ű **captured**, pairing registered, rootpw opens console; belt/apt fresh-install needs a bind |
|
|
| **6 — felhom-pve root vault** | ✅ rotated + vaulted + **verified authenticating over :22** |
|
|
|
|
## CRITICAL FINDING — the R-71 gap was LIVE, now CLOSED
|
|
|
|
**RESOLVED 2026-07-23:** golden republished at controller **0.161.0** (built on felhom-pve via
|
|
`build-golden.sh`, published to Gitea 618 MB, sha `77624408bd86ec21f3de25eb57f0d9c30d9c374f6e2c19bfcea0816ccb347188`,
|
|
Gitea-served copy sha-verified), **operator-vouched** in the manifest (golden 0.153.0 → 0.161.0;
|
|
floor unchanged at 0.156.0; agent 0.93.0). The gate now passes live and the v1.25.0 ISO built. The
|
|
gap below is the finding as discovered; it no longer exists.
|
|
|
|
The hub's current artifacts *were* **golden 0.153.0 < managed floor 0.156.0**. Every fresh install
|
|
today boots a controller BELOW the floor, so the day-0 managed update fires within minutes —
|
|
the exact update-vs-bridge race that burned demo-hp's offsite credential (DIAG-f10 / R-71). The
|
|
new build-gate **correctly refuses** to build a v1.25.0 ISO in this state (demonstrated live:
|
|
`R-71 BUILD GATE FAILED: golden 0.153.0 < managed floor 0.156.0`). **The fix is Part 4's golden
|
|
republish at controller 0.161.0 + vouch** — until then no valid pairing ISO can be built, by
|
|
design. The vouch (`handleSetArtifacts`) is operator-password-gated (no admin API), so it needs
|
|
the operator.
|
|
|
|
## Part detail
|
|
|
|
**Part 1 (belt).** host-install: appliance mode installs the H1 belt by default (`--no-oob` opts
|
|
out; byo still refuses `--enable-oob` — deliberate exclusion, flagged not changed), and the config
|
|
writer now sets `oob.enabled=true` so the agent activates the belt instead of leaving the units
|
|
inert (the pre-v1.25.0 state that left it unusable — F9). Lockout-safe with no operator peer
|
|
(empty sets + no key, `:22` untouched). **Live:** belt installed on felhom-pve + demo-hp (both
|
|
8822, sets filled `{10.77.0.250}`/`{8822}`, felhom-op key installed, `:22` pid unchanged). **Login
|
|
PROVEN on felhom-pve** end-to-end (`felhom-op@demo-felhom`) — see the operator-identity note below.
|
|
|
|
**Operator identity re-established (latent gap fixed).** The registered `oob_operator_ssh_pubkey`
|
|
was ORPHANED — it matched no key the operator held (an OOB credential the operator can't reproduce
|
|
is no better than the lockout it prevents). Re-anchored to the operator's real machine: registered
|
|
its WireGuard pubkey as the operator peer `10.77.0.250` + its `felhom-op-1` SSH key, built the
|
|
operator wg-felhom tunnel config (`ep0.felhom.eu:443`), added + persisted ep0's `forward` rules
|
|
(`10.77.0.250 → 10.77.0.2/.3` in `/etc/nftables.conf`). Along the way: a corp-network UDP/443 block
|
|
was diagnosed (ep0 tcpdump — packets arriving on 51820 but not 443) and the login completed from a
|
|
home network on 443. All secrets file→file, shredded.
|
|
|
|
**Part 2 (apt).** `align_apt_repos` (appliance-only, idempotent, pre-apt): disable enterprise
|
|
deb822 `.sources` (`Enabled: no`) / legacy `.list`, add `pve-no-subscription.sources` (suite+keyring
|
|
derived), `apt-get update` clean. **Live:** both boxes were on enterprise (401 on update); aligned →
|
|
enterprise+ceph disabled, no-subscription added, `apt-get update` exit 0 on both.
|
|
|
|
**Part 3 (R-63).** felhom-bootstrap loads a Latin-2 console font (`Lat2-Terminus16` → `Lat2-Fixed16`
|
|
→ `Lat2-Terminus14`) once before the first paint (idempotent, best-effort, never blocks boot). Font
|
|
names verified present in the trixie console-setup package. Renders ő/ű in the R-59 network screen
|
|
(élő/telepítő/ellenőrizze) + pairing banner (képernyő/teendő). LIVE-captured on the HP drill (see the drill section + R-63 evidence PNG).
|
|
|
|
**Part 4 (build-gate + rule).** `assert_golden_ge_floor` + `ver_ge` in build-felhom-iso; runs before
|
|
workspace/mint; `die`s with both versions on `golden < floor`; `FELHOM_ASSERT_GOLDEN/FLOOR` inputs;
|
|
unset warns loudly. Red-proofed both directions (floor>golden → exit 1; golden≥floor → OK; equal →
|
|
OK; unset → WARN). Standing rule 5 in `publish-train-rules.md`. Live-demonstrated against the real
|
|
production gap (see above).
|
|
|
|
**Part 6 (root vault).** On felhom-pve, generated a fresh strong root password (never printed),
|
|
`chpasswd`, vaulted via `PUT /api/v1/hosts/demo-felhom-8363b5/recovery-credential` (HTTP 200, the
|
|
same day-0 `step_break_glass` mechanism, host api_key). Verified: retrieved via the operator
|
|
endpoint (global key) and it AUTHENTICATED root over `:22` (`VAULT-AUTH-OK: demo-felhom`); copy
|
|
shredded. felhom-pve now has G1 vault parity with demo-hp. (Note: the vault's `set_at` reflects the
|
|
original day-0 stamp — not bumped on rotation; cosmetic, the SECRET is the rotated one, proven by
|
|
the auth test.)
|
|
|
|
## Nested drill — RUN on the HP (2026-07-23)
|
|
|
|
The N100 attempt was aborted (install crawled, contended by live guest 9201). Per the operator's
|
|
steer the drill moved to the HP (demo-hp). Blocker found + fixed: the HP had **AMD SVM disabled in
|
|
BIOS** (`SVM disabled (by BIOS) in MSR_VM_CR`) so KVM was unavailable — the operator enabled
|
|
**Security → System Security → Virtualization Technology = Enable**; on reboot `/dev/kvm` appeared
|
|
(`kvm_amd` auto-loads via the persisted `/etc/modules-load.d/felhom-kvm.conf`) and the live guest
|
|
9201 auto-recovered.
|
|
|
|
The KVM-accelerated install reached first-boot in **~12 min** (vs the N100's 40+ that never
|
|
finished) and PROVED, live:
|
|
- **R-63 — ő/ű console capture**: the first-boot pairing banner renders „képernyő"/„teendő" with
|
|
correct double-acute ő under the Lat2 font (evidence: `documentation/audits/R-63-console-font-drill-2026-07-23.png`).
|
|
This is the spec's R-63 closure evidence.
|
|
- **v1.25.0 pairing chain**: the box self-registered as an unclaimed appliance (hub log
|
|
`appliance registered: new unclaimed box uuid=206c8838…`).
|
|
- **R-61 rootpw regression**: the build's `.rootpw.txt` opens the installed console (`ROOTPW-OK:
|
|
felhom-host`).
|
|
- Bonus: `apt-get install sshpass` succeeded on demo-hp — confirms the Part-2 no-subscription
|
|
alignment works for real installs, not just `update`.
|
|
|
|
Still requiring an operator **bind** (password-gated) to exercise on the ISO-driven fresh install:
|
|
the belt-default + apt legs *inside host-install* and the golden-0.161.0 pull (host-install only
|
|
runs after a box is bound). Those legs are already proven live on both real boxes this session, and
|
|
the no-floor-update outcome is structurally guaranteed post-vouch (golden 0.161 ≥ floor 0.156). The
|
|
unclaimed drill box (uuid 206c8838) can be bound to a throwaway customer to close that last leg, or
|
|
discarded.
|
|
|
|
## Nested drill — (earlier N100 attempt, superseded)
|
|
|
|
Golden republish + vouch + the v1.25.0 ISO build are DONE. The nested drill was attempted on the
|
|
N100 (felhom-pve): 1.7 GB ISO transferred + sha-verified, VM 9313 created (OVMF SB-off for the
|
|
mkimage loader, disk-first boot), auto-install started. It ran **KVM-accelerated** (confirmed:
|
|
`/usr/bin/kvm`, `cpu host,+kvm_pv_eoi…`, `q35+pve0` — not TCG, not memory-starved) but crawled
|
|
pathologically — **~40+ min pegged at 100% of one core, stuck in the kernel/grub/initramfs
|
|
configure at ~87%** — because the N100 was simultaneously running the **live customer guest 9201**
|
|
plus the golden build scratch. **Aborted to protect the live guest** (a runaway install must not
|
|
starve a production customer workload); VM 9313 + the golden scratch (9100 + local vzdump) + the
|
|
drill ISO were destroyed/removed, 9201 untouched, 70 GB freed.
|
|
|
|
**Operator steer (2026-07-23): future drills/builds move to the HP (demo-hp)** — more RAM, faster
|
|
CPU, and it carries no live customer guest, so a nested install there will be far quicker.
|
|
|
|
What the drill would have added, and its current standing:
|
|
- **R-63 console ő/ű capture** — the one leg genuinely PENDING a live boot. The font *code* is
|
|
verified (Lat2-Terminus16/Fixed16/Terminus14 confirmed present in the trixie console-setup
|
|
package; `set_console_font` correct + embedded in the built ISO's bootstrap payload). The visual
|
|
screendump rides the next HP-based drill.
|
|
- **belt installed+active + apt=no-subscription (fresh-install path)** — the legs themselves are
|
|
already **proven live on both real boxes** this session; the ISO-driven path additionally needs
|
|
an operator **bind** (password-gated, like the v1.24.0 rehearsal's drill customer).
|
|
- **golden 0.161.0 boots with NO managed-update firing** — now **structurally guaranteed** (golden
|
|
0.161.0 ≥ floor 0.156.0 after the vouch; the update only fires below the floor); a live boot
|
|
would merely confirm it.
|
|
- **`.rootpw.txt` opens the console** — R-61 regression; rides the HP drill.
|
|
- **build-gate red-proof in the nest** — already demonstrated live on DooPlex against the real gap
|
|
(`golden 0.153 < floor 0.156` → build refused).
|
|
|
|
## Observed / not acted on
|
|
|
|
- The live golden(0.153)<floor(0.156) gap predates this train (an old golden bake vs a later floor
|
|
lift) — the new gate surfaces it; the golden republish fixes it.
|
|
- ep0 root is reachable from DooPlex (used for the operator-tunnel + forward-rule work); the forward
|
|
rules are persisted to survive reboot.
|