The Dorgu Operator is a Kubernetes operator that validates deployments against persona constraints, discovers cluster state, and provides real-time status updates to the CLI. It is the cluster-side companion to the Dorgu CLI.Documentation Index
Fetch the complete documentation index at: https://dorguai.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
What the operator does
ApplicationPersona validation
Validates deployments against persona constraints: resource limits, replica counts, health probes, and security context. Issues are reported in the persona’s status.
ClusterPersona discovery
Discovers cluster state including nodes, add-ons, resource capacity, Kubernetes version, and platform type. Reconciles every 5 minutes.
ArgoCD integration
Watches ArgoCD Application resources and reflects sync status, health status, and revision info into the persona’s
.status.argoCD field.Prometheus baselines
Queries Prometheus for CPU and memory usage over a 1-hour window and stores baselines in
.status.learned.resourceBaseline.Validating webhook
Optionally intercepts Deployment create/update operations. Runs in advisory (warn) or enforcing (deny) mode.
WebSocket server
Enables real-time communication with the CLI for
dorgu watch and dorgu sync commands via topic-based pub/sub.Non-invasive design — The operator reads and validates only. It never creates or modifies workload resources (Deployments, Services). This is a core architectural invariant.
How it works
The CLI and GitOps pipelines own thespec fields of Persona CRDs (desired state). The operator owns the status fields (observed reality). This separation ensures a clean contract between what you declare and what the cluster reports.
Get started
Installation
Install via Helm, kustomize, or build from source
Quickstart
Get the operator running in 5 minutes
Configuration
Flags, Helm values, and feature toggles