技术文章

外部链接将在新标签页打开。

复制槽只按名称删会漏什么:Geo 从站点移除后清理 PostgreSQL 复制槽的查询选择与顺序约束

一句话回答

极狐GitLab 文档把禁用 Geo 拆成固定顺序:先移除所有从站点并确认不再复制,再从 UI 移除主站点,然后在主 Geo 节点的 PostgreSQL 控制台清理从站点复制槽,最后移除 geo_primary_role 等配置。已有 PostgreSQL 集群时应先列出槽名再按名称逐个删除,避免误删同集群中其他复制槽;文档也给出一次性删除 pg_replication_slots 中全部槽的查询,但它不区分槽的来源。

按名称删复制槽本身不会“漏”掉某个名字——漏的是判断:如果你没有先确认哪些槽属于被移除的 Geo 从站点,只凭一个名字或一条“删掉全部”的语句动手,风险落在同集群的其他复制槽上。极狐GitLab 文档给出的做法是:已有 PostgreSQL 集群时,先查出所有槽名,再按名称逐个删除;同时文档也提供了一条删除 pg_replication_slots 中全部槽的查询。两者不是等价选项,适用条件不同。

先看清顺序:删槽不是第一步#

文档把禁用 Geo 的步骤排成一条链:移除所有 Geo 从站点(这些站点上不再进行复制)→ 从 UI 移除主站点 → 移除从站点复制槽 → 移除 Geo 相关配置 → 可选地还原 PostgreSQL 设置。若当前想继续使用的站点本身是从站点,需要先把它提升为主站点。

这条顺序里,删槽排在“从站点不再复制”之后。原因不难理解:复制槽是主节点为特定消费者保留 WAL 的位置标记,只要从站点还在复制,槽就仍被使用。文档没有展开说明在槽仍活跃时删除会发生什么,也没有给出 active 字段的前置检查要求,这一点属于本次材料未覆盖的范围,不应替文档补写结论。

在主节点上查槽名#

清理操作要在主 Geo 节点的 PostgreSQL 控制台执行,文档给出的入口是 sudo gitlab-psql。查看现有复制槽的查询是:

SELECT slot_name, slot_type, active FROM pg_replication_slots;

这条语句返回槽名、槽类型和是否活跃。文档用它来“获取所有名称”,随后按名称删除。需要说明的是,文档在这一步只要求确认名称,并未要求依据 slot_type 或 active 做筛选;如果集群里除 Geo 之外还有别的复制消费者,如何区分它们,材料没有给出规则,需结合你自己的集群拓扑判断,不能把“表里出现的槽”一律当作 Geo 从站点的槽。

两种删除语句,条件不同#

按名称删除单个槽:

SELECT pg_drop_replication_slot('slot_name');

其中 slot_name 应替换为上一条查询中确认过的预期名称。文档特别说明,如果你已有 PostgreSQL 集群,应按名称删除各个复制槽,以防止从同一集群中移除从站点数据库。这里的“已有 PostgreSQL 集群”就是选择按名删除的适用前提:集群里可能不止 Geo 相关的一套槽,笼统删除会波及别的消费者。

文档另给出的批量删除语句是:

SELECT pg_drop_replication_slot(slot_name) FROM pg_replication_slots;

它会对 pg_replication_slots 中的每一行调用删除函数,不带任何过滤条件。材料只把它列为“查询之一”,没有说明它适用于哪种集群形态,也没有说明它对非 Geo 槽的影响。因此可以确定的是语句行为(删除视图中全部槽),不能据此推断它在生产集群中是推荐做法。上面两段 SQL 均为文档原文引用,本次未在任何实例上执行,不提供执行结果或性能数据。

删槽之后:配置与可选还原#

槽清完后才进入“移除 Geo 相关配置”:在每个主站点节点上编辑 /etc/gitlab/gitlab.rb,删除任何启用 geo_primary_role 的行,然后重新配置极狐GitLab。文档把还原 PostgreSQL 设置列为可选步骤——若希望恢复默认、改用套接字连接,可以从该文件中移除 PostgreSQL 特定设置行。

文档还给出一个预期:正确移除 Geo 从站点后,禁用 Geo 与“拥有一个没有 Geo 从站点的活动 Geo 设置”之间不应有任何功能差异。这是文档的结论性表述,其前提是“正确移除”,也就是前面的顺序和清理都做到位。

边界与待核实项#

  • 命名规则:材料未说明 Geo 复制槽的命名约定,因此无法仅凭槽名模式自动识别 Geo 槽。
  • 非 Geo 槽:批量删除语句会覆盖视图中所有槽,材料未讨论其他复制消费者的处置方式。
  • 活跃状态:查询返回了 active 列,但材料未给出删除前必须确认其为非活跃的要求。
  • 版本差异:本文依据的是抓取于 2026-11-20 的极狐GitLab 文档页面(页面标注更新时间为 2026-11-18),不同 GitLab 版本的步骤或语句可能不同,需以对应版本文档为准;抓取时间不等于内容发布时间。

来源:极狐GitLab 文档《禁用 Geo》。

可操作清单#

  1. 确认所有 Geo 从站点已移除、不再复制;如需保留当前从站点,先提升为主站点。
  2. 从 UI 移除主站点(管理员 > Geo > 节点 > 为主节点选择移除并确认)。
  3. 在主 Geo 节点执行 sudo gitlab-psql,用查询列出槽名、类型与活跃状态。
  4. 若集群中还有其他复制消费者,按名称逐个删除已确认属于 Geo 从站点的槽;批量语句仅在确认视图中所有槽都可删除时使用。
  5. 在各主站点节点移除 geo_primary_role 相关配置并重新配置;按需还原 PostgreSQL 设置。

核心约束可以概括为一句话:顺序决定是否安全,名称决定删除范围。文档能回答“先做什么、用什么语句”,不能替你在混合集群里判断“哪些槽可以删”。

参考来源

  1. 禁用 Geo - GitLab - GitLab 文档中心

以上为本文写作时的参考资料,引用观点以原文为准。

作者:沐小悠

本文约 6 分钟读完 · 关键词:GitLab Geo、复制槽、PostgreSQL、pg_replication_slots、禁用 Geo

更多文章 GET 示例接口

「」标签下的其他文章