Infrastructure Overview
Aria runs on a hybrid infrastructure combining GCP Cloud Run (serverless production), K3s (local Kubernetes cluster on DGX Spark), and Cloudflare (edge + DNS).
Infrastructure Map
☸️
Kubernetes (K3s)
51 manifests. Local cluster on DGX Spark. Organism deploy pattern.
☁️
GCP
Cloud Run serverless. Cloud SQL PostgreSQL. Pub/Sub event bus.
🔄
CI/CD
36+ GitHub Actions workflows. Cloud Build. Automated canary deploys.
Technology Stack
| Layer | Technology |
|---|---|
| Runtime | Node.js 24, TypeScript 5.4+, Python 3.x |
| Containers | Docker, Cloud Run, K3s |
| Database | PostgreSQL (Cloud SQL), pgvector |
| Vector DB | Qdrant (4096-dim embeddings) |
| Cache | Redis (Upstash + local) |
| Message Queue | NATS |
| Service Mesh | gRPC + Protocol Buffers |
| Edge / DNS | Cloudflare Pages, Cloudflare DNS |
| CI/CD | GitHub Actions, Cloud Build |
| Monitoring | Cloud Monitoring, Telemetry Emitter |
| Secrets | GCP Secret Manager, K8s Secrets |
Website Publishing (Cloudflare)
All websites are published to Cloudflare Pages by default. Never hand off localhost or ngrok URLs.
# Standard publish command
bash scripts/publish-site.sh <subdomain> <source-path> [project-name]
# Canonical publish command
bash scripts/publish-static-site-cloudflare-pages.sh \
--project <project-name> \
--domain <subdomain.ariasos.com> \
--source-file <absolute-file-path>Preflight Checklist
curl -I https://<domain>returns200- Domain serves expected content
- No dependency on local process managers or temp tunnels