|
This is unreleased documentation for Admission Controller 1.37-dev. |
Installing Kubewarden Admission Controller with KubeStellar Console
KubeStellar Console is a standalone Kubernetes dashboard that includes guided install missions for CNCF projects. The Kubewarden Admission Controller install mission walks you through the full installation step-by-step, with live cluster validation after each step.
What the mission does
The guided install mission runs against your cluster via kubeconfig. Each step:
-
Pre-flight — checks prerequisites (Helm 3, kubectl, cluster access)
-
Commands — shows the exact
helm installcommands for all three charts (kubewarden-crds,kubewarden-controller,kubewarden-defaults) with--waitflags, matching the quick-start docs -
Validation — after each step, queries the cluster to verify success (pod phase, PolicyServer registration)
-
Troubleshooting — on failure, reads pod logs, events, and resource status from your cluster and suggests fixes
-
Rollback — each step includes the corresponding
helm uninstallcommand to undo the change
The mission also works as read-only documentation — no cluster connection is required to browse the steps.
Prerequisites
-
A running Kubernetes cluster
-
kubectlconfigured with access to the cluster -
Helm v3 installed
-
KubeStellar Console installed (see the install guide for options including Homebrew, Docker, and binary downloads)
Opening the install mission
-
Launch KubeStellar Console and connect to your cluster.
-
Open the AI Mission Explorer from the sidebar.
-
Search for Kubewarden or browse the Install category.
-
Select the Install Kubewarden mission to begin.
Alternatively, open the mission directly at:
https://console.kubestellar.io/missions/install-kubewarden
Install the Helm chart
helm repo add kubewarden https://charts.kubewarden.io
helm repo update kubewarden
helm install --wait \
-n kubewarden \
--create-namespace \
admission-controller kubewarden/admission-controller
The mission validates that the Admission Controller CRDs are registered in the cluster
before proceeding, the controller pod reaches Running status, and the default
PolicyServer is registered and ready.
What’s next
After completing the mission, you have a working Kubewarden Admission Controller installation with the default PolicyServer. From here you can:
-
Browse additional install missions for other CNCF projects in the KubeStellar Console mission explorer