Compare commits
3
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
 panxiao81
|
aae6138fa5
|
||
|
panxiao81
|
42bcf8190e | ||
|
panxiao81
|
0eb3f81726
|
@@ -1,46 +0,0 @@
|
||||
---
|
||||
title: Ayatori 控制面边界
|
||||
last_reviewed: 2026-09-20
|
||||
---
|
||||
|
||||
# Ayatori 控制面边界
|
||||
|
||||
Ayatori 是规划和早期实现中的 homelab 基础设施控制平面。它使用 kube-apiserver、etcd、CRD
|
||||
和 Kubernetes API machinery 作为版本化 API 与状态协调平面，主要复用对象并发控制、
|
||||
list/watch、informer、RBAC、admission、审计和 API 版本机制，而不是复用 Kubernetes 的容器
|
||||
编排产品边界。
|
||||
|
||||
Ayatori controller-manager 负责领域资源的调度、生命周期、故障恢复、垃圾回收和后端收敛。
|
||||
这部分职责近似 Kubernetes 的 controller-manager，但面向 VM、LB、数据库、对象存储、任务、
|
||||
托管 Kubernetes 和人工操作等 Ayatori 领域。
|
||||
|
||||
Kubernetes workload 集群只是与 OpenSandbox、Proxmox 等并列的 backend/executor，可能位于
|
||||
远端，也可能在某个部署 profile 中不存在。除 Flux、Ayatori controllers 等管理组件的部署外，
|
||||
领域 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。
|
||||
|
||||
Ayatori 不按传统私有云产品目录建设。当前已确认的首要管理缺口是 Database、LoadBalancer 与
|
||||
Bucket/Object Storage；VirtualMachine 同样具有明确价值，但需要组合 Proxmox API、节点受限
|
||||
Agent/CLI 和人工任务。当前 Job controller 是控制循环与 adapter 的验证切片，长期只可能收敛为
|
||||
内部 Run 能力，不构成 FaaS、Cloud Run 或应用托管承诺。KaaS 只有出现实际需求时才评估，不是
|
||||
产品路线的必达终点。
|
||||
|
||||
Compute 方向已被记录但延后实施：选择性复用 `core/v1 Node` 与 Lease，由 Ayatori Compute Agent
|
||||
实现节点状态并由自有 controller 调度，不引入 kubelet、Pod 或 kube-scheduler。长期 VM 主路径
|
||||
可以是普通 Linux 节点上的 libvirt/QEMU；Proxmox 用于 brownfield adopt 和过渡。OpenSandbox/Kata
|
||||
microVM 属于 Run/Sandbox 的隔离实现，不因此成为 VirtualMachine 资源。
|
||||
|
||||
详细设计以 Ayatori 仓库的
|
||||
[ADR-0001](https://git.ddupan.top/panxiao81/ayatori/src/branch/main/docs/decisions/0001-kubernetes-api-machinery.md)
|
||||
、[ADR-0006](https://git.ddupan.top/panxiao81/ayatori/src/branch/main/docs/decisions/0006-demand-driven-resource-scope.md)
|
||||
和[总体架构](https://git.ddupan.top/panxiao81/ayatori/src/branch/main/docs/architecture/overview.md)为准。
|
||||
本页记录跨 homelab 的稳定边界，不表示 Ayatori 已部署或达到生产可用状态。
|
||||
@@ -1,15 +1,10 @@
|
||||
# 架构约束索引
|
||||
|
||||
审阅日期：2026-09-20。以下是现有仓库明确记录的约束摘要；Ayatori 条目来自其独立项目的
|
||||
已接受设计，其余来源路径相对于 homelab-infra。修改时必须读原文和对应代码，新出现的差异
|
||||
先向维护者确认；[首轮状态对齐](../verification.md)已完成。
|
||||
审阅日期：2026-09-16。以下是现有仓库明确记录的约束摘要，不是本轮新增的架构决策。
|
||||
来源路径相对于 homelab-infra；修改时必须读原文和对应代码，新出现的差异先向维护者确认；[首轮状态对齐](../verification.md)已完成。
|
||||
|
||||
| 约束 | 原因与边界 | 来源 |
|
||||
|---|---|---|
|
||||
| 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) |
|
||||
| Ayatori Compute 复用 Node/Lease API，但不引入 Kubernetes workload plane | Compute Agent 实现 Node 状态；libvirt 是长期候选主路径，PVE 是 brownfield 过渡；Kata microVM 属于 Sandbox backend | [Ayatori 控制面边界](ayatori-control-plane.md) |
|
||||
| Samba AD、OCI、Proxmox 优先 IaC，以代码为准 | Ansible/Terraform 声明及任务优先于旧 README；声明不等于已验证部署 | 维护者于 2026-09-16 明确、各服务使用指南 |
|
||||
| 服务独立部署，Terraform root/state 按服务隔离 | 避免认证和变更影响范围绑在一起 | `AGENTS.md`、`CLAUDE.md` |
|
||||
| OpenBao 恢复不能依赖 k3s 或读取自己内部的恢复凭据 | 先恢复信任根，再恢复消费者 | `infrastructure/openbao/README.md`、`CLAUDE.md` |
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: 按任务查找文档
|
||||
last_reviewed: 2026-09-20
|
||||
last_reviewed: 2026-09-18
|
||||
---
|
||||
|
||||
# 按任务查找文档
|
||||
@@ -10,7 +10,6 @@ last_reviewed: 2026-09-20
|
||||
|
||||
| 要做什么 | 先读 | 需要时再读 |
|
||||
|---|---|---|
|
||||
| 设计或实现 Ayatori 控制面能力 | [Ayatori 控制面边界](../architecture/ayatori-control-plane.md) | Ayatori 仓库 ADR、对应领域 API 与 adapter 文档 |
|
||||
| 发布新的 LAN Web 服务 | [发布新服务](publish-service.md) | [DNS](../services/lan-dns.md)、[Authelia](../services/authelia.md) |
|
||||
| 写 CI 或选择 Pod/VM runner | [Gitea / Actions](../services/gitea.md) | [Dynamic Runner](../services/gitea-dynamic-runner.md)、[SPIFFE](../services/spire.md) |
|
||||
| 为 CI 缓存 Ansible/Go 依赖 | [Nexus POC](../services/nexus.md) | [Dynamic Runner](../services/gitea-dynamic-runner.md)、[OpenBao](../services/openbao.md) |
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
title: Gitea Dynamic Runner
|
||||
lifecycle: experimental
|
||||
evidence: documented
|
||||
last_reviewed: 2026-09-21
|
||||
last_reviewed: 2026-09-16
|
||||
last_verified: null
|
||||
sources:
|
||||
- https://git.ddupan.top/panxiao81/gitea-dynamic-runner/src/branch/main/README.md
|
||||
@@ -48,23 +48,13 @@ runs-on: [self-hosted, vm]
|
||||
|
||||
| 接口 | 执行方式 | 使用时需要理解的边界 |
|
||||
|---|---|---|
|
||||
| `pod` | 动态 Kubernetes privileged Pod；workflow 使用 host executor | 旧 README 要求 pipeline 按需 setup Docker；Docker 的新约定见下文。host executor 指 Pod 内执行环境 |
|
||||
| `pod` | 动态 Kubernetes privileged Pod；workflow 使用 host executor | Docker、BuildKit、kind 等工具由 pipeline 按需 setup；这里的 host executor 指 Pod 内执行环境 |
|
||||
| `vm` | 动态 Cloud Hypervisor microVM | 每个任务创建独立 COW disk、seed 和 TAP，guest runner 执行一个 job 后关机并清理 |
|
||||
|
||||
两种接口不能仅凭“环境一次性”就认定具有相同的隔离边界。
|
||||
接入前需要结合项目设计约束和实际部署确认任务的信任范围。
|
||||
旧 homelab-infra 文档中的 `kind-microvm` 是早期记录，不作为本项目当前 workflow 接口。
|
||||
|
||||
### Docker 可用性约定更新
|
||||
|
||||
维护者于 2026-09-21 明确：CI 后端正在修复，后续由 runner 保证 dockerd 默认可用。
|
||||
这取代旧说明中要求业务 workflow 自行启动 Docker daemon 的部分；不能据此推断 BuildKit、
|
||||
kind 等其他工具也默认就绪。数据库集成测试不因使用 Docker 而要求 VM。
|
||||
消费方 workflow 应检查 Docker 是否可用，而不重复启动 daemon、强制 storage driver 或
|
||||
覆盖 runner 提供的 endpoint。[Ayatori #6](https://git.ddupan.top/panxiao81/ayatori/pulls/6)
|
||||
正在按此约定调整。此处依据维护者说明，不表示后端修复已经部署或远端集成已经通过，
|
||||
`last_verified` 保持不变。
|
||||
|
||||
## 组件如何协作
|
||||
|
||||
当前 README 描述的 bootstrap 路径为：
|
||||
|
||||
+1
-1
@@ -22,7 +22,7 @@ SPIFFE/SPIRE 已按维护者授权补读 #34；LAN DNS 与 Authelia 已按维护
|
||||
| [marker](marker.md) | GPU 文档转换 API | `集群内端口 8001` | 配置与部署指南；未附上线记录 | `apps/marker/README.md` | 已有转换示例；部署镜像仍为占位符 |
|
||||
| netboot | PXE 与系统安装 | `192.168.10.127` | 有部署及使用记录 | `apps/netboot/README.md` | 已有客户端启动说明 |
|
||||
| [netbox](netbox.md) | 网络资产与地址管理评估 | `netbox.ad.ddupan.top` | 记录已部署；评估用途 | `apps/netbox/README.md` | 已有浏览与 Git 修改入口指南 |
|
||||
| [nexus](nexus.md) | CI 包代理与统一制品仓库 POC | `nexus.ad.ddupan.top` | 仅有未提交配置，尚未部署验证 | `apps/nexus/README.md` | 先验收 Ansible/Go，再补 OCI 声明式管理与 BuildKit 测试 |
|
||||
| [nexus](nexus.md) | CI 包代理与统一制品仓库 POC | `nexus.ad.ddupan.top` | 2026-09-20 已现场验证 Ansible、Go、OCI 与 BuildKit cache | `apps/nexus/README.md` | 补 publisher account、外部 PostgreSQL 与备份恢复测试 |
|
||||
| [openviking](openviking.md) | 上下文检索服务 | `记录端口 1933 / 8020` | 配置与部署指南；未附上线记录 | `apps/openviking/README.md` | 已有导入、任务查询、检索与原文读取指南 |
|
||||
| [ps3netsrv](ps3netsrv.md) | PS3 网络内容服务 | `宿主 TCP 38008；地址未记录` | Docker 运维文档记录运行 | `apps/ps3netsrv/docker-compose.yml` | 已有客户端与内容目录指南 |
|
||||
| [seaweedfs](seaweedfs.md) | S3 对象存储 | `s3.ad.ddupan.top` | zot 文档记录已使用 | `apps/seaweedfs/README.md` | 已有客户端读写指南与备份边界说明 |
|
||||
|
||||
+43
-20
@@ -1,24 +1,27 @@
|
||||
---
|
||||
title: Nexus Repository POC
|
||||
lifecycle: experimental
|
||||
evidence: configuration
|
||||
last_reviewed: 2026-09-18
|
||||
last_verified: null
|
||||
evidence: live-verified
|
||||
last_reviewed: 2026-09-20
|
||||
last_verified: 2026-09-20
|
||||
sources: []
|
||||
---
|
||||
|
||||
# Nexus Repository POC
|
||||
|
||||
Nexus Repository Community Edition POC 计划为一次性 CI runner 提供共享的 Ansible Galaxy、
|
||||
Go Modules 与 OCI/BuildKit 缓存，减少每个 job 从公网重新下载依赖的时间。当前只有未提交的
|
||||
GitOps 与 Terraform 配置，尚未部署、初始化或完成端到端验证；现役 zot 保持不变。
|
||||
Nexus Repository Community Edition POC 为一次性 CI runner 提供共享的 Ansible Galaxy、
|
||||
Go Modules、OCI 与 BuildKit 缓存，减少每个 job 从公网重新下载依赖的时间。GitOps 已部署，
|
||||
上述代理与缓存链路均已完成现场验证；数据库和备份仍是 POC，现役 zot 保持不变。
|
||||
|
||||
## 从哪里使用
|
||||
|
||||
- 计划入口：`https://nexus.ad.ddupan.top`，仅 LAN。
|
||||
- 人类管理：POC 首次使用本地管理员；后续正式化优先使用 Samba AD LDAP。Community
|
||||
- 入口：`https://nexus.ad.ddupan.top`，仅 LAN。
|
||||
- 人类管理：当前使用本地管理员，凭据受管于 OpenBao `kv/infra/nexus`；尚未配置 LDAP。
|
||||
后续正式化优先使用 Samba AD LDAP。Community
|
||||
Edition 不提供原生 OIDC/SAML，因此不能把 Authelia OIDC 写成已支持入口。
|
||||
- CI 读取：目标是对 public/group repository 开放 LAN 匿名只读。
|
||||
- CI 读取：`ansible-public`、Ansible 返回制品 URL 使用的成员 proxy 与 `go-public` 已开放
|
||||
LAN 匿名只读；`oci-public` 与其 `oci-proxy` 成员同样匿名只读，`oci-hosted` 不开放匿名。
|
||||
Terraform 明确收窄权限，未使用默认的全仓库匿名角色。
|
||||
- CI 发布：目标是少量按信任边界划分的本地 service account，凭据由 OpenBao 保存；
|
||||
当前 POC 尚未创建 publisher 或授予写权限。
|
||||
|
||||
@@ -45,8 +48,9 @@ ansible-galaxy collection install -r collections/requirements.yml \
|
||||
-p .ansible/collections
|
||||
```
|
||||
|
||||
预期首次请求从上游获取 collection，第二次在全新 runner 中由 Nexus 返回已缓存内容。
|
||||
该预期尚未现场验证；验证时同时记录冷/热耗时和 Nexus 日志，不能只看命令退出码。
|
||||
2026-09-20 使用两个全新客户端目录下载 `community.general:11.2.0`：冷缓存 8.49 秒、
|
||||
热缓存 1.89 秒，两份 tarball SHA-256 一致。Nexus Ansible format 返回的制品 URL 指向
|
||||
成员 proxy，因此匿名角色必须同时具备 group 与该 proxy 的只读权限。
|
||||
|
||||
Go POC 使用：
|
||||
|
||||
@@ -57,15 +61,30 @@ GOPROXY=https://nexus.ad.ddupan.top/repository/go-public/ go mod download
|
||||
私有 module 的 `GOPRIVATE`、认证和 fallback 需由实际 workflow 明确配置，不能把内部 module
|
||||
路径意外发送到公共 proxy。
|
||||
|
||||
2026-09-20 使用两个全新 Go module cache 下载 `golang.org/x/[email protected]`：冷缓存
|
||||
2.92 秒、热缓存 1.51 秒，均通过 `go-public` 匿名入口完成。
|
||||
|
||||
OCI 使用 path-based routing。公共镜像从
|
||||
`nexus.ad.ddupan.top/oci-public/<namespace>/<image>:<tag>` 匿名拉取；写入使用
|
||||
`nexus.ad.ddupan.top/oci-hosted/<namespace>/<image>:<tag>` 并要求认证。2026-09-20 验证：
|
||||
|
||||
- Alpine 代理冷拉 4.75 秒、热拉 0.80 秒，digest 一致；
|
||||
- hosted push/pull 成功，匿名 pull 返回 401；
|
||||
- amd64/arm64 OCI image index 可 push 与 inspect；
|
||||
- Helm OCI chart push/pull digest 及本地 tarball SHA-256 一致；
|
||||
- Cosign 签名和公钥验证成功，OCI 1.1 referrers 返回一个 Sigstore bundle；
|
||||
- BuildKit `mode=max` registry cache 成功导出；销毁首个 builder 后，新 builder 从 Nexus
|
||||
导入缓存，两个 `RUN` step 均命中 `CACHED`。
|
||||
|
||||
## POC 限制
|
||||
|
||||
- 单副本、50 GiB OpenEBS RWO PVC，资源上限 2 CPU / 4 GiB。
|
||||
- 当前使用 embedded H2，仅用于 POC；正式保存唯一制品前迁移至外部 PostgreSQL。
|
||||
- 当前没有独立备份或恢复验收，PVC 不能被视为备份。
|
||||
- Terraform provider 已声明 Ansible 与 Go proxy/group；provider 1.17.0 尚未暴露 Nexus
|
||||
3.94 新增的原生 OCI repository resource。
|
||||
- OCI 必须在补齐声明式 REST/provider 管理后再测试，不保留仅通过 UI 创建的长期配置。
|
||||
- BuildKit registry cache 有待单独验证，普通 OCI image push 成功不能替代该测试。
|
||||
- Terraform provider 管理 Ansible/Go、Realm 与权限；provider 1.17.0 尚未暴露 Nexus 3.94
|
||||
新增的原生 OCI repository resource，因此 OCI 仓库由实例 Swagger 固定 schema 的幂等 REST
|
||||
调和器管理，不通过 UI 留下非声明式配置。
|
||||
- 尚未创建正式 publisher service account；本轮写入测试临时使用受管管理员凭据。
|
||||
|
||||
## 出问题时
|
||||
|
||||
@@ -83,8 +102,8 @@ WAN，不以重建 PVC 作为排障手段。
|
||||
|
||||
## 运维入口
|
||||
|
||||
实现入口为 homelab-infra 工作区中尚未提交的 `apps/nexus/` 与
|
||||
`clusters/homelab/apps/nexus.yaml`。DNS 期望记录位于 `infrastructure/dns/records.yml`。
|
||||
实现入口为 homelab-infra 已合并的 `apps/nexus/` 与
|
||||
`clusters/homelab/apps/nexus.yaml`。DNS 记录位于 `infrastructure/dns/records.yml`。
|
||||
源码 README 维护部署、初始化、Terraform、验收与恢复边界。
|
||||
|
||||
部署依赖 Envoy Gateway、OpenEBS 和 LAN DNS；Terraform 管理依赖 Nexus 初始化后的受限管理
|
||||
@@ -92,6 +111,10 @@ WAN，不以重建 PVC 作为排障手段。
|
||||
|
||||
## 当前状态与证据
|
||||
|
||||
2026-09-18 已准备未提交的 Kubernetes、Flux、DNS 与 Terraform POC 配置，并完成本地渲染和
|
||||
schema 检查后方可交付；未访问现场、未部署 Nexus、未申请凭据，也未修改或迁移 zot。
|
||||
后续状态必须以合并记录、Flux 状态和客户端冷/热缓存验收分别更新，不能仅凭本页推断上线。
|
||||
2026-09-20 现场确认 Flux Kustomization Ready、Nexus Pod Ready、50 GiB PVC Bound，HTTPRoute
|
||||
经 HTTPS 状态 API 返回 200；Samba DNS apply 后复查 `changed=0`。Terraform 已创建 Ansible、
|
||||
Go proxy/group、OCI Bearer Token Realm 和最小匿名只读角色，二次 plan 为 `No changes`；OCI
|
||||
REST 调和器复查三个仓库均为 `in sync`。Ansible、Go、OCI、Helm、Cosign/referrers 与
|
||||
BuildKit cache 的上述客户端测试均成功。实现来源为 homelab-infra PR #103、#108 与 #109。
|
||||
尚未验证备份恢复或外部 PostgreSQL，也未创建正式 publisher account、修改或迁移 zot，
|
||||
因此本页的 `live-verified` 仅覆盖已明确列出的 POC 范围。
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
title: PostgreSQL Tenant Operator（计划中的 DBaaS）
|
||||
lifecycle: planned
|
||||
evidence: documented
|
||||
last_reviewed: 2026-09-20
|
||||
last_reviewed: 2026-09-16
|
||||
last_verified: null
|
||||
sources:
|
||||
- https://git.ddupan.top/panxiao81/postgresql-tenant-operator
|
||||
@@ -26,45 +26,10 @@ homelab 资源有限，为每个应用维护一套数据库会浪费资源。绝
|
||||
|
||||
## 当前进度
|
||||
|
||||
维护者于 2026-09-20 提供的阶段状态如下：
|
||||
|
||||
- 已合并 Instance 的 Endpoint、凭据引用、身份/版本、定义与观测目标等值对象；
|
||||
- 已合并扩展支持能力模型，以及 Instance 最小生命周期与状态 checkpoint；
|
||||
- CI PR #14 已合并：lint/test 使用 Pod runner，e2e 使用 VM runner；当前没有开放 PR；
|
||||
- 上述领域基础尚未接入实际运行链路，不能理解为新设计已经可用；
|
||||
- 仍缺完整 Ready 判定、Kubernetes Secret 管理凭据与连接刷新、应用层/数据库 adapter/controller
|
||||
接入、CRD 与批准规格对齐及集成验证；
|
||||
- Tenant 的完整创建、凭据交付和 Retain/Delete 生命周期仍未完成；
|
||||
- 旧运行链路仍包含直接读取 OpenBao 管理凭据的逻辑。
|
||||
|
||||
本地暂停在 `feature/instance-extension-observations`，有两个未提交文件，实现 Instance 接收扩展
|
||||
观测及其测试。该部分此前只通过领域包 lint，未运行本地测试、未提交、未推送；分支仍基于 #13，
|
||||
未包含刚合并的 CI 改动。该工作区必须原样保留，不能作为已合并能力或迁移来源。
|
||||
|
||||
已批准的设计合同不等于已经实现的功能，本文不表示 DBaaS 已上线。生成的 CRD/API 与 samples
|
||||
仍可能落后于批准规格，不能直接作为最终使用接口。
|
||||
|
||||
2026-09-20，维护者决定将该项目合并为 Ayatori 的 Database 领域模块。已批准的规格、领域模型、
|
||||
状态机和测试继续作为迁移合同；不会把独立仓库的 manager、生成文件和当前工作树整仓复制。
|
||||
首个迁移基线使用包含已合并 Instance 领域基础与 CI #14 的最新 main commit，再按领域层、API、
|
||||
adapter 和 controller 的纵向切片进入 Ayatori；暂停中的两个未提交文件不进入首个切片。旧仓库
|
||||
在迁移完成并验收前仍是现有设计与代码的来源，本决定不表示 DBaaS 已上线。
|
||||
|
||||
维护者同时确认目前没有可用版本，也没有 PostgreSQL 实例或 Tenant 被该 operator 托管。因此
|
||||
合并不承担旧运行链路、旧 CRD/status 或数据的兼容责任：直接读取 OpenBao 管理凭据的旧路径可以
|
||||
删除，未投入使用且落后于规范的 CRD/samples/实现结构不保留兼容层。
|
||||
|
||||
源项目已批准的系统规格、API 语义、Instance/Tenant 领域模型、状态机、ownership registry、
|
||||
凭据交付、Retain/Delete、恢复和测试设计整体直接复用为 Ayatori DBaaS 合同。大胆重构针对旧运行
|
||||
实现和项目装配，不表示可以静默改变这些已批准行为；合同变化仍须先修订规格并单独评审。
|
||||
|
||||
原 `database.ddupan.top/v1alpha1` API group 也不保留。Ayatori 中的目标 API 使用
|
||||
`database.ayatori.ddupan.top/v1alpha1`，并纳入统一的 `api/database/v1alpha1` 与 Database 模块
|
||||
结构；由于不存在已部署消费者，不建立 alias 或 conversion 入口。
|
||||
|
||||
合并边界记录在 Ayatori PR
|
||||
[#3 的 ADR-0008](https://git.ddupan.top/panxiao81/ayatori/src/commit/33fb3ec9725dca8a10f2ad4bcd71cf83413932ee/docs/decisions/0008-merge-postgresql-tenant-operator.md)；
|
||||
该决定已于 2026-09-21 合并 main，链接固定到合并版本；设计合并不表示 Database 实现已完成。
|
||||
2026-09-16 查阅[项目 README](https://git.ddupan.top/panxiao81/postgresql-tenant-operator/src/branch/main/README.md)
|
||||
与架构文档时，项目记录为 **API 骨架阶段，尚未对 PostgreSQL 或 OpenBao 执行写操作**。
|
||||
已批准的设计合同不等于已经实现的功能，本文不表示 DBaaS 已上线。
|
||||
项目首页还注明 `config/samples` 保留旧 API 骨架，不能将其直接当作最终使用接口。
|
||||
|
||||
## 计划中的使用方式
|
||||
|
||||
@@ -98,6 +63,5 @@ GitOps、Terraform、kubectl 和未来 Backstage 计划共用这套 Kubernetes A
|
||||
- [部署](https://git.ddupan.top/panxiao81/postgresql-tenant-operator/src/branch/main/docs/deployment.md)与[安全](https://git.ddupan.top/panxiao81/postgresql-tenant-operator/src/branch/main/docs/security.md)：依赖和权限。
|
||||
- [迁移](https://git.ddupan.top/panxiao81/postgresql-tenant-operator/src/branch/main/docs/migration.md)与[运维](https://git.ddupan.top/panxiao81/postgresql-tenant-operator/src/branch/main/docs/operations.md)：现有数据库、删除和恢复合同。
|
||||
|
||||
迁移前的具体实现进度仍回到[项目仓库](https://git.ddupan.top/panxiao81/postgresql-tenant-operator)
|
||||
查询；迁移后的实现与发布进度转到 Ayatori。后续查询前先向维护者对齐当前工作与 ticket。
|
||||
本页保留设计定位和带日期的阶段摘要。
|
||||
具体实现进度回到[项目仓库](https://git.ddupan.top/panxiao81/postgresql-tenant-operator)查询，
|
||||
后续查询前先向维护者对齐当前工作与 ticket。本页保留设计定位和带日期的阶段摘要。
|
||||
|
||||
Reference in New Issue
Block a user