📣 极限科技诚招搜索运维工程师(Elasticsearch/Easysearch)- 全职/北京 👉 : 立即申请加入

配置项作用 #

path.repo 配置项指定共享文件系统仓库的位置,用于存储快照数据。

是否可选 #

默认值 #

[] (空列表)

配置项类型 #

静态配置 - 需要重启节点才能生效

配置格式 #

# 单个仓库路径
path.repo:
  - /backup/easysearch

# 多个仓库路径
path.repo:
  - /backup/easysearch
  - /mnt/backup/easysearch
  - /data/snapshots

工作原理 #

快照仓库存储位置:

┌─────────────────────────────────────────────────────────┐
│                   快照仓库                                │
└─────────────────────────────────────────────────────────┘

path.repo 配置的路径
    │
    ├── 存储快照文件
    ├── 存储元数据
    └── 存储索引信息
        │
        ▼
    创建快照仓库
    PUT _snapshot/backup_repo
    {
      "type": "fs",
      "settings": {
        "location": "/backup/easysearch/backup_repo"
      }
    }

推荐设置 #

环境推荐值说明
生产环境专用备份路径独立存储
高可用共享存储路径多节点访问
测试环境临时路径开发测试

使用示例 #

单路径配置:

path.repo:
  - /backup/easysearch

多路径配置:

path.repo:
  - /backup/easysearch
  - /mnt/nfs/backup

创建仓库 #

// 创建快照仓库
PUT _snapshot/backup_repo
{
  "type": "fs",
  "settings": {
    "location": "/backup/easysearch/backup_repo"
  }
}

配置验证 #

# 查看当前配置
GET /_nodes/settings?filter_path=nodes.*.path.repo

# 验证仓库路径
POST _snapshot/backup_repo/_verify

安全建议 #

  1. 权限设置:确保 Easysearch 有读写权限
  2. 磁盘空间:确保有足够空间存储快照
  3. 备份策略:制定定期快照计划
  4. 路径隔离:使用独立路径存储快照

注意事项 #

  1. 静态配置:修改需要重启节点
  2. 必须设置:使用快照功能前必须配置
  3. 路径存在:确保路径存在且可访问
  4. 多节点:集群节点都应配置相同路径
  5. 共享存储:建议使用共享存储系统

相关配置项 #

配置项默认值说明
path.data[]数据存储路径
path.logslogs日志存储路径

完整配置示例 #

# easysearch.yml

# 路径配置
path.data:
  - /data/easysearch
path.logs: /var/log/easysearch
path.repo:
  - /backup/easysearch