kubeasz/README.md

115 lines
4.9 KiB
Markdown
Raw Normal View History

2019-07-11 10:08:33 +08:00
# ![kubeasz](pics/logo_kubeasz.png)
2017-11-11 19:14:21 +08:00
2019-06-23 07:45:30 +08:00
项目致力于提供快速部署高可用`k8s`集群的工具, 同时也努力成为`k8s`实践、使用的参考书;基于二进制方式部署和利用`ansible-playbook`实现自动化;既提供一键安装脚本, 也可以根据`安装指南`分步执行安装各个组件。
2017-11-11 19:14:21 +08:00
2022-06-24 19:50:06 +08:00
- **集群特性** `TLS`双向认证、`RBAC`授权、[Master高可用](docs/setup/00-planning_and_overall_intro.md#ha-architecture)、支持`Network Policy`、[离线安装](docs/setup/offline_install.md)
2022-09-17 11:25:09 +08:00
- **集群版本** kubernetes v1.22, v1.23, v1.24, v1.25
- **操作系统** CentOS/RedHat 7, Debian 9/10, Ubuntu 16.04/18.04/20.04/22.04
- **运行时** [containerd](docs/setup/03-container_runtime.md) v1.6.8, docker 20.10.x (k8s < 1.24)
2019-05-27 00:04:00 +08:00
- **网络** [calico](docs/setup/network-plugin/calico.md), [cilium](docs/setup/network-plugin/cilium.md), [flannel](docs/setup/network-plugin/flannel.md), [kube-ovn](docs/setup/network-plugin/kube-ovn.md), [kube-router](docs/setup/network-plugin/kube-router.md)
2017-11-28 21:13:21 +08:00
2021-03-25 20:34:13 +08:00
2022-01-05 12:43:03 +08:00
**[news]** kubeasz 通过cncf一致性测试 [详情](docs/mixes/conformance.md)
2021-03-27 00:09:42 +08:00
推荐版本对照
2017-11-26 18:46:02 +08:00
2021-08-14 22:09:08 +08:00
<table>
<thead>
<tr>
<td>Kubernetes version</td>
<td>1.20</td>
<td>1.21</td>
<td>1.22</td>
2022-01-05 12:43:03 +08:00
<td>1.23</td>
2022-06-08 19:35:55 +08:00
<td>1.24</td>
2022-09-17 11:25:09 +08:00
<td>1.25</td>
2021-08-14 22:09:08 +08:00
</tr>
</thead>
<tbody>
<tr>
<td>kubeasz version</td>
2021-08-14 22:09:08 +08:00
<td>3.0.1</td>
<td>3.1.0</td>
<td>3.1.1</td>
2022-01-05 12:43:03 +08:00
<td>3.2.0</td>
2022-06-24 19:50:06 +08:00
<td>3.3.1</td>
2022-09-17 11:25:09 +08:00
<td>3.4.0</td>
2021-08-14 22:09:08 +08:00
</tr>
</tbody>
</table>
## 快速指南
单机快速体验k8s集群的测试环境--[AllinOne部署](docs/setup/quickStart.md)
2018-10-12 17:43:59 +08:00
## 安装指南
2017-11-26 18:46:02 +08:00
2018-05-11 10:03:07 +08:00
<table border="0">
<tr>
2019-06-23 07:45:30 +08:00
<td><a href="docs/setup/00-planning_and_overall_intro.md">00-规划集群和配置介绍</a></td>
2018-10-12 13:30:19 +08:00
<td><a href="docs/setup/02-install_etcd.md">02-安装etcd集群</a></td>
<td><a href="docs/setup/04-install_kube_master.md">04-安装master节点</a></td>
<td><a href="docs/setup/06-install_network_plugin.md">06-安装集群网络</a></td>
2018-05-11 10:03:07 +08:00
</tr>
<tr>
2018-10-12 13:30:19 +08:00
<td><a href="docs/setup/01-CA_and_prerequisite.md">01-创建证书和安装准备</a></td>
2021-01-20 17:42:46 +08:00
<td><a href="docs/setup/03-container_runtime.md">03-安装容器运行时</a></td>
2018-10-12 13:30:19 +08:00
<td><a href="docs/setup/05-install_kube_node.md">05-安装node节点</a></td>
<td><a href="docs/setup/07-install_cluster_addon.md">07-安装集群插件</a></td>
2018-05-11 10:03:07 +08:00
</tr>
</table>
2017-11-26 18:46:02 +08:00
2017-12-03 16:26:33 +08:00
## 使用指南
2018-05-11 10:03:07 +08:00
<table border="0">
<tr>
2018-11-02 17:21:59 +08:00
<td><strong>常用插件</strong><a href="docs/guide/index.md">+</a></td>
2018-10-12 17:43:59 +08:00
<td><a href="docs/guide/kubedns.md">DNS</a></td>
2018-06-23 22:50:27 +08:00
<td><a href="docs/guide/dashboard.md">dashboard</a></td>
<td><a href="docs/guide/metrics-server.md">metrics-server</a></td>
<td><a href="docs/guide/prometheus.md">prometheus</a></td>
2018-11-02 17:21:59 +08:00
<td><a href="docs/guide/efk.md">efk</a></td>
2018-05-11 10:03:07 +08:00
</tr>
<tr>
2018-11-02 17:21:59 +08:00
<td><strong>集群管理</strong><a href="docs/op/op-index.md">+</a></td>
2019-06-08 16:07:46 +08:00
<td><a href="docs/op/op-node.md">管理node节点</a></td>
<td><a href="docs/op/op-master.md">管理master节点</a></td>
<td><a href="docs/op/op-etcd.md">管理etcd节点</a></td>
2018-07-21 10:31:25 +08:00
<td><a href="docs/op/upgrade.md">升级集群</a></td>
<td><a href="docs/op/cluster_restore.md">备份恢复</a></td>
2018-05-11 10:03:07 +08:00
</tr>
<tr>
<td><strong>特性实验</strong></td>
<td><a href="docs/guide/networkpolicy.md">NetworkPolicy</a></td>
<td><a href="docs/guide/rollingupdateWithZeroDowntime.md">RollingUpdate</a></td>
<td><a href="docs/guide/hpa.md">HPA</a></td>
<td><a href=""></a></td>
<td><a href=""></a></td>
</tr>
<tr>
2018-10-12 17:43:59 +08:00
<td><strong>周边生态</strong></td>
<td><a href="docs/guide/harbor.md">harbor</a></td>
<td><a href="docs/guide/helm.md">helm</a></td>
<td><a href="docs/guide/jenkins.md">jenkins</a></td>
2019-01-23 22:37:29 +08:00
<td><a href="docs/guide/gitlab/readme.md">gitlab</a></td>
2018-10-12 17:43:59 +08:00
<td><a href=""></a></td>
2019-10-01 23:01:25 +08:00
</tr>
2018-05-11 10:03:07 +08:00
</table>
2017-12-02 23:24:42 +08:00
2018-03-18 23:19:55 +08:00
## 沟通交流
2018-10-12 17:43:59 +08:00
- 微信群k8s&kubeasz实践, 搜索微信号`badtobone`, 请备注(城市-github用户名, 验证通过会加入群聊。
2019-12-26 20:45:47 +08:00
- 推荐阅读
2022-06-24 19:50:06 +08:00
- [kubernetes架构师课程](https://www.toutiao.com/c/user/token/MS4wLjABAAAA0YFomuMNm87NNysXeUsQdI0Tt3gOgz8WG_0B3MzxsmI/?tab=article)
2019-12-26 20:45:47 +08:00
- [kubernetes-the-hard-way](https://github.com/kelseyhightower/kubernetes-the-hard-way)
- [feisky-Kubernetes 指南](https://github.com/feiskyer/kubernetes-handbook/blob/master/SUMMARY.md)
- [opsnull 安装教程](https://github.com/opsnull/follow-me-install-kubernetes-cluster)
2018-05-06 23:10:14 +08:00
## 贡献&致谢
2017-11-26 18:46:02 +08:00
2021-03-25 19:22:38 +08:00
请阅读[项目分支说明](docs/mixes/branch.md), 欢迎提[Issues](https://github.com/easzlab/kubeasz/issues)和[PRs](docs/mixes/HowToContribute.md)参与维护项目!感谢您的关注与支持!
2018-10-28 22:22:08 +08:00
- [如何 PR](docs/mixes/HowToContribute.md)
2019-03-05 22:39:56 +08:00
- [如何捐赠](docs/mixes/donate.md)
2017-11-26 17:47:40 +08:00
2018-10-12 17:43:59 +08:00
Copyright 2017 gjmzj (jmgaozz@163.com) Apache License 2.0, 详情见 [LICENSE](docs/mixes/LICENSE) 文件。