sjat/boma
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

ADR-012/hardware: add ubongo as physical control node

Browse source 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
sjat 2026-06-05 09:43:09 +02:00
parent 66064be7b2
commit 3fb780c286
2 changed files with 11 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
docs/decisions/012-hardware-capacity.md
View file

@ -13,6 +13,8 @@ workload that should move, or a node due an upgrade.
- `docs/hardware/reference.md` is the single, hand-maintained source of truth for - `docs/hardware/reference.md` is the single, hand-maintained source of truth for
physical compute + network gear and workload placement intent. Two physical compute + network gear and workload placement intent. Two
machine-readable tables (node capacity, workload placement) carry the numbers. machine-readable tables (node capacity, workload placement) carry the numbers.
This includes `ubongo`, the physical control node (ADR-015), even though it sits
outside the Proxmox cluster.
- `scripts/capacity-scan.py` (stdlib-only, like `repo-scan.py` / `tf_to_inventory.py`) - `scripts/capacity-scan.py` (stdlib-only, like `repo-scan.py` / `tf_to_inventory.py`)
parses those tables, computes per-node allocated-vs-physical rollups, and parses those tables, computes per-node allocated-vs-physical rollups, and
cross-checks workload hostnames against `terraform output -json` / cross-checks workload hostnames against `terraform output -json` /

9
docs/hardware/reference.md
View file

@ -18,6 +18,14 @@
- **NICs:** _eno1 trunk (vmbr0), eno2 corosync (vmbr1)_ - **NICs:** _eno1 trunk (vmbr0), eno2 corosync (vmbr1)_
- **Notes:** _warranty, quirks_ - **Notes:** _warranty, quirks_
### ubongo (control node — outside the cluster)
- **Model / form factor:** _TBD (x86-64 mini-PC / USFF, e.g. N100 or refurb micro)_
- **CPU:** _TBD (target 4 cores, x86-64)_
- **RAM:** _TBD (target 16 GB)_
- **Storage:** _TBD (target 250 GB SSD/NVMe)_
- **NICs:** _wired GbE_
- **Notes:** _always-on; control plane + AI-worker + local test runner (ADR-015); not a Proxmox guest_
_(repeat for pve1, pve2, askari)_ _(repeat for pve1, pve2, askari)_
## 2. Network gear ## 2. Network gear
@ -46,6 +54,7 @@ Physical totals per node. Integers; `ram_gb` and `disk_gb` may be decimals.
|------|-------|--------|---------| |------|-------|--------|---------|
| pve0 | 20 | 64 | 4000 | | pve0 | 20 | 64 | 4000 |
| pve1 | 20 | 64 | 4000 | | pve1 | 20 | 64 | 4000 |
| ubongo | 4 | 16 | 250 |
## 5. Capacity notes ## 5. Capacity notes