anchorfree/elasticsearch-curator

镜像概述

本镜像基于Elasticsearch Curator工具构建，专为Elasticsearch索引轮换管理设计。Curator是一款轻量级索引管理工具，可通过配置实现索引的自动创建、删除、优化及生命周期管理，帮助用户维护Elasticsearch集群性能，确保索引数据高效存储与合规保留。

核心功能与特性

• 索引轮换自动化：支持按时间、大小、数量等策略自动轮换索引，避免单一索引过大影响性能
• 生命周期管理：提供索引创建、删除、别名管理、段合并等全生命周期操作
• 灵活配置：通过YAML配置文件定义索引过滤规则与执行动作，适配多样化业务需求
• 版本兼容：兼容主流Elasticsearch版本（5.x+），适配不同集群环境
• 轻量级部署：基于官方Python镜像构建，体积小，资源占用低，易于集成到现有容器化架构

使用场景

• 日志存储系统：定期清理过期日志索引，释放存储空间（如Logstash生成的按日滚动索引）
• 监控数据管理：按时间分桶管理监控指标数据，确保查询性能
• 大规模集群维护：自动化处理海量索引，减少人工操作成本
• 合规数据保留：按***要求自动保留指定周期内的索引数据

使用方法

基本运行方式

通过挂载配置文件目录运行容器，执行索引管理操作：

bash
docker run -v /本地配置目录:/curator/config elasticsearch/curator --config /curator/config/curator.yml /curator/config/action.yml

配置文件说明

1. 客户端配置文件（curator.yml）

定义Elasticsearch连接信息及日志配置：

yaml
client:
  hosts:
    - es-node-1.example.com  # Elasticsearch节点地址
    - es-node-2.example.com
  port: 9200                 # 端口
  use_ssl: True              # 是否启用SSL
  username: elastic          # 认证用户名
  password: changeme         # 认证密码
  timeout: 30                # 连接超时时间（秒）
logging:
  loglevel: INFO             # 日志级别（DEBUG/INFO/WARNING/ERROR/CRITICAL）
  logfile: /curator/logs/curator.log  # 日志文件路径（需挂载目录）

2. 动作配置文件（action.yml）

定义索引管理动作及过滤规则，示例：删除30天前的日志索引

yaml
actions:
  1:
    action: delete_indices  # 动作类型（delete_indices/close_indices/optimize等）
    description: "删除30天前的logstash索引"
    options:
      ignore_empty_list: True  # 索引列表为空时忽略操作
      continue_if_exception: False  # 发生异常时是否继续
    filters:
      - filtertype: pattern  # 按名称模式过滤
        kind: prefix
        value: logstash-     # 索引名称前缀
      - filtertype: age      # 按时间过滤
        source: name         # 从索引名称提取时间
        timestring: '%Y.%m.%d'  # 时间格式（如logstash-2024.01.01）
        direction: older     # 保留较旧/较新索引
        unit: days           # 时间单位（days/weeks/months/years）
        unit_count: 30       # 时间阈值

环境变量

可通过环境变量覆盖配置文件中的部分参数：

Docker Compose示例

yaml
version: '3'
services:
  curator:
    image: elasticsearch/curator
    volumes:
      - ./curator/config:/curator/config  # 挂载配置目录
      - ./curator/logs:/curator/logs      # 挂载日志目录
    command: --config /curator/config/curator.yml /curator/config/action.yml
    environment:
      - ES_HOST=elasticsearch  # 连接到docker-compose中的ES服务
      - ES_PORT=9200
      - ES_USER=elastic
      - ES_PASSWORD=changeme
    restart: on-failure  # 失败时自动重启

常见动作类型

Curator支持多种索引管理动作，核心包括：

• delete_indices：删除符合条件的索引
• close_indices：关闭不活跃索引
• open_indices：打开已关闭索引
• alias：管理索引别名（添加/移除）
• forcemerge：优化索引段（减少碎片）
• reindex：索引数据迁移