移除 Geo 从站点后,主站点上的复制槽怎么清:从卸载到删除的顺序与误判边界
移除 Geo 从站点后,应在从站点每个节点完成卸载,再到主站点数据库节点用 sudo gitlab-psql 进入 PostgreSQL 控制台,通过 pg_replication_slots 定位由 gitlab-ctl replicate-geo-database --slot-name 指定的槽,再用 pg_drop_replication_slot 删除。gitlab-rails dbconsole 因权限不足不适用。如何判断槽是否属于该从站点、误删其他槽的后果,官方文档未覆盖,需另行核实。
直接回答标题的问题:先移除 Geo 从站点、再在从站点每个节点上完成卸载,然后才到主站点的数据库节点上删除复制槽;删除前先用 pg_replication_slots 找到该从站点对应的槽名,槽名就是当初运行 gitlab-ctl replicate-geo-database 时通过 --slot-name 指定的那个名称,最后用 pg_drop_replication_slot 删除。需要使用 sudo gitlab-psql,而不是 gitlab-rails dbconsole,因为管理复制槽需要超级用户权限。
下面按极狐GitLab 官方文档《移除 Geo 从站点》给出的顺序展开。需要先说明材料边界:本次可读到的官方正文覆盖了移除、卸载、定位槽名与删除槽的流程,但没有说明如何从多个槽中判定哪一个属于被移除的从站点,也没有说明误删其他槽会造成什么后果。这两点属于“误判边界”,下文只按已有事实推演,不补造结论。
顺序为什么不能颠倒#
官方文档把三件事排成固定先后:先在主站点 Geo 管理页面移除从站点,再停止并卸载从站点上的每个节点,最后才从主站点数据库删除复制槽。原文的表述是“在从站点的每个节点上卸载极狐GitLab 后,必须按如下方式从主站点的数据库中删除复制槽”(来源:极狐GitLab 文档《移除 Geo 从站点》)。
从文档给出的条件可以推断:复制槽是主站点数据库层面的对象,删除动作发生在“卸载完成之后”,而不是卸载的替代品。先卸载、后删槽,可以避免在从站点仍在连接时动主站点的复制状态。这是对顺序用意的推断,文档本身只规定了顺序,没有逐条解释原因。
第一步:在 Geo 管理页面移除从站点#
在主站点上进入管理员区域,打开 Geo 节点列表,对目标从站点执行移除并确认。文档给出的入口是“在右上角,选择管理员”,随后到 Geo 的节点页面操作。这一步是在主站点的 Web 界面上完成的,不涉及命令行。
第二步:在从站点每个节点上停止并卸载#
文档强调“每个节点”,说明 Geo 从站点可能是多节点部署,只处理其中一台不算完成。每个节点上需要做两件事:执行卸载命令,并按发行版移除软件包。
sudo gitlab-ctl uninstall
# Debian/Ubuntu 系
sudo dpkg --remove gitlab-ee
# RHEL 系
sudo rpm --erase gitlab-ee
以上命令来自官方文档的流程描述,属于未执行的示例:本文没有在真实环境运行,也未验证具体发行版与包名差异。执行前请对照你自己的安装方式与包管理器。文档还提示,如果还需要从实例中清理极狐GitLab 数据,应参考“卸载 Linux 软件包及其所有数据”的说明;也就是说,普通卸载与连同数据一起清理是两件事,不要混为一谈。
第三步:在主站点数据库节点定位复制槽#
删除复制槽的位置有明确限定:主站点的数据库节点。进入 PostgreSQL 控制台要用 sudo gitlab-psql:
sudo gitlab-psql
文档明确写了 gitlab-rails dbconsole “不起作用”,原因是管理复制槽需要超级用户权限。这一点容易踩坑:平时排查 Rails 侧数据常用 dbconsole,但复制槽属于 PostgreSQL 复制层对象,权限要求不同。
进入控制台后,用下面的查询列出复制槽:
SELECT * FROM pg_replication_slots;
槽名的来源是确定的:它就是当初运行复制命令 gitlab-ctl replicate-geo-database 时通过 --slot-name 指定的名称。因此定位槽名的可靠办法,是回看你当时执行复制命令时用的参数,再用上面的查询在结果中核对。
第四步:删除该复制槽#
SELECT pg_drop_replication_slot('<name_of_slot>');
把 <name_of_slot> 替换为上一步确认的槽名。这同样是文档给出的语句,属于未执行的示例。注意槽名要加单引号,且必须是已经核对过的那个名称。
误判边界:文档没有回答的部分#
“定位槽名到删除”这一段,官方材料只提供了两条线索:槽名来自 --slot-name,以及可以用 pg_replication_slots 查看。以下问题在本次可读材料中没有说明,需要你在动手前自行核实,不能靠猜:
- 如何确认某个槽确实属于被移除的从站点。文档没有给出按数据库、按活动状态或按其他字段筛选的判据。如果主站点上存在多个复制槽,仅凭
SELECT *的结果未必能唯一对应到目标从站点;此时应回到当初的复制命令记录确认槽名,而不是凭名字相似去删。 - 删错槽的后果。材料未描述误删其他复制槽对剩余从站点或下游复制的影响。在无法确认归属时,稳妥做法是先不删除,保留查询结果并核对来源,而不是“先删了再看”。
- 槽不存在时的行为。若槽已被清理或名称记错,
pg_drop_replication_slot会如何报错,材料未涉及,待核实。 - 是否需要同时清理其他对象。文档只讲复制槽,未提及主站点上是否还有其他与已移除从站点相关的记录需要处理。
这些空白不影响主流程的可执行性,但决定了操作的安全性。把“槽名从哪来”当作唯一可靠锚点,是这份材料能支撑的最强结论。
操作顺序速查#
| 步骤 | 位置 | 动作 | 依据状态 |
|---|---|---|---|
| 1 | 主站点 Web 界面 | 管理员 > Geo > 节点,移除并确认从站点 | 文档明确 |
| 2 | 从站点每个节点 | gitlab-ctl uninstall,再用 dpkg/rpm 移除包 | 文档明确,命令未执行 |
| 3 | 主站点数据库节点 | sudo gitlab-psql 进入控制台 | 文档明确 |
| 4 | 同上 | SELECT * FROM pg_replication_slots; 定位槽名 | 文档明确,命令未执行 |
| 5 | 同上 | SELECT pg_drop_replication_slot('<name_of_slot>'); | 文档明确,命令未执行 |
| — | — | 多槽环境下如何判定归属、误删后果 | 材料未覆盖,待核实 |
最后提醒版本与时间:上述内容依据的是极狐GitLab 官方文档页面,该页面标注的更新时间为 2026-11-18,本次抓取时间为 2026-11-19;抓取时间不等于内容发布时间,也不能据此推断这是最新版本。不同版本的界面路径或命令细节若有差异,以你部署版本对应的官方文档为准。
参考来源
以上为本文写作时的参考资料,引用观点以原文为准。