35 lines
779 B
Markdown
35 lines
779 B
Markdown
|
# Homelab Topology
|
||
|
|
|
||
|
|
## Nodes
|
||
|
|
|
||
|
|
| Node | Role |
|
||
|
|
|---|---|
|
||
|
|
| SATURN | Control and development node |
|
||
|
|
| PIHA | Infrastructure and monitoring node |
|
||
|
|
| SOLARIA | AI and compute node |
|
||
|
|
| VPS | Public ingress and edge node |
|
||
|
|
| CHELSTY | Virtualization and Home Assistant node |
|
||
|
|
|
||
|
|
## Architecture Principles
|
||
|
|
|
||
|
|
- Git is the source of truth.
|
||
|
|
- SATURN is the primary orchestration and commit node.
|
||
|
|
- Runtime state lives outside repositories.
|
||
|
|
- Tailscale provides internal mesh networking.
|
||
|
|
- Docker Compose remains the deployment model.
|
||
|
|
- Public ingress is centralized on VPS.
|
||
|
|
- Deployment uses lightweight shell scripts.
|
||
|
|
- Avoid Kubernetes and heavy orchestration frameworks.
|
||
|
|
|
||
|
|
## Runtime Layout
|
||
|
|
|
||
|
|
Runtime data should live under:
|
||
|
|
|
||
|
|
/opt/homelab
|
||
|
|
|
||
|
|
with separated:
|
||
|
|
- services
|
||
|
|
- data
|
||
|
|
- config
|
||
|
|
- logs
|