Infrastructure

Owner: DevOps
Reviewers: Architecture, Backend
Status: Draft
Version: 0.1
Last Updated: 2026-09-16
Review Cycle: Per infra change

Confirmed Infrastructure

Component Local VM Production Kubernetes Optional
Backend API Dockerfile and Compose service. Docker image plus Docker Compose service on VM. StatefulSet, Service, Ingress and overlays.
PostgreSQL/TimescaleDB Compose service. VM or managed DB topology TBD in repo. Helm chart values under k8s/postgres/.
Redis Compose service. VM or managed Redis topology TBD in repo. Helm chart values under k8s/redis/.
Web frontend Dockerfile and Compose service. Production deploy target not confirmed. Production deploy target not confirmed in K8s docs.
MQTT/Telegraf/IoT worker Compose services. Production deployment target TBD. Production deployment target TBD.

Reference

See ../../docker-compose.yml, ../../docker-compose.iot.yml, .github/workflows/cd-api-stunited-registry.yml and optional K8s notes in ../../k8s/README.md.

Open Items

  • Production deployment topology for web frontend.
  • Production IoT broker/worker topology on VM or managed services.
  • Managed database versus in-cluster database decision.
  • Production VM deploy directory, compose service names and rollback convention.