API перераспределения кластера

POST /_cluster/reroute

Команда перераспределения позволяет вносить ручные изменения в распределение отдельных фрагментов в кластере. Например, фрагмент можно явно переместить с одного узла на другой, отменить распределение и явно назначить неназначенный фрагмент на конкретный узел.

Важно отметить, что после обработки всех команд перераспределения Elasticsearch выполнит перебалансировку по умолчанию (учитывая значения параметров, таких как cluster.routing.rebalance.enable), чтобы оставаться в сбалансированном состоянии. Например, если в запрошенном распределении указано перемещение фрагмента с node1 на node2, это может привести к перемещению фрагмента с node2 обратно на node1, чтобы выровнять состояние.

Кластер может быть настроен на отключение распределения с помощью параметра cluster.routing.allocation.enable. Если распределение отключено, то будут выполняться только явные распределения, заданные с помощью команды reroute, и последующие распределения из-за перебалансировки.

Можно запускать команды reroute в режиме «сухого запуска», используя параметр запроса URI ?dry_run или передав "dry_run": true в теле запроса. Это рассчитает результат применения команд к текущему состоянию кластера и вернёт состояние кластера после применения команд (и перебалансировки), но фактически не выполнит запрошенные изменения.

Если включён параметр запроса URI ?explain, то в ответе будет подробное объяснение того, почему команды могут быть или не могут быть выполнены.

Кластер попытается распределить фрагмент максимум index.allocation.max_retries раз подряд (по умолчанию 5), прежде чем отказаться и оставить фрагмент нераспределённым. Эта ситуация может быть вызвана структурными проблемами, такими как наличие анализатора, который ссылается на файл стоп-слов, отсутствующий на всех узлах.

После исправления проблемы перераспределение можно вручную повторить, вызвав API reroute с параметром запроса URI ?retry_failed, что позволит выполнить одну попытку повторного распределения для этих фрагментов.

Это короткий пример простого вызова API перераспределения:

POST /_cluster/reroute
{
  "commands": [
    {
      "move": {
        "index": "test", "shard": 0,
        "from_node": "node1", "to_node": "node2"
      }
    },
    {
      "allocate_replica": {
        "index": "test", "shard": 1,
        "node": "node3"
      }
    }
  ]
}