untergeek/curator

Elasticsearch Curator Docker镜像文档

镜像概述和主要用途

Elasticsearch Curator是一款针对Elasticsearch集群的管理工具，主要用于执行索引生命周期管理、快照操作、集群维护等任务。该工具采用主版本锁定机制，即Curator主版本需与Elasticsearch主版本严格匹配（如Curator 8.x适配Elasticsearch 8.x，7.x适配7.x，6.x适配6.x）。Docker镜像版本需通过挂载配置文件目录实现功能，适用于自动化管理Elasticsearch集群的场景。

核心功能和特性

1. 版本兼容性：采用主版本锁定策略，确保Curator与Elasticsearch版本严格匹配，避免兼容性问题。
2. Docker部署依赖：必须通过卷挂载本地配置目录至容器内/.curator路径，否则命令行参数传递无效。
3. 配置驱动型操作：依赖config.yml（基础配置）和actionfile.yml（操作定义）两个文件实现功能，支持灵活定制管理任务。

使用场景和适用范围

适用于需要对Elasticsearch集群进行自动化维护的场景，包括但不限于：

• 索引生命周期管理（如删除过期索引、滚动索引）
• 快照创建与管理
• 集群状态监控与调整
• 定期执行的集群维护任务

使用方法和配置说明

前置准备

在本地创建配置目录（如/PATH/TO/MY/CONFIGS），并提前放置两个必要文件：

• config.yml：包含Elasticsearch连接信息、日志配置等基础设置
• actionfile.yml：定义具体执行的管理操作（如索引删除、快照创建等）

Docker运行命令示例

bash
docker run --rm --name myimagename \
  -v /PATH/TO/MY/CONFIGS:/.curator \
  untergeek/curator:mytag          \
  --config /.curator/config.yml /.curator/actionfile.yml

关键参数说明

• --rm：容器执行完毕后自动删除，避免残留无用容器，建议始终添加此参数。
• -v /PATH/TO/MY/CONFIGS:/.curator：将本地配置目录挂载至容器内/.curator路径，确保Curator能读取配置文件。
• untergeek/curator:mytag：指定Curator镜像及标签，标签需与目标Elasticsearch版本匹配（如untergeek/curator:8对应Elasticsearch 8.x）。
• --config /.curator/config.yml /.curator/actionfile.yml：指定配置文件路径，需使用容器内的挂载路径（/.curator/）。

注意事项

• 配置文件必须在容器启动前存在于本地挂载目录，否则Curator将无法正常加载配置。
• 镜像标签需与Elasticsearch主版本对应，避免版本不兼容导致操作失败。
• 不建议省略--rm参数，否则会导致大量已完成任务的容器堆积，增加系统资源占用和清理负担。