Files
homelab/infra/ubiquiti/network-diagram.md
Julia McGhee 96e3f32f28 Initial monorepo scaffold
Turborepo + pnpm monorepo for k3s homelab cluster on Intel NUCs.

- Apps: Next.js web frontend, Express API (TypeScript, Dockerfiles, k8s manifests)
- Packages: shared UI, ESLint config, TypeScript config, Drizzle DB schemas
- Infra/Ansible: bare-metal provisioning with roles for common, k3s-server, k3s-agent, hardening
- Infra/Kubernetes: ArgoCD GitOps (app-of-apps + ApplicationSets), platform components
  (cert-manager, Traefik, CloudNativePG, Valkey, Longhorn, Sealed Secrets), namespaces
- Observability: kube-prometheus-stack, Loki, Promtail as ArgoCD Applications
- CI/CD: GitHub Actions for PR builds, preview deploys, production deploys
- DX: Taskfile, utility scripts, copier templates, Ubiquiti network docs
2026-03-19 22:24:56 +00:00

2.1 KiB

Network Diagram

                          ┌──────────────┐
                          │   Internet   │
                          └──────┬───────┘
                                 │
                          ┌──────┴───────┐
                          │     UCG      │
                          │  10.0.1.1    │
                          └──────┬───────┘
                                 │
                    ┌────────────┼────────────┐
                    │            │            │
             ┌──────┴───┐ ┌─────┴────┐ ┌────┴──────┐
             │ VLAN 10  │ │ VLAN 20  │ │ VLAN 99   │
             │ Servers  │ │   IoT    │ │  Guest    │
             └──────┬───┘ └──────────┘ └───────────┘
                    │
       ┌────────────┼────────────┐
       │            │            │
  ┌────┴────┐ ┌────┴────┐ ┌────┴────┐
  │  nuc01  │ │  nuc02  │ │  nuc03  │
  │ .10.11  │ │ .10.12  │ │ .10.13  │
  │ server  │ │  agent  │ │  agent  │
  └─────────┘ └─────────┘ └─────────┘

  Services on k3s cluster:
  ┌─────────────────────────────────────┐
  │  Traefik (Ingress) ← :80/:443      │
  │  ArgoCD            ← :8080         │
  │  Grafana           ← :3001         │
  │  PostgreSQL (CNPG) ← :5432         │
  │  Valkey            ← :6379         │
  │  Longhorn UI       ← :8000         │
  └─────────────────────────────────────┘