架构

参考:CloudNativePG 项目文档。

Alauda Data Services Relational Database E3 将上游 CNPG operator 与镜像仓库镜像以及符合 ACP 要求的 RBAC 打包在一起。以下架构适用于上游发行版和 Alauda 发行版;与 ACP 相关的扩展会在适用处特别说明。

核心组件

  1. 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)实现主节点/备用节点协调。
  2. Instance Manager(Pod 内 sidecar)

    • 每个 PostgreSQL Pod 运行一个,通过 gRPC 与 operator 通信。
    • 负责本地 PostgreSQL 生命周期:启动/停止服务器、应用配置、管理 WAL 归档。
    • 将实例状态(恢复模式、复制延迟、磁盘用量)报告给 operator。
    • 无需单独运行 Patroni 进程,也不再依赖 etcd。
  3. 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)。
  4. 连接池 / PgBouncer

    • 可选的 Pooler CR 会在 Cluster 前面创建一个 PgBouncer Deployment。
    • 镜像:registry-dev.alauda.io/eco-oss/postgres/cnpg/pgbouncer:1.25.2-202610260735-trixie。
    • 模式:session、transaction、statement。由上游 PgBouncer 提供支持。
  5. Barman Cloud Plugin(独立的同级软件包,Alpha 阶段之后)

    • 用于对象存储备份的 CNPG-I 插件,采用 pgBackRest 语义。
    • 作为 cloudnative-pg-barman-cloud-plugin ACP 软件包提供;不与 operator 软件包捆绑。

CRD 概览

CRDGroup / Kind用途
Clusterpostgresql.cnpg.io/v1顶层 PostgreSQL 集群定义(主节点 + 从节点)
Backuppostgresql.cnpg.io/v1对 Cluster 执行一次性物理备份
ScheduledBackuppostgresql.cnpg.io/v1类 Cron 的定期备份
Poolerpostgresql.cnpg.io/v1位于 Cluster 前端的 PgBouncer 连接池
Databasepostgresql.cnpg.io/v1在 Cluster 内以声明方式创建数据库
Publicationpostgresql.cnpg.io/v1逻辑复制发布者端点
Subscriptionpostgresql.cnpg.io/v1逻辑复制订阅者端点
ImageCatalogpostgresql.cnpg.io/v1命名空间级 PostgreSQL 镜像目录
ClusterImageCatalogpostgresql.cnpg.io/v1Cluster 范围的 PostgreSQL 镜像目录

集群拓扑

包含 instances: 3 的 Cluster CR 会生成:

cluster-example-1     (primary, accepts writes)
cluster-example-2     (replica, streaming from primary)
cluster-example-3     (replica, streaming from primary)

每个实例都是独立的 StatefulSet 风格 Pod,并拥有自己的 PVC。没有共享存储;复制采用流式 WAL。

系统会自动创建三个 Service:

Service用途
<cluster>-rw可写端点(始终指向当前主节点)
<cluster>-ro只读端点(仅在从节点之间进行负载均衡,不包含主节点)
<cluster>-r读取端点(在包括主节点在内的所有实例之间进行负载均衡)

高可用性与故障转移

  • 主节点选举:operator 在启动时以及发生故障转移时选举主节点。选举使用 Kubernetes Lease 对象进行分布式协调。
  • 故障转移触发条件:Pod 丢失、节点丢失、复制堆积量超过阈值,或通过 cluster.spec.targetPrimary 由 operator 发起切换。
  • 故障转移时间:通常为个位数秒。operator 通过实例管理器心跳检测主节点故障,通过 pg_promote 提升一个从节点,并更新 <cluster>-rw Service 端点以重定向流量。
  • 同步复制:可通过 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 镜像版本:

apiVersion: postgresql.cnpg.io/v1
kind: ClusterImageCatalog
metadata:
  name: postgresql
spec:
  images:
    - major: 14
      image: build-harbor.alauda.cn/middleware/cnpg/postgresql:14.22-standard-trixie
    - major: 18
      image: build-harbor.alauda.cn/middleware/cnpg/postgresql:18.3-standard-trixie

随后,Cluster 可以按主版本引用该目录:

spec:
  imageCatalogRef:
    apiGroup: postgresql.cnpg.io
    kind: ClusterImageCatalog
    name: postgresql
    major: 18

这样可以将 Cluster CR 规范与具体的镜像标签解耦,从而简化跨集群舰队的 PostgreSQL 升级。

ACP RBAC 架构

Alauda Data Services Relational Database E3 提供五角色 L5 RBAC 体系,并接入 ACP namespace-admin / namespace-developer 聚合链:

角色命名约定使用场景
admincpaas:middleware-cnpg:business-ns:adminDBA、Platform Admin — 对所有 CNPG CR 具有完整 CRUD 权限
editcpaas:middleware-cnpg:business-ns:edit开发人员 — 创建/更新 Cluster,但不能删除
viewcpaas:middleware-cnpg:business-ns:view审计员、支持人员 — 只读
backupcpaas:middleware-cnpg:business-ns:backup备份 operator — 仅管理 Backup/ScheduledBackup
restorecpaas:middleware-cnpg:business-ns:restore恢复 operator — 仅管理恢复流程

每个角色都有一个公开的 shell ClusterRole(携带 ACP 目标角色聚合标签)以及一个或多个 base ClusterRole(携带实际规则)。只有当 base 角色同时包含两个标签(目标角色 + 作用域)时,ACP 的 AND 匹配器聚合才会生效。集群范围的资源(ClusterImageCatalog)存放在专用的 cluster-scope:*-base ClusterRole 中。

Alauda Data Services Relational Database E3 与 Alauda PostgreSQL(Zalando-track)对比

方面Alauda Data Services Relational Database E3Alauda PostgreSQL(Zalando)
operator 代码库CloudNativePG(CNCF Sandbox)Zalando Postgres Operator
HA 原语Kubernetes 原生(Leases)Patroni + etcd
故障转移时间~几秒~30-60 秒
CRD 数量91(postgresql.acid.zalan.do)
内置扩展pgaudit、pgvectorpgaudit、pgvector 及其他扩展
连接池Pooler CR(PgBouncer)PostgreSQL CR 内联(PgBouncer 可选)
备份/恢复Barman Cloud(独立插件包)内联(S3、GCS、Azure)
ACP 版本4.1 至 4.4(v1.30.1-acp.1)4.3(GA)
迁移路径逻辑复制;手动转换 CRD随时间推移由 Alauda Data Services Relational Database E3 替代

这两个 operator 相互独立,可以在同一集群中共存(使用不同的 namespace 和不同的 CRD group)。两者之间的迁移通过逻辑复制或备份/恢复完成,而不是原地迁移。

商标声明

CloudNativePG™ 是 The Linux Foundation 的商标。

PostgreSQL® 是 PostgreSQL Community Association of Canada 的注册商标。

Alauda 是独立供应商。本产品与 The Linux Foundation、PostgreSQL Community Association of Canada 没有关联,也未获得其认可或赞助。所有商标均归其各自所有者所有,本文仅将其用于标识目的。