将节点添加到高可用性配置

注意

高可用性配置中对附加节点的支持目前处于公开预览阶段，后续可能会有所变动。

对于希望进行横向扩展的 GitHub Enterprise Server 客户而言，迁移到集群并进行运维是一种选择，但这需要投入大量资源和时间。作为替代方法，我们建议将节点添加到 HA 配置。

本文中可互换使用术语“其他节点”和“无状态节点”。无状态节点只能添加到包含至少一个副本的 HA 部署。

其他节点

在设备上运行 GitHub Enterprise Server 的所有服务中，Unicorn 通常是 CPU 和内存密集型最多的服务，紧随其后的是 Aqueduct、Git 和 MySQL。由于 Unicorn 和 Aqueduct 是无状态服务，因此它们非常适合水平缩放，可以在一组单独的节点上运行。其余服务可以继续使用每个数据中心的单个实例运行。

附加节点允许您水平扩展 Web 和任务工作负载。它们还可以将 Unicorn 和 Aqueduct 从主节点迁移走，为剩余的有状态服务释放大量的计算和内存资源。如果由于 Unicorn 实例的 CPU 使用率较高而遇到性能相关的服务中断，建议添加其他节点。在数据中心内可以添加的这些节点的数量没有重大限制。

条件

如果由于 HA 配置中的重载主节点而导致性能下降，应考虑将其他节点添加到 HA 环境。通过在主节点之外水平缩放 Web 角色和作业角色，这些额外的节点可以帮助减少主主机上的负载。

例如，如果你注意到 Unicorn 或 Aqueduct 队列中积压工作，或者遇到其他类型的资源争用，则应考虑此方法。即使没有可见的队列，主节点上的 CPU 耗尽也是另一个明确的信号。在这些情况下，可以添加其他节点并减少每个节点的工作器数，因此主节点处理的总体工作负荷更少。

添加节点

添加到 HA 部署中的每个节点都是一台运行 GitHub Enterprise Server 软件的虚拟机（VM）。它应运行与主系统相同的软件。通常，无状态节点不需要与主节点的内存、CPU 或存储规范匹配。但是，无状态节点和主实例都需要子毫秒连接。副本连接要求保持不变。

若要将节点添加到 HA 配置中的主数据中心，请使用 ghe-add-node 命令。该 ghe-add-node 命令将当前设备设置为 HA 部署中的节点，旨在从主数据节点卸载 CPU 密集型任务，从而启用水平缩放。这些节点旨在处理 Web 和作业工作负荷，从而提高工作负荷分发和管理效率。此命令采用以下格式：

Shell

/usr/local/share/enterprise/ghe-add-node PRIMARY_IP [--hostname HOSTNAME]

/usr/local/share/enterprise/ghe-add-node PRIMARY_IP [--hostname HOSTNAME]

PRIMARY_IP：主节点的 IP 地址。
HOSTNAME （可选）：所添加主机的所需主机名。

例如，若要将主机名 ghes-node-1 的节点添加到 HA 主数据中心具有 IP 地址 192.168.1.1 的 HA 主实例，请运行以下命令：

Shell

/usr/local/share/enterprise/ghe-add-node 192.168.1.1 --hostname ghes-node-1

/usr/local/share/enterprise/ghe-add-node 192.168.1.1 --hostname ghes-node-1

然后，在主节点上，必须运行以下命令：

Shell

ghe-config-apply
ghe-cluster-balance rebalance --yes

ghe-config-apply
ghe-cluster-balance rebalance --yes

此命令 ghe-config-apply 是添加无状态节点的要求。

我们建议在维护窗口期间添加无状态节点。

删除其他节点

在删除其他节点之前，请在 HA 部署的每个节点上为功能版本安装相同的最新修补程序，并计划维护时段。等待任何升级或配置运行完成，然后再开始删除。

在 HA 主节点上，检查 HA 部署中每个节点的状态。
Shell
```
ghe-cluster-nodes
ghe-cluster-nodes --offline
nomad node status
ghe-cluster-status --extended --verbose
```
```
ghe-cluster-nodes
ghe-cluster-nodes --offline
nomad node status
ghe-cluster-status --extended --verbose
```
确认这两 ghe-cluster-nodes 个命令都列出相同的主机名，并包括计划删除的节点的主机名。确认每个节点的 Nomad 状态均为 ready，并且对于每个节点，connect-ssh 和 enterprise-version 均为 ok。确认主副本和任何其他副本上的有状态服务运行状况良好。如果未保留任何副本，则会出现一条警告，指出未找到 MySQL 副本。如果目标上的故障仅限于 Web、job 或 memcache 工作负载，则不会阻止移除。如果任何其他节点级检查或状态化服务检查失败，请先联系 GitHub 支持，再进行移除。
在 HA 主节点上，删除其他节点。用附加节点的主机名替换 HOSTNAME。
Shell
```
ghe-remove-node --verbose HOSTNAME
```
```
ghe-remove-node --verbose HOSTNAME
```
如果另一个非主节点仍然存在，则命令会清空目标，将其从 HA 配置中删除，然后运行 ghe-config-apply。如果未保留非主节点，该命令将删除群集元数据，并将主节点转换为独立实例，而无需运行 ghe-config-apply。无论哪种情况，都不要单独运行 ghe-config-apply 。
确认已删除。

如果另一个非主节点仍然存在，请在 HA 主节点上运行以下命令。确认主机名不存在并且 HA 配置正常。
Shell
```
ghe-cluster-nodes --offline
ghe-cluster-status --extended --verbose
```
```
ghe-cluster-nodes --offline
ghe-cluster-status --extended --verbose
```
如果未保留非主节点，请不要运行仅限群集的命令。确认移除操作的输出中包含 Cluster artifacts removed; now standalone.，然后确认主节点承载用户流量并处理 Web 和作业工作负载。

如果其他节点处于离线状态、无法访问或版本不同，或者 ghe-remove-node 或验证检查失败，请联系 GitHub 支持。请勿手动编辑 cluster.conf 。

对之前托管过 GitHub Enterprise Server 的节点重新置备

您可以将先前托管并运行过 GitHub Enterprise Server 的节点用作无状态节点。为此，节点应更新到版本 3.18 或更高版本，并且部署中的所有节点都必须运行相同的版本。请检查在该节点上，/data/user/common/cluster.conf 是否已存在。如果这样做，则需要在无状态节点上运行 ghe-add-node 命令之前执行清理。

例如：

Shell

sudo rm -f /etc/github/cluster /data/user/common/cluster.conf
sudo timeout -k4 10 systemctl stop wireguard 2>/dev/null || sudo ip link delete tun0 || true

sudo rm -f /etc/github/cluster /data/user/common/cluster.conf
sudo timeout -k4 10 systemctl stop wireguard 2>/dev/null || sudo ip link delete tun0 || true