main
Reviewed-on: #182
Merge pull request 'chore(deps): update actions/setup-go action to v7.1.0' (#182) from renovate/actions-setup-go-7.x into main
Ayatori
Infrastructure, woven by intent. 意図から、インフラを編む。
Ayatori 是 ddupan.top homelab 的内部基础设施控制平面。它以 Kubernetes API
作为统一资源模型,通过薄适配器组合成熟后端,并让机器执行器与人工操作共同推动
实际状态持续收敛到声明的期望状态。
本仓库公开源代码,但当前只面向一个确定的内部环境。它不是通用私有云发行版,暂不 承诺开箱即用、后端可替换性或面向第三方的兼容性。
核心原则
- 内部专用只缩小需求与兼容范围,不降低软件工程质量。
- 优先采用可以立即投入使用的成熟后端,不重新实现复杂的数据面。
- 平台统一入口、策略、组合、状态与生命周期;后端保留领域实现。
- 应用通过 GitOps 直接组合正交的平台原语,不引入
ApplicationService上帝控制器。 - Pod、OpenSandbox、Terraform、Ansible 和人都可以成为 executor。
- 暂时不能自动化的操作必须被建模、追踪并验证,而不是遗落在文档和记忆中。
- 控制面中断不得破坏已运行的数据面。
文档
总体设计:
领域文档:
- Database
- LoadBalancer 领域模型
- Compute:PoC 记录见 docs/compute
- Job API 草案(未实现,见下文)
架构决策(ADR):
| ADR | 标题 | 状态 |
|---|---|---|
| 0001 | 采用 Kubernetes API machinery 作为状态协调平面 | Accepted |
| 0002 | 采用 k0s 与可选工作负载运行时 | 部分被 0013 取代 |
| 0003 | 直接连接 Dev API 的开发循环 | 部分被 0013 取代 |
| 0004 | 可拆分的模块化 Controller 架构 | Accepted |
| 0005 | Job 使用短生命周期控制对象与 TTL 回收 | Accepted |
| 0006 | 按实际管理缺口扩展资源 API | Accepted |
| 0007 | 复用 Node API 建立按需实现的 Compute 能力 | Accepted,VM API/Agent/HA 部分由 0015 修订 |
| 0008 | 将 PostgreSQL Tenant Operator 合并为 Database 模块 | Accepted |
| 0009 | 分离 Database 资源与 Tenant 申请 | Accepted |
| 0010 | Tenant 凭据交付止于 OpenBao 位置公布 | Accepted |
| 0011 | Bucket 由 CI Terraform 管理 | Accepted |
| 0012 | 以独立 L4 LoadBalancer 统一 VIP 与入口 | Accepted,宣告部分被 0017 取代 |
| 0013 | Dev/Prod 以 LXC 上的 API-only 控制面运行 | Accepted |
| 0014 | KaaS 以 CAPI 管理集群,Ayatori 供应跨后端节点 | Proposed |
| 0015 | 自建 libvirt/LXC 计算后端,冷启动由节点自治 | Proposed |
| 0016 | 实例的节点侧服务 | Proposed |
| 0017 | VIP 宣告由 LB 主机本地决定 | Accepted |
| 0018 | 后端与 LB 主机成为 API 资源 | Accepted |
| 0021 | 控制面客户端凭据以 CSR 签发与自行续签 | Accepted(续签待到期观察) |
| 0022 | LB agent 加入控制面,watch 资源并在本机收敛 | Proposed |
| 0023 | LoadBalancer 与 Backend 的 status 呈现后端健康 | Proposed |
| 0024 | 组件共用版本号,部署允许有限的版本偏差 | Proposed |
| 0025 | LB agent 开启 BGP graceful restart | Accepted |
0019、0020 编号由 dev/compute 分支上的计算后端 ADR 占用,尚未合入 main。
当前状态
Dev 与 Prod 均运行 v0.3.0-rc.3(API-only 控制面,ADR-0013;由 Chef cookbook homelab_ayatori
部署)。各模块进度:
| 模块 | API group | 状态 |
|---|---|---|
| Database | database.ayatori.ddupan.top |
已上线(v0.1.0 起)。homelab-infra 的 GitOps 目录申请 PostgreSQLTenant/Database,凭据交付到 OpenBao |
| LoadBalancer | network.ayatori.ddupan.top |
v0.3.0 预发布,Prod 已承载 sandbox 入口。HAProxy(Data Plane API)+ lb-agent 进程内 GoBGP 宣告 VIP,可选 PowerDNS 名称 |
| Compute | compute.ayatori.ddupan.top(规划) |
ADR-0014/0015/0016 Proposed,PoC 01–15 已完成,Compute Agent 在 dev/compute 分支开发中 |
| Job | execution.ayatori.ddupan.top |
只有 API 与 CRD;controller 未合入,暂停 |
Bucket/Object Storage 由 CI Terraform 管理,不进入 Ayatori(ADR-0011)。
Description
The internal infrastructure control plane of the ddupan.top homelab
6.3 MiB
0 Stars
1 Watchers
0 Forks