配置项作用 #
cluster.max_voting_config_exclusions 配置项控制集群中允许同时存在的投票配置排除（Voting Config Exclusions）的最大数量。投票配置排除用于从投票配置中临时移除节点，通常用于安全地从集群中移除节点或进行节点维护。
配置项类型 #
该配置项为动态配置，可以在运行时通过集群设置 API 进行修改。
默认值 #
10
是否必需 #
可选配置项（有默认值）
取值范围 #
1 ~ 正整数
配置格式 #
# 默认配置
cluster.max_voting_config_exclusions: 10
# 增加限制
cluster.max_voting_config_exclusions: 20
# 减少限制（更严格）
cluster.max_voting_config_exclusions: 5
# 最小值
cluster.max_voting_config_exclusions: 1
相关配置项 #
| 配置项 | 默认值 | 说明 |
|---|---|---|
cluster.max_voting_config_exclusions | 10 | 最大投票排除数 |
cluster.auto_shrink_voting_configuration | true | 自动收缩投票配置 |
工作原理 #
投票配置排除机制：
┌─────────────────────────────────────────────────────────────────┐
│ 投票配置排除 │
└─────────────────────────────────────────────────────────────────┘
添加投票排除请求
│
▼
检查当前排除数量
│
├── 当前数量 < max_voting_config_exclusions
│ │
│ └── 允许添加排除
│
└── 当前数量 >= max_voting_config_exclusions
│
└── 拒绝请求，返回错误
投票排除生效后
│
├── 节点从投票配置中移除
│
└── 可以安全移除节点
使用场景 #
1. 默认配置（推荐） #
cluster.max_voting_config_exclusions: 10
适用于大多数集群配置。
2. 大规模集群 #
cluster.max_voting_config_exclusions: 20
适用场景：
- 大规模节点集群
- 频繁节点维护
- 批量节点替换
3. 小型集群 #
cluster.max_voting_config_exclusions: 3
适用场景：
- 小型集群
- 严格保护投票配置
- 防止误操作
4. 最严格配置 #
cluster.max_voting_config_exclusions: 1
适用场景：
- 关键业务集群
- 需要谨慎操作
- 逐个移除节点
推荐设置建议 #
| 集群规模 | 推荐值 | 说明 |
|---|---|---|
| 小型（3-5节点） | 3-5 | 保守配置 |
| 中型（6-20节点） | 10 | 默认配置 |
| 大型（20+节点） | 15-20 | 支持批量操作 |
| 生产环境 | 5-10 | 安全优先 |
操作流程 #
添加投票配置排除的标准流程：
# 1. 添加投票配置排除
POST /_cluster/voting_config_exclusions/node_name1,node_name2
# 2. 等待节点从投票配置中移除
GET /_cluster/state?filter_path=metadata.coordination.voting_config_exclusions
# 3. 从集群移除节点
PUT /_cluster/settings
{
"persistent": {
"cluster.routing.allocation.exclude._host": "node1_hostname"
}
}
# 4. 清理投票配置排除
DELETE /_cluster/voting_config_exclusions
动态配置示例 #
# 更新集群配置
PUT /_cluster/settings
{
"transient": {
"cluster.max_voting_config_exclusions": 15
}
}
监控建议 #
# 查看当前配置
GET /_cluster/settings?filter_path=*.cluster.max_voting_config_exclusions
# 查看投票排除状态
GET /_cluster/state?filter_path=metadata.coordination.voting_config_exclusions
# 查看投票配置
GET /_cluster/state?filter_path=metadata.coordination.voting_config
注意事项 #
- 动态更新：此配置为动态配置，可在线修改
- 集群稳定性：防止一次性移除过多投票节点
- 最小值限制：最小值为 1，不能设置为 0
- 配合自动收缩：与 auto_shrink_voting_configuration 配合使用
- 操作谨慎：投票配置变更影响集群选举能力
