Quickstart

Generate Kubernetes manifests in 5 minutes

Get started

1. Install the CLI
2. Set up global config

   Configure your LLM provider and defaults (optional but recommended):

   dorgu init --global
   

   This prompts for:

   • LLM provider — openai, anthropic, gemini, or ollama
   • API key — your provider API key
   • Default namespace — Kubernetes namespace (e.g., default)
   • Container registry — e.g., ghcr.io/my-org
   • Organization name — for Kubernetes labels

   Config is saved to ~/.config/dorgu/config.yaml.

3. Initialize your app

   Navigate to your application directory (must contain a Dockerfile or docker-compose.yml):

   cd my-app
   dorgu init
   

   This creates a .dorgu.yaml file with app name, team, repository (auto-detected from git), and other metadata.

4. Generate manifests

   dorgu generate .
   

   Dorgu analyzes your application and outputs:

   my-app/
   ├── k8s/
   │   ├── deployment.yaml
   │   ├── service.yaml
   │   ├── ingress.yaml
   │   ├── hpa.yaml
   │   └── argocd/
   │       └── application.yaml
   ├── .github/workflows/
   │   └── deploy.yaml
   └── PERSONA.md
   

   A validation report runs automatically, checking resource bounds, port consistency, health probes, and security contexts.

Preview with dry run

Print generated manifests to stdout without writing files:

dorgu generate . --dry-run

Use LLM-enhanced analysis

For deeper analysis (framework-specific recommendations, resource sizing, security practices):

dorgu generate . --llm-provider openai

This requires an API key set via dorgu init --global or the OPENAI_API_KEY environment variable. See LLM Providers for all supported providers.

Output walkthrough

File	Description
k8s/deployment.yaml	Kubernetes Deployment with resource limits, health probes, security context
k8s/service.yaml	ClusterIP Service mapping detected ports
k8s/ingress.yaml	Ingress with TLS via cert-manager (if configured)
k8s/hpa.yaml	HorizontalPodAutoscaler with CPU-based scaling
k8s/argocd/application.yaml	ArgoCD Application pointing to your repo
.github/workflows/deploy.yaml	GitHub Actions CI/CD pipeline (build, push, deploy)
PERSONA.md	Human-readable persona document describing your app

Next steps

Command Reference

See all flags and options for dorgu generate.

Configuration

Customize manifests with layered configuration.

Cluster Setup

Bootstrap a production-ready Kubernetes stack.

Working with Personas

Apply ApplicationPersona CRDs to your cluster.