« 投票配置 发布集群状态 »
Elastic 文档 ›Elasticsearch 指南 [8.14] ›设置 Elasticsearch ›发现和集群形成

集群引导

编辑

集群引导编辑

首次启动 Elasticsearch 集群需要在集群中的一个或多个主节点上明确定义初始的主节点集。这被称为集群引导。这仅在集群首次启动时需要。新启动的节点加入正在运行的集群时，会从集群的选举出来的主节点获取此信息。

初始的主节点集在cluster.initial_master_nodes 设置中定义。这应该设置为一个列表，其中包含每个主节点的以下一项：

  • 节点的节点名称。
  • 如果未设置node.name，则为节点的主机名，因为node.name 默认设置为节点的主机名。您必须使用完全限定主机名或裸主机名取决于您的系统配置。
  • 如果无法使用节点的node.name，则为节点的传输发布地址的 IP 地址。这通常是network.host 解析到的 IP 地址，但可以覆盖。
  • 如果无法使用节点的node.name 并且多个节点共享同一个 IP 地址，则为节点的发布地址的 IP 地址和端口，格式为IP:PORT。

集群形成后，从每个节点的配置中删除cluster.initial_master_nodes 设置。它不应该为非主节点、加入现有集群的主节点或重新启动的节点设置。

如果您在集群形成后保留cluster.initial_master_nodes，那么将来可能会出现错误配置，导致在现有集群旁边引导新的集群。可能无法从这种情况中恢复，而不会丢失数据。

创建新集群的最简单方法是选择一个主节点，它将自身引导到单节点集群中，然后所有其他节点将加入该集群。这种简单的方法在其他主节点加入集群之前，对故障没有弹性。例如，如果您有一个主节点，其节点名称 为master-a，那么将其配置如下（从所有其他节点的配置中省略cluster.initial_master_nodes）：

cluster.initial_master_nodes: master-a

对于容错集群引导，请使用所有主节点。例如，如果您的集群有 3 个主节点，其节点名称 为master-a、master-b 和master-c，那么将它们全部配置如下：

cluster.initial_master_nodes:
  - master-a
  - master-b
  - master-c

您必须在设置cluster.initial_master_nodes 的每个节点上将其设置为相同的节点列表，以确保在引导过程中只形成一个集群。如果cluster.initial_master_nodes 在设置它的节点之间不同，那么您可能会引导多个集群。通常无法从这种情况中恢复，而不会丢失数据。

节点名称格式必须匹配

cluster.initial_master_nodes 列表中使用的节点名称必须与节点的node.name 属性完全匹配。默认情况下，节点名称设置为机器的主机名，这可能是完全限定的，也可能不是，具体取决于您的系统配置。如果每个节点名称都是一个完全限定的域名，例如master-a.example.com，那么您也必须在cluster.initial_master_nodes 列表中使用完全限定的域名；反之，如果您的节点名称是裸主机名（没有.example.com 后缀），那么您必须在cluster.initial_master_nodes 列表中使用裸主机名。如果您混合使用完全限定主机名和裸主机名，或者node.name 和cluster.initial_master_nodes 之间存在其他不匹配，那么集群将无法成功形成，您将看到类似以下的日志消息。

[master-a.example.com] master not discovered yet, this node has
not previously joined a bootstrapped (v7+) cluster, and this
node must discover master-eligible nodes [master-a, master-b] to
bootstrap a cluster: have discovered [{master-b.example.com}{...

此消息显示节点名称master-a.example.com 和master-b.example.com 以及cluster.initial_master_nodes 条目master-a 和master-b，从该消息可以清楚地看出它们并不完全匹配。

选择集群名称编辑

cluster.name 设置使您能够创建彼此分离的多个集群。节点在首次相互连接时会验证它们是否同意其集群名称，Elasticsearch 仅会从所有具有相同集群名称的节点中形成集群。集群名称的默认值为elasticsearch，但建议将其更改为反映集群的逻辑名称。

开发模式下的自动引导编辑

默认情况下，每个节点在首次启动时都会自动引导到单节点集群中。如果配置了以下任何设置，则不会进行自动引导：

  • discovery.seed_providers
  • discovery.seed_hosts
  • cluster.initial_master_nodes

要将新节点添加到现有集群中，请配置discovery.seed_hosts 或其他相关的发现设置，以便新节点可以发现集群中现有的主节点。要引导新的多节点集群，请配置cluster.initial_master_nodes（如集群引导部分所述）以及discovery.seed_hosts 或其他相关的发现设置。

形成单个集群

一旦 Elasticsearch 节点加入了现有集群或引导了新集群，它就不会加入其他集群。Elasticsearch 不会在集群形成后将单独的集群合并在一起，即使您随后尝试将所有节点配置到单个集群中。这是因为没有办法将这些单独的集群合并在一起，而不会有数据丢失的风险。您可以通过检查每个节点上的GET / 报告的集群 UUID 来判断您是否形成了单独的集群。

如果您打算将节点添加到现有集群中，但实际上引导了单独的单节点集群，那么您必须重新开始：

  1. 关闭节点。
  2. 通过删除节点的数据文件夹的内容来完全擦除节点。
  3. 配置discovery.seed_hosts 或discovery.seed_providers 以及其他相关的发现设置。确保在任何节点上都没有设置cluster.initial_master_nodes。
  4. 重新启动节点并验证它加入了现有集群，而不是形成了自己的单节点集群。

如果您打算形成新的多节点集群，但实际上引导了一组单节点集群，那么您必须重新开始：

  1. 关闭所有节点。
  2. 通过删除每个节点的数据文件夹的内容来完全擦除每个节点。
  3. 如上所述配置cluster.initial_master_nodes。
  4. 配置discovery.seed_hosts 或discovery.seed_providers 以及其他相关的发现设置。
  5. 重新启动所有节点并验证它们是否形成了单个集群。
  6. 从每个节点的配置中删除cluster.initial_master_nodes。
« 投票配置 发布集群状态 »