cocoon-operator

Kubernetes operator that manages VM-backed pod lifecycles through two CRDs: CocoonSet (declarative agent groups) and CocoonHibernation (per-pod hibernate / wake requests). Both reconcilers are built on controller-runtime.

CocoonSet          ──► cocoonset.Reconciler    ──► main + sub-agent + toolbox pods
CocoonHibernation  ──► hibernation.Reconciler  ──► HibernateState patch + registry manifest probe
                                                ──► snapshot.Registry (OCI, via registryclient)

Guides

• Architecture — component diagram and package layout
• CocoonSet reconcile loop — finalizer/GC, lifecycle-bridge stamp, failed-state and suspend short-circuits, seat-release hibernation, placement (node pool + snapshot CPU class), cross-node migration, main/sub-agent/toolbox reconciliation
• CocoonHibernation reconcile loop — Hibernate/Wake desire handling, finalizer, recoverable failure phases
• Observability — K8s Event reasons and Prometheus metrics
• Configuration — every environment variable
• Installation — kustomize install, ADC vs SA-key auth, keeping CRDs in sync with cocoon-common

Repository

Source and issue tracker: github.com/cocoonstack/cocoon-operator. Part of the cocoonstack MicroVM platform.

This site is open source. Improve this page.