kubean-io
kubean
Go

:seedling: Product ready cluster lifecycle management toolchains based on kubespray and other cluster LCM engine.

Last updated Jul 3, 2026
528
Stars
51
Forks
12
Issues
0
Stars/day
Attention Score
85
Language breakdown
Go 63.4%
Shell 31.5%
Python 3.3%
Dockerfile 0.9%
Makefile 0.6%
Go Template 0.3%
Files click to expand
README

:seedling: Kubean

简体中文

k8s conformance kubean

Kubean is a production-ready cluster lifecycle management toolchain based on kubespray and other cluster LCM engine.

main workflow codecov Best Practices kubean coverage kubean coverage license Go Report Card FOSSA Status



Kubean is a Cloud Native Computing Foundation sandbox project.

:anchor: Awesome features

  • Simplicity: Deploying of Kubean and powerful lifecycle management of kubernetes cluster implementing by declarative API.
  • Offline Supported: Offline packages(os-pkgs, images, binarys) are released with the release. You won't have to worry about how to gather all the resources you need.
  • Compatibility: Multi-arch delivery Supporting. Such as AMD, ARM with common Linux distributions. Also include Kunpeng with Kylin.
  • Expandability: Allowing custom actions be added to cluster without any changes for Kubespray.

:surfing_man: Quick start

Killercoda tutorials

We created a scenario on killercoda, which is an online platform for interactive technique learning. You can try it in there.

Guided install with KubeStellar Console

KubeStellar Console offers a guided installation mission for Kubean with step-by-step instructions, pre-flight checks, validation, troubleshooting tips, and rollback support.

Local install

  • Ensure that you have a Kubernetes cluster running, on which Helm is installed
  • Deploy kubean-operator
helm repo add kubean-io https://kubean-io.github.io/kubean-helm-chart/
   helm install kubean kubean-io/kubean --create-namespace -n kubean-system

Then check kubean-operator status by running:

kubectl get pods -n kubean-system
  • Online deploy an all-in-one cluster with minimal configuration
1. A simple way is to use AllInOne.yml, replacing <IP1>, <USERNAME>, and other strings with actual values.

2. Start kubeanClusterOps to run the kubespray job.

kubectl apply -f examples/install/1.minimal

3. Check the kubespray job status.

kubectl get job -n kubean-system

quick start

:ocean: Kubernetes compatibility

| Kubean Version | Kubernetes Version Range | Kubernetes Default Version | kubespray SHA | | :-----: | :-----------: | :-----: | :-----: | | v0.34.2 | v1.33 ~ v1.35 | v1.34.7 | a254f5e | | v0.33.2 | v1.33 ~ v1.35 | v1.33.8 | e3b5c41 | | v0.32.4 | v1.32 ~ v1.34 | v1.32.9 | 8dacb9c | | v0.31.0 | v1.32 ~ v1.34 | v1.32.9 | b9e1e85 | | v0.30.2 | v1.32 ~ v1.34 | v1.32.9 | 5dce75d | | v0.29.1 | v1.31 ~ v1.33 | v1.32.9 | fbf957a | | v0.28.5 | v1.31 ~ v1.33 | v1.31.6 | 13c70d3 | | v0.27.3 | v1.31 ~ v1.33 | v1.31.6 | 502ba66 | | v0.26.4 | v1.31 ~ v1.33 | v1.31.6 | 739e5e1 | | v0.25.2 | v1.30 ~ v1.32 | v1.31.6 | d0e9088 | | v0.24.2 | v1.30 ~ v1.32 | v1.31.6 | 4ad9f9b | | v0.23.9 | v1.30 ~ v1.32 | v1.31.6 | a4843ea | | v0.22.5 | v1.29 ~ v1.31 | v1.30.5 | d173f1d |

To check the list of Kubernetes versions supported by Kubean, refer to the Kubernetes versions list.

:book: Roadmap

For detailed information about all the planned features, refer to the roadmap.

:book: Documents

Please visit our website: kubean-io.github.io/kubean/

:envelope: Join us

You can connect with us on the following channels:

  • Slack: join the #Kubean channel on CNCF Slack by requesting an invitation from CNCF Slack. Once you have access to CNCF Slack, you can join the Kubean channel.
  • Email: refer to the MAINTAINERS.md to find the email addresses of all maintainers. Feel free to contact them via email to report any issues or ask questions.

:thumbsup: Contributors


Copyright The Kubean Authors
We are a Cloud Native Computing Foundation sandbox project.
The Linux Foundation® (TLF) has registered trademarks and uses trademarks.
For a list of TLF trademarks, see Trademark Usage.


Kubean enriches the CNCF CLOUD NATIVE Landscape.

🔗 More in this category

© 2026 GitRepoTrend · kubean-io/kubean · Updated daily from GitHub