GitLab Geo 高可用架构中移除次要站点的完整指南

GitLab Geo 高可用架构中移除次要站点的完整指南

gitlabhq GitLab CE Mirror | Please open new issues in our issue tracker on GitLab.com 项目地址: https://gitcode.com/gh_mirrors/gi/gitlabhq

前言

在分布式版本控制系统 GitLab 的 Geo 高可用架构中，当我们需要调整部署结构或下线某些次要站点时，必须遵循正确的操作流程。本文将详细介绍如何安全地从 Geo 集群中移除次要站点，确保不会影响主要站点的正常运行。

准备工作

在开始移除操作前，请确保：

1. 您拥有主要站点的管理员权限
2. 已备份所有重要数据
3. 了解该次要站点当前是否承担着重要业务流量

操作步骤详解

第一步：从主要站点管理界面移除次要站点

1. 登录主要站点的管理员界面
2. 在左侧边栏底部选择"管理员"
3. 导航至"Geo > 节点"页面
4. 找到需要移除的次要站点，点击"移除"按钮
5. 在弹出的确认对话框中再次点击"移除"

第二步：停止并卸载次要站点

对于次要站点的每个节点，执行以下操作：

停止 GitLab 服务

sudo gitlab-ctl stop

卸载 GitLab 软件包

根据操作系统类型选择相应的卸载命令：

对于 Debian/Ubuntu 系统：

sudo gitlab-ctl uninstall
sudo dpkg --remove gitlab-ee

对于 Redhat/CentOS 系统：

sudo gitlab-ctl uninstall
sudo rpm --erase gitlab-ee

重要提示：如果希望彻底清除所有 GitLab 数据，需要参考官方文档执行完整的数据清理流程。

第三步：清理主要站点的数据库复制槽

这是关键步骤，确保不会在主要站点留下孤立的复制槽：

1. 登录主要站点的数据库节点
2. 启动 PostgreSQL 控制台会话：

sudo gitlab-psql

注意：不能使用 gitlab-rails dbconsole 命令，因为管理复制槽需要超级用户权限。

3. 查询当前存在的复制槽：

SELECT * FROM pg_replication_slots;

4. 找到对应次要站点的复制槽名称（通常与 replicate-geo-database 命令中指定的 --slot-name 参数一致）
5. 删除该复制槽：

SELECT pg_drop_replication_slot('<name_of_slot>');

操作后验证

完成上述步骤后，建议：

1. 检查主要站点的数据库日志，确认没有复制相关的错误
2. 在主要站点的 Geo 管理页面确认次要站点已完全消失
3. 监控系统性能，确保移除操作没有影响主要站点的正常运行

常见问题解答

Q：为什么需要手动删除复制槽？

A：复制槽是 PostgreSQL 用于跟踪复制进度的机制。如果不手动删除，主要站点会持续保留已删除次要站点的复制日志，可能导致磁盘空间问题。

Q：移除次要站点会影响现有用户吗？

A：如果该次要站点正在服务用户请求，移除前应确保流量已切换到其他站点。移除操作本身不会影响主要站点和其他次要站点。

Q：是否可以临时停用次要站点而不完全移除？

A：可以，只需停止服务而不执行卸载和复制槽删除操作。但长期不用的次要站点建议完全移除以避免资源浪费。

总结

正确移除 Geo 次要站点是维护 GitLab 高可用架构的重要操作。通过本文的详细步骤，管理员可以安全地完成这一过程，确保系统保持健康状态。建议在执行前充分测试，并在维护窗口期进行操作以最小化潜在影响。

gitlabhq GitLab CE Mirror | Please open new issues in our issue tracker on GitLab.com 项目地址: https://gitcode.com/gh_mirrors/gi/gitlabhq