数据迁移
将运行中的 Zalando 集群迁移到 CloudNativePG 的数据路径。清单转换请参阅 清单映射。
选择路径
无法通过 Zalando 归档传送 WAL。Spilo 使用 WAL-E/WAL-G 以 barman-cloud 无法读取的布局归档 WAL;CNPG 集群无法从 Zalando S3 归档中恢复。备份历史不会沿用——请在切换完成后立即创建新的 CNPG 基础备份。
所有路径都要求 CNPG pod 能够访问 Zalando
master 服务(<zalando-cluster>.<ns>.svc:5432),并且源端具有足够权限的用户。常见准备工作:
路径 1 — 声明式导入(由 operator 驱动的转储/恢复)
CNPG 会在引导阶段(bootstrap.initdb.import)为你运行 pg_dump/pg_restore:它连接到源端,转储选定的数据库和角色,将其恢复到新集群,然后继续作为普通集群运行。建议用于小型/中型数据库——也是唯一能在同一步骤中升级主版本的路径。
type: monolith配合databases: ["*"]和roles: ["*"],可一次性迁移所有内容。- 先暂停源端的写入操作——导入是时间点转储。
- 之后运行
ANALYZE(不会转储统计信息)。
路径 2 — 逻辑复制(最短停机时间)
先进行初始复制,然后持续流式传输变更;当堆积量
接近 ~0 时切换。源端必须具有 wal_level=logical(近期版本中的
Spilo 默认配置——使用 SHOW wal_level; 验证)。
-
仅使用架构引导 CNPG 集群(使用
schemaOnly: true进行路径 1 导入,或手动恢复pg_dump --schema-only——逻辑复制不会复制 DDL)。 -
在 Zalando 主节点上创建发布(数据库
orders): -
在 CNPG 集群上创建订阅(声明式):
-
监控
pg_stat_subscription(CNPG 端)和pg_stat_replication(源端);等待初始同步完成,并确保堆积量 持续保持在 ~0。 -
切换:停止写入 → 等待堆积量归零 → 同步序列(逻辑复制不会复制序列——根据源端的
pg_sequences值设置)→ 删除订阅 → 重新指向应用程序。 -
创建首个 CNPG 基础备份;停用源端。
注意事项:表必须具有副本标识(主键),才能执行 UPDATE/DELETE;迁移期间的 DDL 变更不会被 复制;大型对象不会被复制。
路径 3 — 物理克隆(pg_basebackup 引导)
从正在运行的 Zalando 主节点流式传输字节级副本——两端必须使用相同的 PostgreSQL 主版本,复制所有数据库,无需处理架构
(相当于 Zalando 的在线 clone)。
要求:源端必须允许 CNPG pod 建立 replication 连接(Zalando 的 standby 用户适用),并留有 max_wal_senders 余量。
该副本是时间点副本——基础备份完成后发生的写入不会被
复制;请在开始前停止写入。Spilo 产物(standby
角色、Patroni 辅助对象)之后仍会保留在目录中——无害,可择时删除。
如果要创建长期运行的同步备用节点(立即复制,切换时提升),可在相同的 pg_basebackup 引导基础上添加 replica: {enabled: true, source: zalando-src}——集群会持续从 Zalando 主节点流式传输,直到你切换 replica.enabled 进行提升。
任意路径之后
- 首次 CNPG 基础备份(
Backup资源,barman-cloud 插件)—— 验证phase: completed;配置ScheduledBackup。 - 监控:PodMonitor + 仪表板 (Grafana 仪表板指南的操作方法部分)——等待归档的 WAL 段应为 0。
- 在新集群上执行
ANALYZE(路径 1–2)。 - 验证原生应用凭据、连接数限制和 Pooler。
- 在回滚窗口期间,让 Zalando 集群保持暂停状态(不要删除)。
商标声明
CloudNativePG™ 是 The Linux Foundation 的商标。
PostgreSQL® 是 PostgreSQL Community Association of Canada 的注册商标。
Alauda 是一家独立供应商。本产品与 The Linux Foundation、PostgreSQL Community Association of Canada 无关,也未获得其认可或赞助。所有商标均为其各自所有者的财产,在此仅用于标识目的。