docs(infra): add network topology
This commit is contained in:
@@ -0,0 +1,57 @@
|
|||||||
|
# Network Topology
|
||||||
|
|
||||||
|
**Last updated:** 2026-08-11
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
The Daystrom Institute management network uses a flat `/24` subnet for all
|
||||||
|
infrastructure nodes. External traffic enters via Unifi and is routed to the
|
||||||
|
Traefik reverse proxy running on `impulse-controller`.
|
||||||
|
|
||||||
|
## Subnets
|
||||||
|
|
||||||
|
| Subnet | Purpose |
|
||||||
|
|--------|---------|
|
||||||
|
| 192.168.50.0/24 | Management / infrastructure |
|
||||||
|
|
||||||
|
## Key Nodes
|
||||||
|
|
||||||
|
| Hostname | IP | Role |
|
||||||
|
|----------|----|------|
|
||||||
|
| impulse-controller | 192.168.50.120 | Docker Swarm manager, Traefik ingress |
|
||||||
|
|
||||||
|
## Ingress Architecture
|
||||||
|
|
||||||
|
```
|
||||||
|
Internet
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
Unifi (external ingress)
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
impulse-controller (192.168.50.120)
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
Traefik v3 (reverse proxy / TLS termination)
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
Swarm services (via master-proxy-overlay)
|
||||||
|
```
|
||||||
|
|
||||||
|
- **Reverse proxy:** Traefik v3 on `impulse-controller`
|
||||||
|
- **Overlay network:** `master-proxy-overlay` — Traefik and Swarm services only
|
||||||
|
- **Portainer UI:** https://192.168.50.120:9443
|
||||||
|
- **External ingress handler:** Unifi → impulse-controller
|
||||||
|
|
||||||
|
## TLS
|
||||||
|
|
||||||
|
- Provider: Cloudflare DNS challenge
|
||||||
|
- Managed by: Traefik (automatic cert issuance and renewal)
|
||||||
|
- HTTP→HTTPS redirect enforced at the Traefik layer
|
||||||
|
|
||||||
|
## Sharp Edges
|
||||||
|
|
||||||
|
> **Docker NOT on `daystrom`** — `daystrom` is the Hermes host. Docker is not
|
||||||
|
> installed there. All containerised workloads run on Swarm nodes
|
||||||
|
> (`impulse-controller` and peers). Do not attempt to run `docker` commands
|
||||||
|
> from `daystrom`.
|
||||||
Reference in New Issue
Block a user