docs: 按实例实际能力判定扩展支持 #10

Merged

panxiao81 merged 1 commits from docs/instance-extension-contract into main 2026-09-14 14:25:54 +00:00

Conversation 0 Commits 1 Files Changed 7

+43 -20

panxiao81 commented 2026-09-14 14:22:43 +00:00

Owner

Copy Link

Copy Source

范围

确认 v1alpha1 的 extension 支持合同，并同步领域设计、API、部署和迁移文档。

• 使用目标 PostgreSQL 实际可安装的扩展列表，不以名称正则代替支持判定。
• 应用层查询列表，Instance 只接收观察结果并做集合判断，不执行外部 IO。
• v1alpha1 暂不实现管理员 allowlist；保留为后续可选策略。
• 区分未观察、查询失败和实例不支持；实际可用不代表安装权限和前置条件满足，安装后仍须回读。
• 列表变化不自动卸载已安装扩展。

本 PR 仅修改文档。现有 allowedExtensions 字段仍在 API types、CRD 和 samples 中，对应移除留给后续实现 PR，不宣称已完成运行行为变更。

验证

• git diff --check：通过。
• 仅文档改动，未运行代码测试。

Refs #1

## 范围 确认 v1alpha1 的 extension 支持合同，并同步领域设计、API、部署和迁移文档。 - 使用目标 PostgreSQL 实际可安装的扩展列表，不以名称正则代替支持判定。 - 应用层查询列表，Instance 只接收观察结果并做集合判断，不执行外部 IO。 - v1alpha1 暂不实现管理员 allowlist；保留为后续可选策略。 - 区分未观察、查询失败和实例不支持；实际可用不代表安装权限和前置条件满足，安装后仍须回读。 - 列表变化不自动卸载已安装扩展。 本 PR 仅修改文档。现有 allowedExtensions 字段仍在 API types、CRD 和 samples 中，对应移除留给后续实现 PR，不宣称已完成运行行为变更。 ## 验证 - git diff --check：通过。 - 仅文档改动，未运行代码测试。 Refs #1

panxiao81 added 1 commit 2026-09-14 14:22:43 +00:00

docs: base extension support on instance capabilities 55869acfd5

panxiao81 merged commit b24b85c31f into main 2026-09-14 14:25:54 +00:00

panxiao81 deleted branch docs/instance-extension-contract 2026-09-14 14:26:06 +00:00

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

No items

No labels

Milestone

No items

No Milestone

Projects

Clear projects

No projects

Assignees

Clear assignees

panxiao81 (Xiao Pan)

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: panxiao81/postgresql-tenant-operator#10