Skip to content

docs(adr): ADR 0489 — netplan MAC mismatch recovery model#12

Open
baditaflorin wants to merge 1 commit into
mainfrom
claude/beautiful-payne-1d2b93
Open

docs(adr): ADR 0489 — netplan MAC mismatch recovery model#12
baditaflorin wants to merge 1 commit into
mainfrom
claude/beautiful-payne-1d2b93

Conversation

@baditaflorin
Copy link
Copy Markdown
Owner

Summary

  • Documents the 2026-05-20 incident where provision-guests regenerated cloud-init ISOs with corrected MACs but running VMs retained stale /etc/netplan/50-cloud-init.yaml on disk
  • Captures the recovery procedure (overwrite netplan via qm guest exec + netplan apply)
  • Explains why the new instance-id in the regenerated ISO guarantees self-healing on next reboot
  • Includes diagnostic quick-reference for future incidents

Release checklist

  • ADR written and indexed
  • VERSION bump (not needed — docs-only)

Test plan

  • Verified all four affected VMs (110, 120, 140, 150) are UP with correct MACs
  • Verified cloud-init ISOs contain correct MACs
  • Verified instance-id mismatch on all VMs (will trigger clean re-init on reboot)
  • Verified OpenBao on VM 192 is initialized and unsealed

🤖 Generated with Claude Code

Documents root cause (provision-guests regenerated cloud-init ISOs with
new MACs but running VMs had stale netplan on disk), recovery procedure
via qm guest exec, and why the new instance-id guarantees self-healing
on next reboot. Includes diagnostic quick-reference.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant