Varroa Operator Handbook
Varroa manages Jenkins controllers on Kubernetes through declarative resources, shared configuration, centralized access control, and fleet operations.
This handbook is rendered at https://varroa.dev/docs. The docs/ directory in this repository is the canonical, editable source. Edit the pages here and the site publishes them on its next build.
Start here
Section titled “Start here”- Evaluate: Architecture, prerequisites, then create a controller.
- Install: Helm installation, ingress, and network policies.
- Operate: Reconciliation, observability, and troubleshooting.
- Automate: API, varroactl, or MCP clients.
Commands use kubectl and helm. Replace values in <angle-brackets> before running them. Example hosts use example.com.
Architecture
Section titled “Architecture”- Overview: components, resources, and controller lifecycle
- The mite: controller agent identity, commands, and failure behavior
- Scaling: replicas, capacity controls, and sizing
Install
Section titled “Install”- Prerequisites
- Helm installation
- Ingress
- Multi-cluster
- Amazon EKS
- Air-gapped installation
- Network policies
Tutorials
Section titled “Tutorials”Configuration
Section titled “Configuration”- Composed bundles
- CasC catalog
- Bundle sources
- Jobs and items
- Controller classes
- Jenkins versions
- Plugin pinning
- Plugin packs
- Pod customization
Security
Section titled “Security”AI and agents
Section titled “AI and agents”- Agentic fleet operations
- Connect a client
- Tool conventions
- Write through MCP
- Identity and auditing
- Jenkins controller tools
Operations
Section titled “Operations”- Reconciliation
- Lifecycle
- Multi-tenancy
- Brood operations
- Brood schedules
- Rollout waves
- Update center
- Observability
- Troubleshooting