架构
Alauda Data Services Relational Database E3 将上游 CNPG operator 与镜像仓库镜像以及符合 ACP 要求的 RBAC 打包在一起。以下架构适用于上游发行版和 Alauda 发行版;与 ACP 相关的扩展会在适用处特别说明。
目录
核心组件CRD 概览集群拓扑高可用性与故障转移存储模型镜像目录模型ACP RBAC 架构Alauda Data Services Relational Database E3 与 Alauda PostgreSQL(Zalando-track)对比商标声明核心组件
-
Operator 控制器 (
cnpg-controller-manager)- 在
cnpg-system命名空间中运行单个 Deployment,并监视所有命名空间(AllNamespaces 安装模式)。 - 协调 CNPG 自定义资源:
Cluster、Backup、ScheduledBackup、Pooler、Database、Publication、Subscription、ImageCatalog、ClusterImageCatalog。 - 管理集群生命周期:创建、扩展、配置更新、故障转移时提升主节点,以及 PG Pod 的滚动升级。
- Kubernetes 原生:与封装 Patroni 并依赖单独分布式共识存储(etcd、ZooKeeper)的旧版 operator 不同,CNPG 仅使用 Kubernetes 原语(Leases、Endpoints)实现主节点/备用节点协调。
- 在
-
Instance Manager(Pod 内 sidecar)
- 每个 PostgreSQL Pod 运行一个,通过 gRPC 与 operator 通信。
- 负责本地 PostgreSQL 生命周期:启动/停止服务器、应用配置、管理 WAL 归档。
- 将实例状态(恢复模式、复制延迟、磁盘用量)报告给 operator。
- 无需单独运行 Patroni 进程,也不再依赖 etcd。
-
PostgreSQL 容器镜像
- Alauda 发行版:PostgreSQL 14、15、16、17、18 使用
build-harbor.alauda.cn/middleware/cnpg/postgresql:<MM.mm>-{minimal,standard}-trixie。 - 等效上游版本:
ghcr.io/cloudnative-pg/postgresql:<MM.mm>-{system,minimal,standard}-trixie。 - 标准变体:包含 pgaudit、pgvector、pg-failover-slots、postgis(支持的情况下)。
- 精简变体:仅包含 PostgreSQL;适用于单独添加扩展的场景。
- 两种变体均提供多架构版本(amd64 + arm64)。
- Alauda 发行版:PostgreSQL 14、15、16、17、18 使用
-
连接池 / PgBouncer
- 可选的
PoolerCR 会在 Cluster 前面创建一个 PgBouncer Deployment。 - 镜像:
registry-dev.alauda.io/eco-oss/postgres/cnpg/pgbouncer:1.25.2-202610260735-trixie。 - 模式:
session、transaction、statement。由上游 PgBouncer 提供支持。
- 可选的
-
Barman Cloud Plugin(独立的同级软件包,Alpha 阶段之后)
- 用于对象存储备份的 CNPG-I 插件,采用 pgBackRest 语义。
- 作为
cloudnative-pg-barman-cloud-pluginACP 软件包提供;不与 operator 软件包捆绑。
CRD 概览
集群拓扑
包含 instances: 3 的 Cluster CR 会生成:
每个实例都是独立的 StatefulSet 风格 Pod,并拥有自己的 PVC。没有共享存储;复制采用流式 WAL。
系统会自动创建三个 Service:
高可用性与故障转移
- 主节点选举:operator 在启动时以及发生故障转移时选举主节点。选举使用 Kubernetes Lease 对象进行分布式协调。
- 故障转移触发条件:Pod 丢失、节点丢失、复制堆积量超过阈值,或通过
cluster.spec.targetPrimary由 operator 发起切换。 - 故障转移时间:通常为个位数秒。operator 通过实例管理器心跳检测主节点故障,通过
pg_promote提升一个从节点,并更新<cluster>-rwService 端点以重定向流量。 - 同步复制:可通过
spec.minSyncReplicas和spec.maxSyncReplicas配置,要求 N 个备用节点在每次写入被视为持久化之前进行确认。 - 无脑裂:operator 的提升逻辑基于 K8s API 层的共识;在原主节点仍被视为存活时,不会提升第二个主节点。
存储模型
- 每个实例对应一个 PVC,实例 N 的 PVC 命名为
<cluster>-N。 - StorageClass 通过
spec.storage.storageClass按 Cluster 设置(CNPG 不回退到集群默认值)。 - 卷大小通过
spec.storage.size设置。 - 回收策略:
Delete通常用于临时测试集群;生产环境建议使用Retain。该策略在 StorageClass 本身上设置。 - WAL 归档:独立的
spec.walStorage块(可选)会将 WAL 路由到不同的卷/StorageClass,以实现性能隔离。
镜像目录模型
ImageCatalog 和 ClusterImageCatalog CR 允许集群 operator 集中管理 PostgreSQL 镜像版本:
随后,Cluster 可以按主版本引用该目录:
这样可以将 Cluster CR 规范与具体的镜像标签解耦,从而简化跨集群舰队的 PostgreSQL 升级。
ACP RBAC 架构
Alauda Data Services Relational Database E3 提供五角色 L5 RBAC 体系,并接入 ACP namespace-admin / namespace-developer 聚合链:
每个角色都有一个公开的 shell ClusterRole(携带 ACP 目标角色聚合标签)以及一个或多个 base ClusterRole(携带实际规则)。只有当 base 角色同时包含两个标签(目标角色 + 作用域)时,ACP 的 AND 匹配器聚合才会生效。集群范围的资源(ClusterImageCatalog)存放在专用的 cluster-scope:*-base ClusterRole 中。
Alauda Data Services Relational Database E3 与 Alauda PostgreSQL(Zalando-track)对比
这两个 operator 相互独立,可以在同一集群中共存(使用不同的 namespace 和不同的 CRD group)。两者之间的迁移通过逻辑复制或备份/恢复完成,而不是原地迁移。
商标声明
CloudNativePG™ 是 The Linux Foundation 的商标。
PostgreSQL® 是 PostgreSQL Community Association of Canada 的注册商标。
Alauda 是独立供应商。本产品与 The Linux Foundation、PostgreSQL Community Association of Canada 没有关联,也未获得其认可或赞助。所有商标均归其各自所有者所有,本文仅将其用于标识目的。