滚动升级自动引导配置

配置项作用 #

discovery.zen.unsafe_rolling_upgrades_enabled 配置项用于控制在从 Zen1 到 Zen2 的滚动升级过程中，是否自动引导 Zen2 节点形成新的集群配置。

当集群中最后一个 Zen1 节点离开时，如果启用了此功能，系统会自动配置投票（voting configuration）以确保集群继续运行。

配置项属性 #

配置路径: discovery.zen.unsafe_rolling_upgrades_enabled
数据类型: Boolean（布尔值）
默认值: true
是否可选: 是
作用域: NodeScope（节点级别）
弃用状态: ⚠️ 已弃用

配置项详解 #

工作机制 #

滚动升级场景

升级前（Zen1 集群）:
[node1-Zen1-master] ←→ [node2-Zen1-master] ←→ [node3-Zen1-data]

滚动升级开始:
[node1-Zen2-master] ←→ [node2-Zen1-master] ←→ [node3-Zen1-data]
     │
     ↓ 混合模式运行

[node1-Zen2-master] ←→ [node2-Zen2-master] ←→ [node3-Zen1-data]
     │
     ↓

[node1-Zen2-master] ←→ [node2-Zen2-master] ←→ [node3-Zen2-data]
     │
     ↓ 全部升级完成

自动引导行为 #

unsafe_rolling_upgrades_enabled = true (默认):

最后一个 Zen1 节点离开
    │
    ↓
系统检测到只剩 Zen2 节点
    │
    ↓
自动创建新的投票配置
    │
    ↓
引导 Zen2 节点形成新集群 ✅
    │
    ↓
集群继续正常运行


unsafe_rolling_upgrades_enabled = false:

最后一个 Zen1 节点离开
    │
    ↓
系统检测到只剩 Zen2 节点
    │
    ↓
等待旧的 Zen1 节点返回
    │
    ↓
集群无法形成新的配置 ❌
    │
    ↓
需要手动干预

代码逻辑 #

// DiscoveryUpgradeService.java 中的核心逻辑

if (enableUnsafeBootstrappingOnUpgrade && lastKnownLeader.isPresent()) {
    // 启用不安全引导
    joiningRound = new JoiningRound(
        true,  // 尝试自动引导
        minimumMasterNodes,
        knownMasterNodeIds
    );
}

// 检查是否可以引导
private boolean canBootstrap(Set<DiscoveryNode> discoveryNodes) {
    return upgrading &&
           minimumMasterNodes <= discoveryNodes.stream()
               .filter(DiscoveryNode::isMasterNode)
               .count();
}

配置建议 #

⚠️ 重要提示 #

此配置项已被标记为弃用，主要用于 Zen1 到 Zen2 的版本迁移。

开发/测试环境 #

discovery.zen.unsafe_rolling_upgrades_enabled: true

建议: 保持默认值 true。简化升级测试流程。

生产环境 #

discovery.zen.unsafe_rolling_upgrades_enabled: false

建议: 设置为 false。由管理员手动控制滚动升级过程，确保集群稳定性。

手动升级控制 #

discovery.zen.unsafe_rolling_upgrades_enabled: false

建议: 在需要精确控制升级过程的场景使用。

代码示例 #

easysearch.yml 配置（已弃用） #

discovery:
  zen:
    unsafe_rolling_upgrades_enabled: true  # 默认值

生产环境推荐配置 #

discovery:
  zen:
    unsafe_rolling_upgrades_enabled: false  # 手动控制升级

配合其他升级相关配置 #

discovery:
  zen:
    minimum_master_nodes: 2
    unsafe_rolling_upgrades_enabled: false

cluster:
  upgrade:
    enabled: true

配置项	作用	默认值
`discovery.zen.unsafe_rolling_upgrades_enabled`	自动引导开关	true
`discovery.zen.minimum_master_nodes`	最少主节点数量	-
`cluster.initial_master_nodes`	初始主节点列表	-

升级过程分析 #

Zen1 到 Zen2 滚动升级 #

步骤 1: 升级第一个节点
[node1-Zen2] ──→ 尝试加入 ──→ [node2-Zen1, node3-Zen1]
                            ↓
                       混合模式运行

步骤 2: 升级第二个节点
[node1-Zen2, node2-Zen2] ──→ 继续 ──→ [node3-Zen1]
                                    ↓
                               混合模式运行

步骤 3: 升级最后一个节点
[node1-Zen2, node2-Zen2, node3-Zen2]
    │
    ↓
最后 Zen1 节点离开
    │
    ├──────── unsafe_rolling_upgrades_enabled = true
    │                  ↓
    │            自动引导 Zen2 节点 ✅
    │                  ↓
    │            创建新的投票配置
    │
    └──────── unsafe_rolling_upgrades_enabled = false
                       ↓
                 等待人工干预 ⚠️

安全考虑 #

为什么称为"不安全"?

自动引导的问题:
1. 没有管理员确认
2. 自动改变投票配置
3. 可能导致脑裂风险
4. 可能丢失数据一致性

手动引导的优势:
1. 管理员确认集群状态
2. 显式配置投票节点
3. 确保数据一致性
4. 可控的升级过程

使用场景 #

手动升级最佳实践 #

推荐的滚动升级流程

1. 准备阶段
   - 备份数据
   - 检查集群健康状态
   - 设置 unsafe_rolling_upgrades_enabled: false

2. 逐个节点升级
   for node in nodes:
       a. 禁用分片分配
       b. 等待分片迁移
       c. 停止节点
       d. 升级软件
       e. 启动节点
       f. 验证节点加入
       g. 恢复分片分配

3. 最后节点升级后
   - 手动配置投票配置
   - 验证集群状态
   - 确认所有节点正常运行

4. 清理阶段
   - 移除旧配置
   - 更新文档

注意事项 #

已弃用: 此配置已被标记为弃用，主要用于 Zen1 到 Zen2 的版本迁移。
生产环境建议: 在生产环境中，建议设置为 false，由管理员手动控制。
版本兼容性: 此配置主要用于 Easysearch 7.x 版本升级场景。
数据一致性: 自动引导可能导致数据不一致，需谨慎使用。
投票配置: 自动引导会改变集群的投票配置，影响后续的选举行为。
备份建议: 在滚动升级前，务必进行完整的数据备份。
监控建议: 升级过程中密切监控集群状态和节点健康。
回滚准备: 准备回滚方案，以防升级失败。
文档更新: 升级完成后更新相关文档和配置。
测试验证: 在生产环境升级前，先在测试环境验证升级流程。

标签