Deployment

MentatLab is deployed through GitOps (Flux CD) to K3s.

Kubernetes Manifests

Located in k8s/:

• namespace.yaml - namespace
• gateway.yaml - API gateway
• orchestrator.yaml - orchestration service
• orchestrator-rbac.yaml - RBAC permissions for orchestrator
• frontend.yaml - web UI
• redis.yaml - Redis backend
• minio.yaml - object storage + bootstrap bucket Job
• echoagent.yaml - sample agent
• ingress.yaml - ingress routes

MinIO Stability Guardrails

k8s/minio.yaml includes operational safety defaults for single-replica object storage in this cluster:

• strategy: Recreate to avoid RWO PVC multi-attach races during updates
• explicit nodeSelector (amd64) to avoid cross-arch scheduling failures
• non-trivial CPU/memory/ephemeral-storage requests and limits
• bucket bootstrap Job retries MinIO readiness before creating mentatlab-artifacts
• MinIO and mc images are pulled through Harbor's Docker Hub cache (registry.harbor.lan/dockerhub-cache/minio/*)

Container Images

• registry.harbor.lan/library/mentatlab-gateway-go
• registry.harbor.lan/library/mentatlab-orchestrator-go
• registry.harbor.lan/library/mentatlab-frontend

Build and Push

./build-and-push.sh

Build without push:

./build-and-push.sh --skip-push

Deploy

./k8s/deploy.sh --namespace mentatlab

Runtime Configuration

Important environment variables:

• REDIS_URL
• ORCHESTRATOR_BASE_URL
• ORCH_RUNSTORE (memory, redis, or k8s)
• PORT

Operational Checks

• Verify pods are Running in mentatlab namespace
• Verify gateway/orchestrator health endpoints
• Validate run execution with a known flow
• Confirm event stream delivery from orchestrator through gateway