Kubernetes (K3s)
Aria's local infrastructure runs on a K3s cluster on the DGX Spark workstation. The cluster orchestrates 51 Kubernetes manifests covering core services, databases, messaging, and observability.
Canonical Deploy
Use this command for core service deployment:
bash scripts/apply-aria-organism.sh
This applies core YAML in dependency order: runtime → guardrails → Redis → bridges → etc.
Do NOT use deploy-aria-local-full.sh as the default — it's heavy and may churn unrelated services.
Key Manifests
Core Services
| Manifest | Service |
|---|---|
k8s/aria-core/aria-soul.yaml | Aria Soul deployment |
k8s/aria-core/aria-runtime.yaml | Runtime configuration |
k8s/aria-core/ollama.yaml | Ollama LLM runtime (fallback) |
k8s/aria-core/image-tag-guardrails.yaml | Image tag admission policies |
k8s/aria-core/manifold-awareness.yaml | Manifold awareness config |
Infrastructure
| Manifest | Component |
|---|---|
k8s/unified-manifold-light.yaml | Manifold deployment + service |
k8s/unified-manifold-hpa.yaml | Manifold autoscaler |
k8s/redis.yaml | Redis cache |
k8s/redis-hot-stateful.yaml | Redis stateful set |
k8s/postgres.yaml | PostgreSQL (local dev) |
k8s/nats.yaml | NATS message queue |
k8s/openclaw.yaml | OpenClaw persistence |
k8s/aria-messaging-bridges.yaml | Discord/Telegram bridges |
Namespaces and Organization
| Manifest | Purpose |
|---|---|
k8s/hyperforge-aria-namespace.yaml | Hyperforge namespace |
k8s/aria-organism/ | Organism kustomization |
k8s/aria-resource-optimization/ | Autoscaling, scheduling (6 files) |
k8s/aria-playground/ | Lens agents, benchmarks (4 files) |
Image Policy
CRITICAL: Admission policies require canonical image tags. Example: localhost:5000/aria-soul:deepseek-hybrid-*. See k8s/aria-core/image-tag-guardrails.yaml.
Targeted Updates
When only specific images change, prefer targeted updates over full organism deploy:
docker build -t localhost:5000/aria-soul:latest apps/arias-soul
kubectl set image deployment/aria-soul aria-soul=localhost:5000/aria-soul:latest