Skip to content
Operator Guide

Operator Guide

The Operator Guide is for platform engineers who run DataKit itself: the dk CLI, the dk-controller Kubernetes operator, the optional ClickHouse migration sidecar, and the ArgoCD wiring that turns Git changes into running packages.

Use this section when you need to:

  • install or upgrade the controller Helm chart
  • bootstrap the ArgoCD ApplicationSet integration
  • understand how environments, cells, and stores map to runtime infrastructure
  • debug failed promotions, package reconciles, or ClickHouse migrations
  • recover the control plane after a bad rollout or store outage

The control plane has two main loops:

  • CLI loop — dk build, dk publish, dk promote, and dk rollback
  • cluster loop — ArgoCD syncs Git state, then dk-controller reconciles PackageDeployment, Store, Cell, and ClickHouseMigration resources

Operator pages in this section:

See Also