How spicyhek/homelab-infra works
This repository is the desired-state and operational tooling for a small homelab: it runs web, NIDS, release-tracking, and status services on K3s, with Argo CD reconciliation and an AWS reliability plane. The main runtime path is Zeek traffic into NIDS, with scheduled backups and independent health probes; operators also use the host network guard and a scorecard for reliability and delivery. Some deployment relationships are documented in the README; unsampled manifests are represented by their exact enclosing directories, so their internal wiring is not asserted.
Main entry points: argocd Argo CD · handler.py Reliability probes · nids NIDS service · reliability_scorecard.py Reliability scorecard
Components 17
GitOps and Workloads
- Git desired state
README.md - Argo CD
k8s/argocd - Personal site
k8s/apps/personal-site - Status API
k8s/apps/status-api - Release tracker
k8s/apps/mybuilds - Cloudflare Tunnel
k8s/edge/cloudflared
Network Security
- Zeek sensor
k8s/daemonsets/zeek - NIDS service
k8s/apps/nids - NIDS backup job
k8s/backups - Host network guard
host/control-plane/network_guard.py
Reliability Plane
- Reliability probes
terraform/reliability-control-plane/lambda/probe/handler.py - Backup validation
terraform/reliability-control-plane/lambda/backup/handler.py - AWS metrics and storage
- Reliability scorecard
scripts/reliability_scorecard.py
Observability
- Metrics collectors
k8s/observability - Grafana Cloud
Other components
- Operator
Connections 20
- Operator → Git desired state: changes desired state
README.md - Git desired state → Argo CD: reconciles from
README.md - Argo CD → Personal site: reconciles
README.md - Argo CD → Status API: reconciles
README.md - Argo CD → Release tracker: reconciles
README.md - Argo CD → NIDS service: reconciles
README.md - Argo CD → Zeek sensor: reconciles
README.md - Argo CD → Cloudflare Tunnel: reconciles
README.md - Zeek sensor → NIDS service: forwards flow data
README.md - NIDS backup job → NIDS service: backs up database
README.md - Reliability probes → Personal site: checks health
terraform/reliability-control-plane/lambda/probe/handler.py - Reliability probes → Status API: checks cluster status
terraform/reliability-control-plane/lambda/probe/handler.py - Reliability probes → NIDS service: checks health
terraform/reliability-control-plane/lambda/probe/handler.py - Reliability probes → Release tracker: checks health
terraform/reliability-control-plane/lambda/probe/handler.py - Reliability probes → AWS metrics and storage: publishes metrics
terraform/reliability-control-plane/lambda/probe/handler.py - Backup validation → AWS metrics and storage: validates backup and publishes metrics
terraform/reliability-control-plane/lambda/backup/handler.py - Reliability scorecard → AWS metrics and storage: collects availability
scripts/reliability_scorecard.py - Reliability scorecard → Operator: produces report
scripts/reliability_scorecard.py - Metrics collectors → Grafana Cloud: sends metrics
README.md - Operator → Host network guard: runs recovery tooling