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:
27
k8s/README.md
Normal file
27
k8s/README.md
Normal 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
|
||||
Reference in New Issue
Block a user