introduce operational scaffold (conventions + 7 sub-dir stubs) Mirrors the nimmerverse.eachpath.local structure for nimmerworld-specific operational concerns. The fresh conventions/development-conventions.md inherits from the platform-wide nimmerverse conventions and only defines what's nimmerworld-specific: - Service identity: UID range 10300-10399 (gameserver/compositor/ director/gm) - Port allocation: +0100/+0200/+0300/+0400 within env-blocks - NATS subjects: under {env}.world.{domain}.{service}.{detail} - K8s namespaces: world-{env} - Deployment topology: dioscuri-as-substrate (per 2026-04-26 housekeeping clarification — old nimmersky/SkyrimNet retired; treat dioscuri empty) - Database conventions: nimmerworld_* table-prefix in shared phoebe-{env} Other 7 sub-dirs are stubs pointing at planned content + referencing platform conventions for shared patterns.

This commit is contained in:
2026-04-26 08:49:28 +02:00
parent 0fa597c25b
commit 6acdeb7b37
8 changed files with 322 additions and 0 deletions

27
k8s/README.md Normal file
View File

@@ -0,0 +1,27 @@
# Kubernetes — Nimmerworld
K8s configurations for nimmerworld services running as pods.
## Namespace pattern
`world-{environment}` per [`../conventions/development-conventions.md`](../conventions/development-conventions.md#kubernetes-namespaces).
| Function | Dev | Staging | Prod | Training |
|----------|-----|---------|------|----------|
| world | `world-dev` | `world-staging` | `world-prod` | `world-training` |
## Workloads (per v0.10 architecture)
- **Compositor** — stateless workers; autoscaling on queue-depth (`transient-waiting-flag` backpressure); requests `nvidia.com/gpu` for trait-LoRA inference
- **Director-routines** — ephemeral per-event-chain; spin-up + prune; requests `nvidia.com/gpu` for driver-tier LLM
- **GM / Governor** — long-running singleton or sharded; equilibrium-seeker; catalogue-event dispatcher
## Status
**Stub** — manifests land in [`../deployments/k8s/`](../deployments/) as services are implemented.
> **Platform K8s patterns:** [`../../nimmerverse.eachpath.local/k8s/`](../../nimmerverse.eachpath.local/k8s/) (Traefik ingress, storage PV/PVC, etc.).
---
**Version:** 0.1 | **Created:** 2026-04-26 | **Updated:** 2026-04-26