Kubean
What it is
Kubean is an open-source toolchain for managing Kubernetes cluster lifecycles through a declarative API. Running on an existing Kubernetes cluster and using Kubespray underneath, it handles installation, uninstallation, upgrades, and scaling through custom resources and Kubernetes resources. The documented installation method is a Helm chart, and the control node or cloud terminal needs Helm plus an existing standard or cloud-provider Kubernetes cluster. Kubean can deploy clusters over SSH, with an SSH private key stored in a Kubernetes Secret referenced by a Cluster resource. Operations may run a playbook or shell command, with optional hooks before and after. The project supports bare metal, virtual machines, and cloud environments with customer-managed control planes. Offline releases include operating-system packages, images, and binaries. Listed delivery architectures include AMD, ARM, and Kunpeng with Kylin. Offline package documentation covers CentOS, Red Hat, Kylin, and Ubuntu; local ISO and extra software sources are currently limited to CentOS. Kubean describes itself as a CNCF sandbox project.
For and against
For
- Declarative installation, upgrades, scaling, and removal
- Runs playbooks or shell commands with hooks
- Supports offline packages, images, and binaries
- Delivers for AMD, ARM, and Kunpeng with Kylin
- Helm installation on an existing Kubernetes cluster
Against
- Requires an existing Kubernetes cluster and Helm
- Offline ISO sources currently support only CentOS
- UnionTech V20 packages require manual building
- Runs on Kubernetes rather than standalone
The verdict
Kubean provides a Kubernetes-native way to coordinate cluster provisioning and lifecycle work, including offline and multi-architecture scenarios. Its prerequisite of an existing cluster and Helm makes it better suited to established Kubernetes environments.
Who it suits
Kubean suits operators managing customer-controlled Kubernetes clusters across bare metal, virtual machines, or cloud environments. It is also relevant when declarative operations, SSH deployment, or offline packages are required.
On the record
- Architecture
- Kubean runs on an existing Kubernetes cluster and uses Kubespray as its underlying technology.kubean-io.github.io · read 4 Oct 2026
- Architecture support
- Kubean supports multi-architecture delivery, including AMD and ARM, and lists Kunpeng with Kylin compatibility.kubean-io.github.io · read 9 Oct 2026
- Cluster operations
- The documentation describes cluster deployment, worker-node and control-plane scaling, version upgrades, and uninstallation.kubean-io.github.io · read 9 Oct 2026
- Community support
- The roadmap says feature requests can be discussed in project issues and that its schedule depends on community needs.kubean-io.github.io · read 4 Oct 2026
- Custom actions
- Kubean allows custom actions to be added to a cluster without changing Kubespray.kubean-io.github.io · read 9 Oct 2026
- Custom operations
- Cluster operations can run a playbook or shell command, with optional pre-operation and post-operation hooks.kubean-io.github.io · read 4 Oct 2026
- Declarative management
- Kubean uses a declarative API to deploy Kubean and manage Kubernetes cluster lifecycles.kubean-io.github.io · read 9 Oct 2026
- Deployment access
- The documentation describes deploying clusters over SSH and includes an SSH private-key secret option.kubean-io.github.io · read 4 Oct 2026
- Deployment model
- Kubean is designed to run as a container and can be installed with a Helm chart.kubean-io.github.io · read 9 Oct 2026
- Installation
- The maker documents installation as a Helm chart into an existing Kubernetes cluster.kubean-io.github.io · read 4 Oct 2026
- Installation prerequisites
- Installation requires an existing standard or cloud-provider Kubernetes cluster and Helm on the control node or cloud terminal.kubean-io.github.io · read 9 Oct 2026
- Lifecycle operations
- It manages Kubernetes cluster installation, uninstallation, upgrades, and scaling through custom resources and Kubernetes resources.kubean-io.github.io · read 4 Oct 2026
- Offline OS packages
- The offline documentation lists CentOS, Red Hat, Kylin, and Ubuntu OS packages as supported, and says UnionTech V20 packages must be built manually.kubean-io.github.io · read 9 Oct 2026
- Offline repository limits
- The documented local ISO image source currently supports only CentOS, and extra software sources are also currently limited to CentOS.kubean-io.github.io · read 9 Oct 2026
- Offline support
- Kubean releases offline packages for OS packages, images, and binaries.kubean-io.github.io · read 9 Oct 2026
- Offline use
- Kubean supports offline deployment and publishes packages for operating system packages, images, and binaries with releases.kubean-io.github.io · read 4 Oct 2026
- Prerequisite
- The Helm installation guide requires an existing standard or cloud-provider Kubernetes cluster and Helm.kubean-io.github.io · read 4 Oct 2026
- Project affiliation
- The project describes itself as a Cloud Native Computing Foundation sandbox project.kubean-io.github.io · read 9 Oct 2026
