Get started

Install with kubectl

Install the Kuberik controllers by applying their release manifests with kubectl. The Helm chart installs the same controllers plus the dashboard in one release; use this page when you manage controllers without Helm.

On this page
  1. Install the rollout-controller
  2. Install the release-controller
  3. Add integration controllers
  4. Check the result
  5. Next steps

Before you start, you need Kubernetes 1.30 or later, kubectl access with rights to create CRDs, and Flux 2.6 or later in the cluster (install Flux): Kuberik picks the version and Flux applies it. The rollout-controller ships ValidatingAdmissionPolicies (admissionregistration.k8s.io/v1), which Kubernetes serves from 1.30.

Install the rollout-controller

The rollout-controller runs every Rollout. Apply its latest release manifest:

Terminal
kubectl apply --server-side -f https://github.com/kuberik/rollout-controller/releases/latest/download/install.yaml

The manifest creates the kuberik-system namespace, the CRDs and the rollout-controller-controller-manager Deployment.

Install the release-controller

Rollouts read their releases from ReleaseSource objects, which the release-controller serves. Its manifest creates the release-controller-system namespace and the release-controller-controller-manager Deployment.

Terminal
kubectl apply --server-side -f https://github.com/kuberik/release-controller/releases/latest/download/install.yaml

Add integration controllers

Each integration is a separate controller in kuberik-system. Install only the ones you use; the linked page shows what each one reads.

ControllerAddsManifest
openkruise-controllerCanary steps with OpenKruise Rollouthttps://github.com/kuberik/openkruise-controller/releases/latest/download/install.yaml
datadog-controllerDatadog monitors and incidents as health checkshttps://github.com/kuberik/datadog-controller/releases/latest/download/install.yaml
environment-controllerPromotion between environments through GitHub deployments, on one cluster or manyhttps://github.com/kuberik/environment-controller/releases/latest/download/install.yaml

Apply each one the same way, server-side: openkruise-controller’s RolloutTest CRD is larger than the 256 KiB annotation a client-side apply writes.

Terminal
kubectl apply --server-side -f https://github.com/kuberik/openkruise-controller/releases/latest/download/install.yaml

The prometheus-controller publishes no manifest; Prometheus shows how to build and deploy it.

Check the result

Wait for the controllers to become ready:

Terminal
kubectl -n kuberik-system rollout status deployment/rollout-controller-controller-manager
kubectl -n release-controller-system rollout status deployment/release-controller-controller-manager
OutputText
deployment "rollout-controller-controller-manager" successfully rolled out
deployment "release-controller-controller-manager" successfully rolled out

Next steps