2.2 KiB
2.2 KiB
v0.2 Postgres 稳定外部服务规格
hwlab-v02-postgres 是 v02 独立 Postgres StatefulSet,使用外部稳定镜像 postgres:16-alpine 的本地 registry 版本,内部端口 5432。
在系统中的职责划分
- 为
hwlab-cloud-api提供 v02 独立 durable runtime store、migration ledger、agent/gateway/evidence 等持久化表。 - 与
hwlab-dev/hwlab-prod数据隔离;v02 使用独立 namespace、Service、PVC、database/user 和 SecretRef。 - 不向公网开放,不由普通用户或 Code Agent 直连。
内部架构
StatefulSet/hwlab-v02-postgres挂载dataPVC 到/var/lib/postgresql/data。ConfigMap/hwlab-v02-postgres-init提供初始化 SQL 和hwlab_schema_migrationsledger。Secret/hwlab-v02-postgres提供POSTGRES_PASSWORD;Secret/hwlab-cloud-api-v02-db提供 cloud-api 使用的database-url。Service/hwlab-v02-postgres提供 ClusterIP DNS。
API 接口说明
| 接口 | 说明 |
|---|---|
TCP hwlab-v02-postgres.hwlab-v02.svc.cluster.local:5432 |
Postgres wire protocol,仅内部服务使用。 |
POSTGRES_DB=hwlab_v02、POSTGRES_USER=hwlab_v02 |
v02 独立数据库身份。 |
hwlab-cloud-api /health/live DB readiness |
对外展示 DB env、schema、auth、readiness 和 migration ledger,不打印 Secret。 |
测试规格
T1
阅读 docs/reference/spec-v02-postgres.md,然后用 cli 手动测试以下内容:查询 StatefulSet、Service、PVC 和 SecretRef 名称,确认全部在 hwlab-v02 namespace,且不输出 Secret 值。
T2
阅读 docs/reference/spec-v02-postgres.md,然后用 cli 手动测试以下内容:访问 hwlab-cloud-api /health/live,确认 DB readiness ready、runtime adapter 为 Postgres、migration ledger 存在。
规格的实现情况
| 规格项 | 状态 | 说明 |
|---|---|---|
| 独立 StatefulSet/PVC | 已实现 | hwlab-v02-postgres 在 v02 namespace。 |
| 初始化 schema/migration ledger | 已实现 | ConfigMap 包含 0001_cloud_core_skeleton。 |
| cloud-api DB SecretRef | 已实现 | hwlab-cloud-api-v02-db/database-url。 |
| 自动备份/恢复 | 未实现 | 当前 spec 未定义备份服务。 |
| 多副本 HA | 未实现 | 当前为单副本 StatefulSet。 |