› › ›

Руководство по миграции временных настроек

Мы больше не рекомендуем использовать временные настройки кластера. Вы можете использовать временные настройки для внесения временных изменений в конфигурацию кластера. Однако перезагрузка кластера или нестабильность кластера могут неожиданно очистить эти настройки, что приведет к потенциально нежелательной конфигурации кластера.

Чтобы избежать этого риска, сбросьте все временные настройки, которые вы настроили в своем кластере. Преобразуйте любые временные настройки, которые вы хотите сохранить, в постоянные настройки, которые сохраняются при перезагрузке кластера и его нестабильности. Вы также должны обновить все пользовательские рабочие процессы и приложения, чтобы использовать постоянные настройки вместо временных.

Некоторые продукты Elastic могут использовать временные настройки при выполнении определенных операций. Сбрасывайте только временные настройки, настроенные вами, вашими пользователями или вашими пользовательскими рабочими процессами и приложениями.

Для сброса и преобразования временных настроек:

Получите список всех настроенных временных настроек, используя API получения настроек кластера.
```
response = client.cluster.get_settings(
  flat_settings: true,
  filter_path: 'transient'
)
puts response
```
```
GET _cluster/settings?flat_settings=true&filter_path=transient
```
API возвращает временные настройки в объекте transient. Если этот объект пуст, в вашем кластере нет временных настроек, и вы можете пропустить оставшиеся шаги.
```
{
  "persistent": { ... },
  "transient": {
    "cluster.indices.close.enable": "false",
    "indices.recovery.max_bytes_per_sec": "50mb"
  }
}
```

Скопируйте любые настройки, которые вы хотите преобразовать, в объект persistent запроса API обновления настроек кластера. В том же запросе сбросьте все временные настройки, присвоив им значение null.

response = client.cluster.put_settings(
  body: {
    persistent: {
      'cluster.indices.close.enable' => false,
      'indices.recovery.max_bytes_per_sec' => '50mb'
    },
    transient: {
      "*": nil
    }
  }
)
puts response

PUT _cluster/settings
{
  "persistent": {
    "cluster.indices.close.enable": false,
    "indices.recovery.max_bytes_per_sec": "50mb"
  },
  "transient": {
    "*": null
  }
}

Используйте API получения настроек кластера, чтобы подтвердить, что в вашем кластере больше нет временных настроек.
```
response = client.cluster.get_settings(
  flat_settings: true
)
puts response
```
```
GET _cluster/settings?flat_settings=true
```
Если объект transient пуст, в вашем кластере нет временных настроек.
```
{
  "persistent": {
    "cluster.indices.close.enable": "false",
    "indices.recovery.max_bytes_per_sec": "50mb",
    ...
  },
  "transient": {
  }
}
```

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/8.17/transient-settings-migration-guide.html