NoSQL 与搜索 / 系统课时
安全修改动态与静态配置
安全修改动态与静态配置
Elasticsearch 配置修改的风险通常不在“值写错”,而在作用域、生效方式和回滚路径判断错误。本课用 cluster、index 与节点静态配置三个层次建立一套可验证的修改流程。
学习目标
- 区分 cluster settings、index settings 与
elasticsearch.yml静态节点配置的作用域 - 掌握动态设置的读取、修改、验证与
null回滚方式 - 为必须重启的静态配置设计逐节点变更与健康检查流程
先按作用域和生效方式分类
收到配置变更需求时,先判断“谁拥有这个设置”,再决定修改入口。动态 cluster setting 应优先通过 Cluster Update Settings API 修改;动态 index setting 使用 Update Index Settings API;静态节点设置才写入 elasticsearch.yml 并在相关节点重启后生效。
cluster setting 还存在优先级:transient 高于 persistent,persistent 高于 elasticsearch.yml,最后才是默认值。生产环境不建议依赖 transient,因为集群不稳定时它可能被意外清除;需要跨重启保留的动态设置应使用 persistent。

修改动态 Cluster Setting
变更前先读取当前显式配置,不要凭默认值猜测。下面用 recovery 日志级别作为低风险示例:先保存现状,再写入 persistent 设置,读取验证,最后用 null 删除覆盖值恢复默认来源。
export ES_URL="https://localhost:9200"
export ELASTIC_API_KEY="<VALUE>"
curl -fsS \
-H "Authorization: ApiKey $ELASTIC_API_KEY" \
"$ES_URL/_cluster/settings?flat_settings=true"
curl -fsS -o /dev/null -X PUT \
-H "Authorization: ApiKey $ELASTIC_API_KEY" \
-H "Content-Type: application/json" \
"$ES_URL/_cluster/settings" \
-d '{"persistent":{"logger.org.elasticsearch.indices.recovery":"DEBUG"}}'
curl -fsS \
-H "Authorization: ApiKey $ELASTIC_API_KEY" \
"$ES_URL/_cluster/settings?flat_settings=true&filter_path=persistent.logger.*"
curl -fsS -o /dev/null -X PUT \
-H "Authorization: ApiKey $ELASTIC_API_KEY" \
-H "Content-Type: application/json" \
"$ES_URL/_cluster/settings" \
-d '{"persistent":{"logger.org.elasticsearch.indices.recovery":null}}'中间的验证请求预期能看到显式 persistent 值;最后一次回滚后再次查询,该键应从 persistent 中消失。
{"persistent":{"logger.org.elasticsearch.indices.recovery":"DEBUG"}}对分片分配、恢复限速、熔断或其他生产参数也采用同一流程:读取旧值、只改目标键、验证影响、保留回滚请求。不要为了“临时”就默认使用 transient。
修改动态 Index Setting
索引级设置只影响目标 index 或 data stream backing indices,必须先确认目标表达式不会误匹配。index.refresh_interval 是动态设置,可以在线调整;下面把一个索引改为 30 秒并立即读取确认。
export INDEX="orders-2026.08"
curl -fsS -X PUT \
-H "Authorization: ApiKey $ELASTIC_API_KEY" \
-H "Content-Type: application/json" \
"$ES_URL/$INDEX/_settings" \
-d '{"index":{"refresh_interval":"30s"}}'
echo
curl -fsS \
-H "Authorization: ApiKey $ELASTIC_API_KEY" \
"$ES_URL/$INDEX/_settings/index.refresh_interval?flat_settings=true"预期结果中第一次请求被确认,第二次读取到新的刷新周期。
{"acknowledged":true}
{"orders-2026.08":{"settings":{"index.refresh_interval":"30s"}}}要恢复由模板或默认值决定的行为,应把该键设为 null,而不是猜一个“默认数字”写回去。还要注意并非所有 index setting 都能在线修改,例如 index.number_of_shards 在索引创建后不能直接改成另一个值。
修改静态节点配置
静态设置需要写入 self-managed 节点的 elasticsearch.yml,并在节点启动时读取。下面用自定义节点属性作为配置片段;它不会通过 Cluster Update Settings API 自动传播到其他节点。
node.attr.zone: zone-a生产变更时应逐节点执行:确认集群有足够副本和容量,修改一台节点的配置,重启该节点,等待它重新加入并恢复到稳定状态,再处理下一台。不要同时重启所有数据节点来“加快配置生效”。
重启后可通过 Nodes Info API 验证属性是否被实际加载。
curl -fsS \
-H "Authorization: ApiKey $ELASTIC_API_KEY" \
"$ES_URL/_nodes?filter_path=nodes.*.name,nodes.*.attributes.zone"预期结果会包含节点 ID、节点名以及新属性;<ID> 为动态值。
{"nodes":{"<ID>":{"name":"es-data-01","attributes":{"zone":"zone-a"}}}}用回滚和验收闭环
安全配置变更必须在执行前就写好回滚动作。cluster persistent 和动态 index setting 通常可用 null 移除显式覆盖;静态配置则回退 elasticsearch.yml 到旧版本并再次重启相关节点。
每次变更后至少同时验证三件事:API 读取到的实际值符合预期,_cluster/health 没有出现异常分片状态,业务侧错误率与延迟没有恶化。只有“配置写入成功”而没有运行状态验证,不能算完成一次生产变更。