Patroni + etcd + PostgreSQL 高可用架构(六):Bootstrap 与 Reinit
前五期默认了一个前提:集群已经存在,需要处理的是选举、切换、观测、扩容和灾备。但“集群第一次出现”和“集群已经存在、再加一个节点”是两个不同的生命周期阶段。Patroni 在代码层面就把它们分成了两条独立路径,并且这两条路径的触发条件、可用方法和失败语义都不相同。
理解这个区分的起点,是一条 DCS 中的键:initialize 键。Patroni 只在 DCS 中不存在 initialize 键时,在第一个抢到初始化锁的节点上执行 bootstrap;一旦 initialize 键存在,后续启动的节点只会被当作副本处理,走 reinit 或自动克隆路径。换句话说,bootstrap 是“从无到有”,reinit 是“从有到多”或“从坏到好”。两者共享一些配置字段,但它们的可用方法和工程含义完全不同。
一、Bootstrap:第一次创建集群时,默认不是“从主库克隆”
Bootstrap 的默认方法是 initdb。Patroni 调用 PostgreSQL 的 initdb 在目标节点的 PGDATA 下创建一个全新的空集群,然后根据配置决定这个节点是否成为主库。这是“创建一个新集群”的语义:没有现成的主库可供克隆,数据来源是空的。
但 bootstrap 的方法并不限于 initdb。Patroni 的 bootstrap 配置节支持 method 字段指定自定义引导方法,例如备份恢复工具或用户脚本。这打开了一条在生产中有明确价值的路径:从一个已有的备份集引导出一个新集群。相关厂商文档给出了这个场景的典型动机:从专用备份仓库快速创建一个测试实例,或者在没有现成主库可供流复制的情况下,用备份作为新集群的起点。
这条路径的工程含义是:bootstrap 解决的是“第一个可用的数据副本从哪里来” 。当没有任何现存的 PostgreSQL 实例可以作为克隆源时,initdb 从零开始,或者从备份恢复一份历史数据,然后由 Patroni 把这个节点提升为集群的第一个主库。选择哪种方法,取决于你希望新集群的起点是“完全空的”还是“某个历史时间点的快照”。
Bootstrap 有一个容易被低估的约束:它不链式回退。如果配置了自定义方法且该方法失败,Patroni 不会自动回退到 initdb;bootstrap 直接失败,initialize 锁被释放,另一个节点可以重试。这与 reinit 的 create_replica_methods 按顺序尝试的语义不同。Bootstrap 的方法选择是一次性的、非此即彼的决策。
二、Reinit:向已有集群加副本,默认是“从领导者整份拷贝”
当集群已经存在、DCS 中已经有 initialize 键之后,新启动的 Patroni 节点不会触发 bootstrap,而是进入副本创建流程。patronictl reinit 是这个流程的显式入口:它删除目标成员的 PGDATA 目录,然后按 create_replica_methods 的顺序尝试克隆方法,第一个成功退出的方法即为结果;如果列表为空,内置的 basebackup 方法作为默认回退被使用。
内置的 basebackup 方法执行的是 pg_basebackup:直接从当前领导者拉取一份物理基础备份,写入目标节点的 PGDATA,然后启动流复制追赶后续 WAL。这与 bootstrap 中“从备份仓库恢复”是两条不同的数据通路:reinit 的数据来源是在线的领导者,bootstrap 的数据来源是离线的备份集或 initdb。
这个区别在时间语义上非常直接。pg_basebackup 的耗时由数据量和网络带宽决定,公开的运维记录给出的量级是“数小时”,在大型数据库上尤其如此;基础备份完成后,流复制还需要额外的时间追平备份期间的 WAL 差距,节点只有在延迟收敛之后才应该被纳入负载均衡。相比之下,bootstrap 从备份恢复的耗时取决于备份仓库的读取速度,而 initdb 几乎是瞬时的——它创建的是一个空集群。
Reinit 的另一个硬约束是目标不能是当前主库或 standby leader。patronictl reinit 拒绝在当前领导者上执行,因为那等于删除正在提供写入的数据目录。from-leader 参数的作用是强制使用内置 basebackup 直接从领导者拉取,绕过已配置的自定义方法;wait 让命令等待克隆完成而不是仅报告请求已接受;force 只跳过确认提示,并不放宽目标角色检查。这些参数的语义说明,reinit 的设计假设是“目标是副本”,而不是“目标是任意成员”。
三、两条路径的边界:什么时候该用哪一条
Bootstrap 和 reinit 的区分,最终落在一个可操作的判断上:
如果 DCS 中没有 initialize 键,你面对的是一个尚未存在的集群。 第一个启动的节点会执行 bootstrap。此时的选择是“用 initdb 从零开始”还是“从备份集恢复一个历史快照”。这个决策决定了新集群的初始数据状态,也决定了备份仓库和恢复配置必须在 bootstrap 之前就位。
如果 DCS 中已经有 initialize 键,你面对的是一个已经存在的集群。 新节点的加入、损坏副本的修复、时间线不一致后的重建,都走 reinit 或自动克隆路径。数据来源是当前领导者,时间代价是一次基础备份加上 WAL 追平,期间集群会少一个副本,领导者的 I/O 和网络负载会上升。
一个常见的混淆是把“从备份创建一个新集群”当成“扩容”。从操作上看,两者都涉及“让一个节点从一份非本地的数据开始运行”,但它们的控制平面语义不同:bootstrap 创建的是一个新的 DCS scope 的第一个领导者,reinit 加入的是一个已经存在 scope 的副本集合。把 bootstrap 的备份恢复方法配置到 reinit 的 create_replica_methods 中并不等价于“从备份加副本”——reinit 的默认路径仍然是从领导者 pg_basebackup,自定义方法只是替换克隆源,而不是把节点变成一个独立的集群。
反过来,在 bootstrap 阶段尝试使用 reinit 的语义同样不可行:在 initialize 键被创建之前,没有领导者可供克隆。Bootstrap 是唯一可以从“无主库”状态启动的路径。
四、被低估的配置陷阱:bootstrap 中的选项只生效一次
Bootstrap 配置节中有一个容易被误读的细节:bootstrap 下的 create_replica_methods 或 method 只在集群引导期间生效一次,之后修改这些配置不会改变已有集群的副本创建行为;DCS 中的动态配置才是后续 reinit 行为的实际来源。
这意味着在集群创建之后回头调整 bootstrap 节下的参数,对已经存在的集群不会产生任何效果。如果希望改变后续副本的克隆方法,需要修改的是 postgresql.create_replica_methods 或 DCS 中的动态配置,而不是 bootstrap 节。这个区分在初始部署时容易被忽略,因为 bootstrap 和 postgresql 两个配置节在文件中相邻,字段名也有重叠,但它们的生效范围完全不同:前者是“一次性引导契约”,后者是“持续副本创建策略”。
对于 standby cluster 的引导,同样的逻辑适用,并且多了一层约束:standby cluster 的 create_replica_methods 也在引导期间使用,basebackup 方法要求主集群侧的 pg_hba 规则和复制连接在引导之前就已经就位。如果 standby leader 通过 basebackup 从远程主库克隆,但主库的 pg_hba 没有允许来自 standby cluster 节点的复制连接,bootstrap 会在克隆阶段失败,而 initialize 锁被释放后需要另一个节点重新尝试。这类失败不是 reinit 可以修复的,因为它发生在集群存在之前。
五、两条路径在生命周期中的位置
前五期覆盖的是集群“存在之后”的可靠性:选举、数据安全、可观测性、容量变更、爆炸半径。第六期补充的是集群“如何出现”以及“如何变大” :
Bootstrap 是集群的出生路径。它的默认是 initdb,可选是从备份集恢复。它只在 initialize 键不存在时由第一个抢到锁的节点执行一次,失败不回退,配置只生效一次。
Reinit 是集群的扩容和修复路径。它的默认是从领导者执行 pg_basebackup,可按 create_replica_methods 的顺序尝试自定义方法。它删除目标 PGDATA、拒绝在当前主库上执行、耗时以小时计,期间集群少一个副本。
两者的边界由 DCS 中的 initialize 键划定。理解这条边界,避免的是两类常见错误:在集群已经存在之后期待修改 bootstrap 节来改变扩容行为,以及在集群尚未存在时期待 reinit 能够从“无主库”状态启动。
- 点赞
- 收藏
- 关注作者
评论(0)