Commit Graph

4 Commits

Author SHA1 Message Date
Maarten 6d193158d5 Rewrite production lab guide for OC-managed provisioning
Rewrites sections 0-6 from scratch with OC-managed clustering (tokens,
OC ISOs, auto-registration) replacing manual cluster formation. Updates
sections 7-15 with correct naming (oc-node-* instead of lab-node-*),
fixes device override bug, and adds sequential launch guidance.

Key changes:
- Architecture: new VMID scheme (920/400-402), IP scheme (.120/.140-142)
- Node-01 disk increased to 250 GiB for Aether golden image
- OC provisioning flow: token → older-channel ISO → auto-update
- Fixed root device config: device override instead of device set
- Added image download timing notes (sequential, not concurrent)
- Updated OC Dashboard section for OC-managed deployment
- Updated node replacement procedure with correct VMIDs/IPs
- Updated cleanup to use --cleanup-all --deep --yes

Full lab validated from scratch: deploy, cluster, OVN, workloads,
isolation, peering, load balancing, live migration, evacuation/restore.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-24 22:19:03 +01:00
Maarten 959cc0162c Convert all ASCII CLI output tables to native markdown tables
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-24 18:53:38 +01:00
Maarten 671d79b77f Convert all ASCII diagrams to mermaid with consistent styling
Replace ASCII art diagrams in 9 guide files with mermaid flowcharts
using a unified style system:

- 5 semantic colors (Okabe-Ito derived, color-blind safe):
  teal (nodes), sky blue (instances), blue (network),
  amber (load balancers), mauve (management)
- classDef for reusable styles, tinted subgraph fills
- Max 2 lines per node, specs in companion tables
- <br/> for line breaks (not \n, which Gitea renders literally)
- Solid arrows for data flow, dashed for control plane

Files converted:
- haproxy-guide.md (1 diagram)
- observability-guide.md (1 diagram)
- api-interception-guide.md (1 diagram)
- incusos-break-fix.md (3 diagrams: partitions, boot chain, updates)
- shared-storage-guide.md (3 diagrams: iSCSI arch, topology, multi-host)
- networking-guide.md (2 diagrams: bridge, OVN topology)
- operations-center-guide.md (1 diagram)
- ovn-deep-dive.md (3 diagrams: lab, bridges, Geneve mesh)
- production-lab-guide.md (1 diagram)
- mermaid-test.md updated as style reference with <br/> fix

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-24 17:31:29 +01:00
Maarten d8f2a067c4 Add production lab guide with validated output from real deployment
Comprehensive 1775-line guide (notes/production-lab-guide.md) covering
full lab lifecycle: OC dashboard, 3-node manual clustering, OVN overlay
networking, mixed workloads, live migration, network security, load
balancers, and cluster evacuation/restore. Every command was executed
on real infrastructure (2026-02-22) and output captured.

Key findings incorporated:
- IncusOS NIC is named `mgmt`, not `ens18` (UPLINK parent)
- OC CLI requires `remote switch`, not `remote:` suffix syntax
- LB/forward backends need IP addresses, not instance names
- Cluster auto-schedules without --target flag
- Migration ~7s at ~140 MB/s with heartbeat continuity

Also: lab-production.yaml config, lab-oc.yaml apply_defaults fix,
CLAUDE.md and networking-guide.md updates for mgmt/OC/LB findings.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-22 23:46:10 +01:00