overall_design.md

方案设计

整体架构

模块说明：

• http server：提供用户交互的HTTP接口以及友好的前端管理界面，使用户能够轻松进行操作和配置
• infra-manager：负责创建和删除基础设施
• config-manager：管理集群配置信息，包括创建、更新、删除等操作
• cert-manager：负责创建和更新集群及节点证书，维护系统安全，确保证书的有效性和合规性
• healthz-worker：实时监测系统的健康状况，及时发现并报告问题，确保系统稳定可靠的运行
• installer：执行系统点火阶段的任务，负责部署和创建K8S集群
• HKO (Housekeeper Operator)：部署在集群中，负责集群级操作的组件
• HKD (Housekeeper Daemon)：集成在NestOS镜像中，属于HKO的组成部分
• 镜像构建工具链：用于构建NestOS镜像的工具链，支持系统的自定义镜像生成
• 配置仓库：存储和管理配置信息的数据库
• 容器镜像仓库：用于存储和管理私有化部署的容器镜像，保障应用程序的可靠性和安全性

备注：http server、healthz-worker、配置仓库暂未支持

详细设计

NKD模块交互关系图

config-manager模块设计

NKD部署集群提供了不同的应用配置方式，以方便不同的用户使用这款部署工具。

• 体验部署一个基础集群，仅部署一个master和worker节点的小型集群，配置项参数使用默认配置，这样可以直接执行部署命令，且不用添加任何配置项；
• 更精细化的配置各项参数，通过应用配置文件部署高可用集群；
• 更灵活方便的配置集群，通过添加命令行参数部署高可用集群。

命令行参数的优先级最高，配置文件次之。如果部署集群同时应用了配置文件和命令行参数，在配置参数项相同时，命令行参数会将配置文件内容覆盖。 如果用户没有配置参数，NKD会自动生成该项参数或者使用默认配置，例如集群证书、Ignition文件等。config-manager模块会纳管集群的所有配置项参数，并存储在磁盘中。NKD部署集群依赖项如图：

cert-manager模块设计

集群节点的创建、资源的访问都依赖证书，NKD在集群外创建证书并本地存储ca证书和admin.conf文件，更详细内容见设计文档，创建完成的证书通过Ignition文件写入到节点机器。证书创建流程如图：

Ignition模块设计

NKD在创建基础设施时，需要通过ignition点火机制传入系统部署后所需的动态配置，详细内容见设计文档。并且支持通过命令行参数或配置文件将用户配置转换为ignition文件。节点在部署完成操作系统引导后，通过Ignition机制在操作系统引导阶段自动完成集群创建，无需手动干预。集群各节点的Ignition文件创建流程如图：

housekeeper模块设计

在集群部署阶段，用户可以选择是否部署housekeeper 详细内容见设计文档