2026-09-17 18:58:11 +00:00
2026-09-17 18:58:11 +00:00
2026-11-04 07:21:55 +00:00
2026-09-17 18:58:11 +00:00

Ayatori

Infrastructure, woven by intent. 意図から、インフラを編む。

Ayatori 是 ddupan.top homelab 的内部基础设施控制平面。它以 Kubernetes API 作为统一资源模型,通过薄适配器组合成熟后端,并让机器执行器与人工操作共同推动 实际状态持续收敛到声明的期望状态。

本仓库公开源代码,但当前只面向一个确定的内部环境。它不是通用私有云发行版,暂不 承诺开箱即用、后端可替换性或面向第三方的兼容性。

核心原则

  • 内部专用只缩小需求与兼容范围,不降低软件工程质量。
  • 优先采用可以立即投入使用的成熟后端,不重新实现复杂的数据面。
  • 平台统一入口、策略、组合、状态与生命周期;后端保留领域实现。
  • 应用通过 GitOps 直接组合正交的平台原语,不引入 ApplicationService 上帝控制器。
  • Pod、OpenSandbox、Terraform、Ansible 和人都可以成为 executor。
  • 暂时不能自动化的操作必须被建模、追踪并验证,而不是遗落在文档和记忆中。
  • 控制面中断不得破坏已运行的数据面。

文档

总体设计:

领域文档:

架构决策(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)。

S
Description
The internal infrastructure control plane of the ddupan.top homelab
Readme
6.3 MiB
0 Stars 1 Watchers 0 Forks
v0.4.0
Latest
2026-11-12 04:58:58 +00:00
Languages
Go 97.6%
Makefile 1.6%
Shell 0.6%
Dockerfile 0.2%