incus-topology-map/INCUS-TOPOLOGY-DOCUMENT.md

Incus Topology Corporate Document

• Diagram file: incus-topology-corporate.drawio
• Data snapshot: data/incus-snapshot-20260409-132237.json
• Generated on: 2026-04-09

Scope

This document maps all reachable Incus remotes configured on the workstation at generation time:

• hetzner-incus2
• kuber
• local
• virgo-incus

Visual Standards Applied

• Corporate color coding by environment scope:
  • Hetzner remote: orange palette
  • LAN remotes: blue palette
  • Local remote: neutral gray palette
• Status semantics:
  • Running VM: green card
  • Stopped VM: red card
• Hierarchy:
  • Remote -> Node -> VM
• Per VM metadata:
  • project/name
  • type
  • runtime status
  • primary IPv4

Notes

• At generation time, all remotes report clustered=false.
• Primary IP excludes bridge-only 172.16.0.0/12 addresses where possible.

Refresh Procedure

1. Update snapshot via read-only Incus queries.
2. Regenerate .drawio using generate_drawio.py.
3. Re-open the updated diagram in draw.io / diagrams.net.