dorgu cluster setup

Install the Dorgu blessed stack — a curated set of production-ready infrastructure components

Synopsis

dorgu cluster setup [flags]

Description

Install a curated, production-ready infrastructure stack onto your Kubernetes cluster. The cluster setup command automates the installation and configuration of battle-tested components that cover TLS, ingress, observability, GitOps, and secrets management.

The command reads the ClusterPersona to determine the cluster environment and tailors component configuration accordingly (e.g., resource sizing, replica counts, storage classes).

Blessed Stack

The versions below are upstream Helm chart versions for each third-party component — they are not Dorgu release versions.

Component	Version	Description
cert-manager	v1.16.3	Automated TLS certificate management via Let’s Encrypt or internal CAs
ingress-nginx	4.11.3	HTTP/S ingress controller for routing external traffic
CloudNativePG	0.24.0	PostgreSQL operator, required by OpenObserve for metadata storage
OpenObserve	0.60.0	Unified observability platform — logs, metrics, and traces in one tool
Argo CD	7.8.28	Declarative GitOps continuous delivery engine
External Secrets	0.10.7	Sync secrets from cloud stores (AWS Secrets Manager, Vault, GCP Secret Manager) — optional

Flags

Flag	Type	Default	Description
--cluster-persona	string	auto-detected	ClusterPersona name; auto-detected from the current cluster if not set
--environment	string	from ClusterPersona	Environment override: development, staging, production
--dry-run	bool	false	Print helm commands without executing
--skip-validation	bool	false	Skip post-install pod health checks
--driver	string	helm	Installation driver: helm or gitops
--gitops-output	string	./dorgu-cluster-gitops	Output directory for GitOps repo scaffold
--context	string	current-context	Kube-context to use; defaults to current-context
--verbose	bool	false	Stream real-time Helm output during installation

Helm driver

The default helm driver performs an imperative installation. Each blessed stack component is installed sequentially via helm install (or helm upgrade --install) with values tailored to your cluster environment.

The installation order respects dependency chains — for example, cert-manager is installed before ingress-nginx (which needs TLS), and CloudNativePG is installed before OpenObserve (which needs PostgreSQL).

After installation, pod health checks run automatically to verify each component is ready (unless --skip-validation is set). When validation is skipped, the final summary displays “Pods healthy: — (validation skipped)” instead of a numeric count.

# Install the full stack with the default helm driver
dorgu cluster setup

# Preview what would be installed
dorgu cluster setup --dry-run

# Install with real-time output
dorgu cluster setup --verbose

# Install against a specific kube-context
dorgu cluster setup --context kind-dorgu-dev

GitOps driver

The gitops driver does not install components directly. Instead, it scaffolds a GitOps repository structure using the ArgoCD App-of-Apps pattern. You commit this scaffold to your Git repository and let ArgoCD reconcile the desired state.

# Scaffold a GitOps repo
dorgu cluster setup --driver gitops

# Scaffold to a custom directory
dorgu cluster setup --driver gitops --gitops-output ./infra/cluster-apps

# Preview the scaffold without writing
dorgu cluster setup --driver gitops --dry-run

Generated directory structure

dorgu-cluster-gitops/
├── README.md
├── argocd/
│   └── root-app.yaml                  # Root ArgoCD Application (App-of-Apps)
└── clusters/
    └── <cluster-name>/
        ├── apps/
        │   ├── cert-manager.yaml      # ArgoCD Application per component
        │   ├── ingress-nginx.yaml
        │   ├── cloudnative-pg.yaml
        │   ├── openobserve.yaml
        │   ├── argocd.yaml
        │   └── external-secrets.yaml
        └── values/
            ├── cert-manager.yaml      # Helm values per component
            ├── ingress-nginx.yaml
            ├── cloudnative-pg.yaml
            ├── openobserve.yaml
            ├── argocd.yaml
            └── external-secrets.yaml

The cluster-scoped layout (clusters/<name>/) supports managing multiple clusters from a single repository. See the GitOps Mode guide for multi-cluster examples and day-2 operations.

Examples

# Full stack install (default helm driver)
dorgu cluster setup

# Production environment override
dorgu cluster setup --environment production

# Dry-run to preview helm commands
dorgu cluster setup --dry-run

# Verbose install with real-time streaming
dorgu cluster setup --verbose

# Use a specific ClusterPersona
dorgu cluster setup --cluster-persona prod-us-east

# GitOps scaffold for an existing ArgoCD setup
dorgu cluster setup --driver gitops --gitops-output ./infra/gitops

# Skip post-install validation for faster iteration
dorgu cluster setup --skip-validation

Prerequisites: kubectl and helm must be available in your PATH. The gitops driver additionally requires an ArgoCD installation on the target cluster (or you can bootstrap ArgoCD as part of the generated scaffold).