refactor: 分离 Database 资源与申请并撤除 registry #9

2026-09-24T16:36:10Z

panxiao81 commented

2026-09-24 16:36:10 +00:00

目的

按维护者确认的设计，借鉴 Kubernetes PV/PVC 的资源与申请生命周期分离，撤销额外的 PostgreSQL ownership registry。

变更

ADR-0009：Instance → Database → Tenant；Database 自带 instanceRef，手工登记不依赖 Tenant。动态申请选择 Instance，引用已有资源则使用资源声明的 Instance。
Retain 保留独立 Database，显式导入和人工授权重新绑定；未知同名资源及不确定创建结果报告可诊断的 Conflict。
同步系统规格、领域/API、部署、安全、运维和测试合同。资源 scope、绑定协议和凭据交接细节仍待细化，不宣称三资源链路已实现。
移除 registry adapter、SQL 迁移、专属测试、tern 及相关间接依赖。
移除 Instance 的 InitializingRegistry、RegistryState 和准备/回读接口；完整管理能力观察直接判定 Ready，失败撤销就绪证据。
保留凭据、TLS、metadata 集成路径，补充各管理能力在首次验证/重验时的失败与恢复测试。

基线与合并顺序

#8 已合并，本 PR 已切换到 main；包含设计修订、registry 撤除和 CI 去重三个提交。不向 #2 叠加改动。

验证

make test：通过；Instance 领域覆盖率 100%。
make lint、make lint-database-integration：均为 0 issues。
make test-database-integration：真实 API server/etcd + 隔离 PostgreSQL，race 检查通过。
Ayatori 文档链接检查及 git diff --check：通过。
未连接或删除现有数据库；原 PostgreSQL Tenant Operator 工作树未修改。

配套文档

homelab-wiki PR：panxiao81/homelab-wiki#3
设计同步 d8f20c0，撤除状态及来源链接 78d0a8c；wiki 检查通过。

分支名沿用实验阶段的 registry-inspection，但本 PR 实际撤除 registry，不包含该实验实现。

CI 触发修订

f347ee5 移除 main push 的重复全量验证，保留 pull_request 与 workflow_dispatch。所有 job 和步骤不变；直接推送 main 不自动检查，基线有实质变化时需更新分支并重验。YAML 解析及 jobs 不变校验已通过；最新 head 由 CI #781 验证。

## 目的按维护者确认的设计，借鉴 Kubernetes PV/PVC 的资源与申请生命周期分离，撤销额外的 PostgreSQL ownership registry。 ## 变更 - ADR-0009：Instance → Database → Tenant；Database 自带 instanceRef，手工登记不依赖 Tenant。动态申请选择 Instance，引用已有资源则使用资源声明的 Instance。 - Retain 保留独立 Database，显式导入和人工授权重新绑定；未知同名资源及不确定创建结果报告可诊断的 Conflict。 - 同步系统规格、领域/API、部署、安全、运维和测试合同。资源 scope、绑定协议和凭据交接细节仍待细化，不宣称三资源链路已实现。 - 移除 registry adapter、SQL 迁移、专属测试、tern 及相关间接依赖。 - 移除 Instance 的 InitializingRegistry、RegistryState 和准备/回读接口；完整管理能力观察直接判定 Ready，失败撤销就绪证据。 - 保留凭据、TLS、metadata 集成路径，补充各管理能力在首次验证/重验时的失败与恢复测试。 ## 基线与合并顺序 #8 已合并，本 PR 已切换到 main；包含设计修订、registry 撤除和 CI 去重三个提交。不向 #2 叠加改动。 ## 验证 - make test：通过；Instance 领域覆盖率 100%。 - make lint、make lint-database-integration：均为 0 issues。 - make test-database-integration：真实 API server/etcd + 隔离 PostgreSQL，race 检查通过。 - Ayatori 文档链接检查及 git diff --check：通过。 - 未连接或删除现有数据库；原 PostgreSQL Tenant Operator 工作树未修改。 ## 配套文档 homelab-wiki PR：https://git.ddupan.top/panxiao81/homelab-wiki/pulls/3 设计同步 d8f20c0，撤除状态及来源链接 78d0a8c；wiki 检查通过。分支名沿用实验阶段的 registry-inspection，但本 PR 实际撤除 registry，不包含该实验实现。 ## CI 触发修订 f347ee5 移除 main push 的重复全量验证，保留 pull_request 与 workflow_dispatch。所有 job 和步骤不变；直接推送 main 不自动检查，基线有实质变化时需更新分支并重验。YAML 解析及 jobs 不变校验已通过；最新 head 由 CI #781 验证。

panxiao81 changed target branch from feat/database-metadata-observation to main

2026-09-24 16:51:48 +00:00

panxiao81 added 2 commits 2026-09-24 16:51:48 +00:00

docs: 分离 Database 资源与 Tenant 申请生命周期 6db8a495fb

refactor: 移除 Database registry 与 Instance 初始化依赖

Verify / lint (pull_request) In progress

Details

Verify / database-integration (pull_request) In progress

Details

Verify / test (pull_request) Successful in 11m8s

Details

23a2d81b50

panxiao81 added 1 commit 2026-09-24 16:58:24 +00:00

ci: 避免 main 合并后重复全量验证

Verify / test (pull_request) In progress

Details

Verify / lint (pull_request) In progress

Details

Verify / database-integration (pull_request) In progress

Details

f347ee5292

Some checks are pending

Verify / test (pull_request) In progress

Details

Verify / lint (pull_request) In progress

Details

Verify / database-integration (pull_request) In progress

Details

You are not authorized to merge this pull request.

This pull request can be merged automatically.

This branch is out-of-date with the base branch

View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.

git fetch -u origin feat/database-registry-inspection:feat/database-registry-inspection

git checkout feat/database-registry-inspection

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: panxiao81/ayatori#9