clastix/kamaji

Kamaji

🤔 什么是Kamaji？

Kamaji是一个Kubernetes控制平面管理器，基于托管控制平面概念构建。

Kamaji的核心方法是在Pod中运行Kubernetes控制平面组件，而非专用机器。这使得大规模操作Kubernetes集群成为可能，同时大幅降低运维负担。通过这种方式，运行多个控制平面可以更经济、更易于部署和管理。

Kamaji就像一支由站点可靠性工程师组成的团队，将专业知识编码到逻辑中，全天候工作以确保您的控制平面持续运行。

📖 工作原理

Kamaji通过自定义资源定义（CRD）扩展Kubernetes API能力。

安装Kamaji后，将提供两组新API：

• TenantControlPlane：所需Kubernetes控制平面的实例定义
• Datastore：一个（或多个）TenantControlPlane使用的后端存储

TenantControlPlane（简称tcp）是命名空间作用域的对象，用于配置所需控制平面的各个方面。除Kubernetes配置值外，还可指定Pod选项（如资源限制、请求、容忍度、节点选择器等），以及控制平面的暴露方式（如使用ClusterIP、LoadBalancer或NodePort）。

TenantControlPlane是控制平面的无状态定义，用于设置完整Kubernetes集群所需的组件。状态由Datastore API管理，这是一种集群作用域资源，可存储一个或多个Kubernetes集群的数据。

有关API规范和所有可用选项的更多信息，请参考官方API参考。

⭐️ 核心功能

• 快速配置时间：根据基础设施不同，租户控制平面可在16秒内启动并准备提供服务。
• 简化更新：租户控制平面升级到新Kubernetes版本仅需10秒，采用蓝绿部署避免混合Kubernetes版本运行。
• 资源优化：通过数据存储解耦，无需奇数个实例（如RAFT共识），可节省高达60%的硬件资源。
• 从零扩展到大规模：在无使用时缩容实例，或利用Kubernetes模式自动扩缩以应对流量峰值。
• 声明式方法与持续调和：基于Operator模式，实时检测配置漂移，维持期望状态。
• 自动证书管理：利用kubeadm自动创建和轮换证书。
• 管理核心插件：自动配置kube-proxy、CoreDNS和konnectivity，并在用户错误（如删除CoreDNS部署）时自动修复。
• 自动恢复：Kamaji跟踪管理集群中的TenantControlPlane对象，若被删除，将以幂等方式重新创建所有组件。
• 数据存储多租户：支持单个Datastore资源存储多个Kubernetes集群数据，降低运维成本。
• 突破etcd限制：通过https://github.com/k3s-io/kine%E6%94%AF%E6%8C%81%60MySQL%60%E3%80%81%60PostgreSQL%60%E6%88%96%60NATS%60%E4%BD%9C%E4%B8%BA%E6%9B%BF%E4%BB%A3%E6%95%B0%E6%8D%AE%E5%AD%98%E5%82%A8%E3%80%82
• 简化混合网络设置：借助Konnectivity，使控制平面与不同网络中的工作节点连接，解决非路由IP地址节点（如边缘环境工作节点）的通信问题。

🚀 使用场景

• 创建私有托管Kubernetes服务
• 构建平台即服务（PaaS）
• 突破公共托管Kubernetes服务限制（如EKS）
• 混合基础设施：根据需求将控制平面部署在云端，工作节点部署在本地，或反之。
• 边缘Kubernetes：充分利用"Kubernetes API服务器即服务"范式。
• Kubernetes控制平面即服务：从单个管理点集中管理多个Kubernetes集群（多集群管理）。
• 高密度控制平面：在同一基础设施上部署多个控制平面，无需为每个控制平面分配专用机器。
• 强多租户隔离：允许用户以管理员权限访问控制平面，同时在基础设施层面保持隔离。
• Kubernetes嵌套：使用Kubernetes管理Kubernetes，开箱即得自动化、高可用性、容错和自动扩缩能力。
• 自带设备（BYOD）：保持控制平面与数据平面隔离，工作节点可从任何位置（云、边缘、数据中心）加入并一致运行。
• 完全CNCF兼容：所有集群均使用上游Kubernetes二进制文件构建，符合CNCF标准。

🧑‍💻‍ 生产级可用性

Kamaji已被多家企业采用，并有公开的用户案例。查看采用者文件了解更多信息。

🤗 若您正在使用Kamaji，欢迎通过PR分享您的使用经验！

