From adf28127678a6cdfe2e6b064e2b11733ce19d2bf Mon Sep 17 00:00:00 2001 From: panxiao81 Date: Sun, 20 Sep 2026 19:42:35 +0000 Subject: [PATCH] =?UTF-8?q?=E8=AE=B0=E5=BD=95=E5=86=85=E7=BD=AE=20API=20?= =?UTF-8?q?=E4=B8=8E=E5=AE=9E=E7=8E=B0=E7=BB=84=E4=BB=B6=E8=A7=A3=E8=80=A6?= =?UTF-8?q?=E5=8E=9F=E5=88=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- architecture/ayatori-control-plane.md | 5 +++++ architecture/constraints.md | 1 + 2 files changed, 6 insertions(+) diff --git a/architecture/ayatori-control-plane.md b/architecture/ayatori-control-plane.md index 289bfb0..fac8860 100644 --- a/architecture/ayatori-control-plane.md +++ b/architecture/ayatori-control-plane.md @@ -19,6 +19,11 @@ Kubernetes workload 集群只是与 OpenSandbox、Proxmox 等并列的 backend/e 领域 API 不得默认依赖同集群 Pod、Job、Service、NetworkPolicy、namespace 共置或 owner reference；跨后端能力必须由领域 API 和 adapter 契约明确表达。 +Kubernetes 内置资源也只是可选择复用的 API contract，不绑定其传统实现组件。例如 Ayatori +可以让 Compute Agent 更新 `core/v1 Node` 和 Lease，并由自有 controller 调度 VM，而不部署 +kubelet、Pod、CRI 或 kube-scheduler。每个复用资源都必须单独明确 producer、consumer、 +ownership、采用字段和有意舍弃的上游语义。 + 当前选择继续使用 kube-apiserver + CRD。generic-apiserver 或聚合 API Server 不会替代领域 controller，只会让项目额外接管资源服务端、watch、RBAC、API 兼容和存储迁移责任。只有 CRD 或 kube-apiserver 的限制形成经过验证的阻碍时，才重新评估自建 API Server。 diff --git a/architecture/constraints.md b/architecture/constraints.md index 38f4543..3ee9492 100644 --- a/architecture/constraints.md +++ b/architecture/constraints.md @@ -7,6 +7,7 @@ | 约束 | 原因与边界 | 来源 | |---|---|---| | Ayatori 复用 Kubernetes API machinery，不复用其容器编排产品边界 | kube-apiserver/etcd 提供 API、watch、RBAC 与状态协调；领域调度、生命周期、恢复和 GC 属于 Ayatori controllers；Kubernetes workload 只是可替换 backend | [Ayatori 控制面边界](ayatori-control-plane.md) | +| Kubernetes 内置资源不绑定上游实现组件 | 可由 Ayatori Agent/controller 实现和消费 Node、Lease 等 API；使用 Node 不推导必须部署 kubelet、Pod 或 kube-scheduler | [Ayatori 控制面边界](ayatori-control-plane.md) | | Ayatori 只为已验证的管理缺口新增北向资源 | 当前优先 Database、LoadBalancer、Bucket/Object Storage；VM 价值已确认但南向较重；Run 是内部切片，KaaS 按需，FaaS/PaaS 默认不做 | [Ayatori 控制面边界](ayatori-control-plane.md) | | Samba AD、OCI、Proxmox 优先 IaC，以代码为准 | Ansible/Terraform 声明及任务优先于旧 README；声明不等于已验证部署 | 维护者于 2026-09-16 明确、各服务使用指南 | | 服务独立部署，Terraform root/state 按服务隔离 | 避免认证和变更影响范围绑在一起 | `AGENTS.md`、`CLAUDE.md` |