kubeasz README

The project's README from github.com/easzlab/kubeasz. As one markdown file: README.md.

kubeasz-logo conformance-icon

kubeasz 致力于提供快速部署高可用k8s集群的工具, 同时也努力成为k8s实践、使用的参考书;基于二进制方式部署和利用ansible-playbook实现自动化;既提供一键安装脚本, 也可以根据安装指南分步执行安装各个组件。

kubeasz 从每一个单独部件组装到完整的集群,提供最灵活的配置能力,几乎可以设置任何组件的任何参数;同时又为集群创建预置一套运行良好的默认配置,甚至自动化创建适合大规模集群的BGP Route Reflector网络模式。

[news] kubeasz 通过cncf一致性测试 详情

推荐版本对照

Kubernetes 1.33 1.34 1.35 1.36
kubeasz 3.6.7 3.6.8 3.6.10 3.7.0

支持系统

能够支持大部分使用systemd的linux发行版,如果安装有问题先请查看文档;如果某个能够支持安装的系统没有在列表中,欢迎提PR 告知。

快速指南

单机快速体验k8s集群的测试环境--AllinOne部署

安装指南

00-规划集群和配置介绍 02-安装etcd集群 04-安装master节点 06-安装集群网络
01-创建证书和安装准备 03-安装容器运行时 05-安装node节点 07-安装集群插件

使用指南

常用插件+ DNS headlamp metrics-server prometheus efk
集群管理+ 管理node节点 管理master节点 管理etcd节点 升级集群 备份恢复
特性实验 NetworkPolicy RollingUpdate HPA
周边生态 harbor helm jenkins gitlab argocd

沟通交流

贡献&致谢

欢迎提Issues和PRs参与维护项目!感谢您的关注与支持!

Copyright 2017 gjmzj ([email protected]) Apache License 2.0, 详情见 LICENSE 文件。

kubeasz (easzlab/kubeasz)

etcd
Searching Database…

11.4K ·GitHub
What is this?kubeasz is a set of Ansible playbooks that install a full Kubernetes cluster on your own Linux servers, with docs explaining how the components interact. It is packaged to install cleanly from inside mainland China's network.
So is kubeasz a hosted service, or scripts I run on my own servers?Scripts you run yourself: Ansible playbooks execute from your admin machine against your servers, and the resulting cluster is fully self-managed on your own hardware.
How do I get from zero to a working cluster?Follow the numbered install guide: plan the cluster, create certificates, deploy the etcd cluster, the container runtime, master and worker nodes, then the cluster network and plugins. A single-machine All-inOne deployment serves as a quick test environment.
What kind of machines can it install onto?Target nodes must be Linux distros running systemd: the README lists Ubuntu 22.04/24.04, RHEL 8/9, Debian 12/13, Rocky and Alma 8/9, Fedora, openEuler, Kylin V10 and more, and says most systemd distros work.
Which Kubernetes versions will I end up with?Current releases (kubeasz 3.6.7 through 3.7.0) target Kubernetes 1.33 to 1.36, so you get recent cluster versions rather than legacy ones.
Do I need to be a Kubernetes expert to drive it?Linux administration experience is a must; the README recommends further reading such as kubernetes-the-hard-way and feisky's Kubernetes guide, and there is an active WeChat user group for practical questions.
Can I choose the pod network plugin for the cluster?Yes — kubeasz supports flannel, calico and cilium as CNI options, and the install guide includes a dedicated cluster-network step.
What can it deploy besides the core cluster?Common plugins like DNS, headlamp, metrics-server, prometheus and efk logging, plus guides for ecosystem tools such as harbor, helm, jenkins, gitlab and argocd.
Does it help with day-2 operations after install?Yes — the usage guide covers managing node, master and etcd members, upgrading the cluster and backup/restore, plus guided experiments with NetworkPolicy, RollingUpdate and HPA.
Why does the project stress that installs are unaffected by China's network?Many Kubernetes components and images live on endpoints that are slow or blocked from mainland China; kubeasz is packaged so a cluster install completes without depending on them, which is a core selling point of the project.
Creator
easzlab
Size
43.5 MB
Stars
11.4K
Age
8y
Commits · 90 Days