🍦 原生Kubernetes集群

Kamaji不是另一个Kubernetes发行版：您可完全自由地为最终用户选择技术栈。Kamaji是平台工程的理想选择，为开发人员和DevOps工程师隐藏控制平面管理的复杂性。

提供的Kubernetes控制平面是CNCF兼容集群。

🐢 Cluster API支持

Kamaji不是Cluster API的替代品，而是与其良好兼容。

由于Kamaji专注于控制平面管理，已开发https://github.com/clastix/cluster-api-control-plane-provider-kamaji%E3%80%82

🛣️ 路线图

• 负载均衡器动态地址
• 租户控制平面零停机升级
• 通过Konnectivity实现工作节点远程加入
• 替代数据存储（MySQL、PostgreSQL、NATS）
• 多数据存储池
• 数据存储无缝迁移
• 自动分配数据存储
• 租户控制平面自动扩缩
• https://github.com/clastix/cluster-api-control-plane-provider-kamaji
• Terraform提供程序
• 自定义Prometheus指标

🎥 多媒体资源

• 播放列表 ▶️ Dario Tranchitella（CLASTIX）的教程与操作指南
• *** ▶️ Metal³与Kamaji托管控制平面部署（Huy Mai，Ericsson）
• *** ▶️ Kamaji实践入门
• *** ▶️ 将Kubernetes扩展到1000个控制平面
• *** ▶️ Equinix、Kamaji与Cluster API
• *** ▶️ Rancher & Kamaji：解决Kubernetes多租户挑战
• *** ▶️ 通过Kamaji和Paralus实现自助式Kubernetes集群
• *** ▶️ Kamaji与K0mostron实现Kubernetes托管控制平面（Hervé Leclerc，ALTER WAY）

🏷️ 版本控制

版本控制遵循语义化版本原则。所有可用版本列表见GitHub仓库的https://github.com/clastix/kamaji/releases%E3%80%82

📄 文档

更多文档可在官方Kamaji文档网站查看。

🤝 贡献

非常欢迎并鼓励贡献！

若发现bug，请先查看https://github.com/clastix/kamaji/issues%E7%A1%AE%E8%AE%A4%E6%98%AF%E5%90%A6%E5%B7%B2%E5%AD%98%E5%9C%A8%E7%9B%B8%E5%85%B3%E9%97%AE%E9%A2%98%E3%80%82%E8%8B%A5%E4%B8%8D%E5%AD%98%E5%9C%A8%EF%BC%8C%E5%8F%AF%E6%96%B0%E5%BB%BAissue%EF%BC%9A%E8%AF%A6%E7%BB%86%E7%9A%84%E6%8A%A5%E5%91%8A%E5%B0%86%E5%B8%AE%E5%8A%A9%E6%88%91%E4%BB%AC%E5%A4%8D%E7%8E%B0%E3%80%81%E8%AF%84%E4%BC%B0%E5%B9%B6%E4%BF%AE%E5%A4%8D%E9%97%AE%E9%A2%98%E3%80%82

您可自行修复bug并提交PR。提交信息需符合https://github.com/projectcapsule/capsule/blob/main/CONTRIBUTING.md#semantics%E3%80%82%E6%8F%90%E4%BA%A4%E8%AE%B0%E5%BD%95%E5%B0%86%E7%94%A8%E4%BA%8E%E7%94%9F%E6%88%90%E5%8F%98%E6%9B%B4%E6%97%A5%E5%BF%97%EF%BC%8C%E4%BD%9C%E8%80%85%E4%BF%A1%E6%81%AF%E5%B0%86%E8%A2%AB%E5%BC%95%E7%94%A8%E3%80%82

如需✨ 功能请求，请使用https://github.com/clastix/kamaji/discussions/categories/feature-requests%E3%80%82

📝 许可证

Kamaji Cluster API控制平面提供程序采用Apache 2.0许可证。代码按"原样"提供，不提供任何担保。

🛟 商业支持

!CLASTIX CLASTIX是Kamaji和Cluster API控制平面提供程序背后的商业公司。

如果您计划在生产环境中运行Kamaji并希望了解更多信息，CLASTIX可通过提供开源支持计划提供帮助，同时提供基于Kamaji和Capsule（现已***给CNCF作为沙箱项目）构建的企业平台CLASTIX Enterprise Platform。

欢迎通过联系表单与我们取得联系。