mintel/elasticsearch

Mintel Kubernetes Elasticsearch镜像

镜像概述

本镜像基于https://github.com/elastic/elasticsearch-docker%E6%9E%84%E5%BB%BA%EF%BC%8C%E4%B8%BB%E8%A6%81%E7%94%A8%E4%BA%8EKubernetes%E7%8E%AF%E5%A2%83%EF%BC%8C%E6%8F%90%E4%BE%9B%E5%A2%9E%E5%BC%BA%E7%9A%84%E8%BF%90%E7%BB%B4%E8%83%BD%E5%8A%9B%E5%92%8C%E7%A8%B3%E5%AE%9A%E6%80%A7%E4%BC%98%E5%8C%96%E3%80%82%E9%95%9C%E5%83%8F%E4%BB%A5%E9%9D%9E%E7%89%B9%E6%9D%83%E7%94%A8%E6%88%B7%E8%BF%90%E8%A1%8C%EF%BC%8C%E5%8C%85%E5%90%AB%E8%87%AA%E5%AE%9A%E4%B9%89%E5%85%A5%E5%8F%A3%E7%82%B9%E8%84%9A%E6%9C%AC%E5%92%8C%E7%94%9F%E5%91%BD%E5%91%A8%E6%9C%9F%E7%AE%A1%E7%90%86%E5%B7%A5%E5%85%B7%EF%BC%8C%E6%94%AF%E6%8C%81%E6%BB%9A%E5%8A%A8%E9%87%8D%E5%90%AF%E3%80%81%E5%88%86%E7%89%87%E7%AE%A1%E7%90%86%E7%AD%89Kubernetes%E7%89%B9%E6%9C%89%E5%9C%BA%E6%99%AF%E9%9C%80%E6%B1%82%E3%80%82

核心功能与特性

基础定制

• 非特权运行：仅以elasticsearch用户（uid:1000/gid:1000）运行，提升安全性
• 数据存储：索引文件存储于/data目录，挂载卷时需确保该用户有读写权限
• 工具集成：包含JQ工具和elasticsearch-py Python客户端库
• 自定义入口点：run.sh支持多种配置选项（详见下文）
• Kubernetes生命周期脚本：提供用于滚动重启的生命周期钩子脚本（详见下文）

run.sh入口点增强

• 优雅停止等待：Java进程优雅停止时强制休眠，避免主节点切换问题，可通过POST_TERM_WAIT环境变量自定义等待时间（默认15秒）
• 插件自动安装：通过ES_PLUGINS_INSTALL环境变量指定逗号分隔的插件列表，启动时自动安装（如repository-gcs,x-pack）
• 分片分配感知：支持定义SHARD_ALLOCATION_AWARENESS，计划增强Kubernetes云区域支持
• DNS缓存优化：可通过NETWORK_ADDRESS_CACHE_TTL（默认3秒）和NETWORK_ADDRESS_CACHE_NEGATIVE_TTL（默认10秒）调整Java网络地址缓存时间

生命周期管理脚本

核心脚本

• /manage-es.py：Python脚本，提供Elasticsearch生命周期管理功能
• Kubernetes钩子脚本：
  • pre-stop钩子：/stop-data-node.sh + python /manage-es.py pre-stop-data
  • post-start钩子：/start-data-node.sh + python /manage-es.py persitent-settings + python /manage-es.py post-start-data

支持的操作

• pre-stop-data：数据节点停止前操作，支持两种模式：
  • ALLOCATION：禁用分片分配 → 执行同步刷新
  • DRAIN：配置恢复参数 → 排空节点 → 等待分片迁移完成
• post-start-data：数据节点启动后操作，支持两种模式：
  • ALLOCATION：等待节点加入集群 → 配置恢复参数 → 启用分片分配 → 等待分片状态稳定 → 恢复默认配置
  • DRAIN：等待节点加入集群 → 配置恢复参数 → 取消节点排空 → 等待分片状态稳定 → 恢复默认配置
• persistent-settings：从指定JSON文件推送持久化配置到集群
• pre-stop-master/post-start-master：主节点生命周期操作（暂未实现）

注意：生命周期钩子依赖集群可访问性，若主节点与数据节点共存于同一实例，可能导致启动失败。

环境变量配置

启动环境变量

Elasticsearch设置环境变量

维护期间的临时设置

• WAIT_FOR_NODE_IN_CLUSTER：等待节点加入集群的超时时间（默认180秒）
• WAIT_FOR_NO_SHARDS_RELOCATING：等待分片迁移完成的超时时间（默认1800秒）
• NODE_CONCURRENT_INCOMING_RECOVERIES：节点并发入站恢复数（默认使用ES版本默认值）
• NODE_CONCURRENT_OUTGOING_RECOVERIES：节点并发出站恢复数（默认使用ES版本默认值）
• NODE_INITIAL_PRIMARIES_RECOVERIES：节点初始主分片恢复数（默认使用ES版本默认值）
• CLUSTER_CONCURRENT_REBALANCE：集群并发重平衡数（默认使用ES版本默认值）

持久化设置

• PERSITENT_SETTINGS_FILE_PATH：持久化配置JSON文件路径

其他启动设置

• DISCOVERY_SERVICE：Elasticsearch发现服务URL
• MAINTENANCE_MODE：维护模式（None：默认，无操作；Drain：排空节点；Allocation：禁用分片分配）

使用示例

Kubernetes部署示例

生命周期钩子配置示例（完整示例见https://github.com/mintel/es-image/tree/master/examples/minikube%EF%BC%89%EF%BC%9A

yaml
lifecycle:
  preStop:
    exec:
      command: ["/stop-data-node.sh", "python", "/manage-es.py", "pre-stop-data"]
  postStart:
    exec:
      command: ["/start-data-node.sh", "python", "/manage-es.py", "persitent-settings", "python", "/manage-es.py", "post-start-data"]