从 Zalando postgres-operator 迁移

本节面向将 PostgreSQL 集群从 Zalando postgres-operator(acid.zalan.do/v1 postgresql,之前在 Alauda Container Platform 中提供的基于 Spilo/Patroni 的技术栈)迁移到 CloudNativePG(postgresql.cnpg.io/v1)的用户。

  • Manifest 映射 — 每个 Zalando CR 字段及其对应的 CloudNativePG 字段,以及自动转换工具。
  • 数据迁移 — 迁移数据:转储/还原、逻辑复制或物理克隆。

为什么迁移,以及需要预期什么

  • 无性能回退。CNPG v1.29.1 的发布认证包含了与 Zalando 技术栈进行的相同硬件 A/B 对比(相同的 sysbench OLTP 工作负载,以及每个场景中匹配的 shared_buffers 和 max_connections):CloudNativePG 在全部八个场景中 (TPS 和 P95 延迟)均达到或超过了 Zalando 技术栈的表现。

  • 扩展对等性。所有捆绑扩展都包含在 PostgreSQL operand 镜像中:

    PG 主版本pgvectorpgauditPostGIS 3.6zhparser 2.4TimescaleDB 2.27(Apache-2 OSS)
    14✓✓✓✓✗ 不可用
    15–18✓✓✓✓✓

    Debian trixie 的 TimescaleDB 软件包从 PG 15 开始提供 — 使用 PG 14 和 TimescaleDB 的 Zalando 用户应在迁移期间升级到 PG 15+(PG 14 已接近生命周期结束)。TimescaleDB 构建采用 Apache-2 OSS 版本, 等同于 Spilo 的 APACHE_ONLY=true — 与 Zalando 相比不会损失功能。

  • 架构简化:无需 Patroni 或外部 DCS,无需 Spilo 超大镜像,采用 Kubernetes 原生故障转移和声明式配置 — 请参阅架构。

概念映射

Zalando 概念CloudNativePG 对应项
一个 postgresql CR = 集群 + 用户 + 数据库 + pooler + 备份拆分:Cluster(+ Pooler、Database、ScheduledBackup)
Spilo 镜像(PostgreSQL + Patroni 捆绑包)纯 PostgreSQL operand 镜像;由 operator 注入实例管理器
Patroni / DCS 主节点选举operator 驱动的故障转移,Kubernetes 原生
主节点服务 <cluster> / 复制服务 <cluster>-repl<cluster>-rw / <cluster>-ro(仅副本;-r = 任意实例)
secret <user>.<cluster>.credentials.postgresql.acid.zalan.do(Opaque)bootstrap 所有者使用 <cluster>-app;托管角色使用您提供的 kubernetes.io/basic-auth secrets
postgres superuser secret(始终创建)默认禁用 superuser 访问(enableSuperuserAccess: true 会创建 <cluster>-superuser)
逻辑备份 CronJob(将 pg_dumpall 备份到 S3)物理备份(barman-cloud plugin 或 CSI 快照,支持 PITR);逻辑转储 = 自行提供 CronJob
WAL-E / WAL-G 归档(Spilo 布局)barman-cloud 归档 — 格式不兼容;备份历史无法迁移

迁移检查清单

  1. 转换 manifest(manifest 映射 — 检查转换工具输出的每条警告)。
  2. 选择数据路径(数据迁移)。
  3. 如果应用必须保留其密码,则重新创建凭证 secrets(kubernetes.io/basic-auth)。
  4. 部署,等待 Cluster in healthy state,执行首次备份, 接入监控 (参阅 Grafana dashboards 指南的 How To 部分)。
  5. 重新指向应用(服务名称会发生变化),然后在回滚窗口结束后停用 Zalando 集群。

商标声明

CloudNativePG™ 是 The Linux Foundation 的商标。

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

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