Перейти к основному содержимому
Версия: 4.0

Управление плагинами

Управление плагинами производится с помощью следующих утилит:

  • opensearch-plugin
  • opensearch-dashboards-plugin
  • logstash-plugin

Просмотр списка плагинов

OpenSearch

Для просмотра списка плагинов OpenSearch используйте команду:

$OPENSEARCH_HOME/bin/opensearch-plugin list

OpenSearch Dashboards

Для просмотра списка плагинов OpenSearch Dashboards используйте команду:

$OPENSEARCH_DASHBOARDS_HOME/bin/opensearch-dashboards-plugin list
предупреждение

При выполнении команды под пользователем root потребуется использования флага --allow-root. Пример:

$OPENSEARCH_DASHBOARDS_HOME/bin/opensearch-dashboards-plugin list --allow-root

Logstash

Для просмотра списка плагинов Logstash используйте команду:

$LOGSTASH_HOME/bin/logstash-plugin list

Установка плагинов

Используйте команду install для установки плагинов. После выполнения команды требуется перезапуск сервиса.

OpenSearch

Для установки плагина OpenSearch используйте команду:

$OPENSEARCH_HOME/bin/opensearch-plugin install file://<абсолютный путь к архиву>
systemctl restart opensearch

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

Для принудительного включения пакетного режима, указав -b или --batch следующим образом:

$OPENSEARCH_HOME/bin/opensearch-plugin install file://<абсолютный путь к архиву> --batch

OpenSearch Dashboards

Для установки плагина OpenSearch Dashboards используйте команду:

$OPENSEARCH_DASHBOARDS_HOME/bin/opensearch-dashboards-plugin install file://<абсолютный путь к архиву>
systemctl restart opensearch-dashboards
предупреждение

При выполнении команды под пользователем root потребуется использования флага --allow-root. Пример:

$OPENSEARCH_DASHBOARDS_HOME/bin/opensearch-dashboards-plugin install file://<абсолютный путь к архиву> --allow-root

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

осторожно

При установке или обновлении плагина требуется увеличение параметра build.number в файле:

$OPENSEARCH_DASHBOARDS_HOME/package.json

Это требуется для сброса кэша, сохраняемого браузером. Если этот шаг будет пропущен, изменения в интерфейсе пользователей могут не примениться.

Пример изменения параметра:

...
"build": {
- "number": 6870
+ "number": 6871
}
...

Выполните перезапуск сервиса.

Logstash

Используйте следующие форматы файлов:

  • gem
  • zip

Для установки плагина используйте команду:

$LOGSTASH_HOME/bin/logstash-plugin install file://<путь к плагину>
systemctl restart logstash

Удаление плагинов

Используйте команду remove для удаления установленного плагина. После выполнения команды требуется перезапуск сервиса.

OpenSearch

Для удаления плагина OpenSearch используйте команду:

$OPENSEARCH_HOME/bin/opensearch-plugin remove <имя плагина>
systemctl restart opensearch

OpenSearch Dashboards

Для удаления плагина OpenSearch Dashboards используйте команду:

$OPENSEARCH_DASHBOARDS_HOME/bin/opensearch-dashboards-plugin remove <имя плагина>
systemctl restart opensearch-dashboards
предупреждение

При выполнении команды под пользователем root потребуется использования флага --allow-root. Пример:

$OPENSEARCH_DASHBOARDS_HOME/bin/opensearch-dashboards-plugin remove <имя плагина> --allow-root
осторожно

При удалении плагина требуется увеличение параметра build.number в файле:

$OPENSEARCH_DASHBOARDS_HOME/package.json

Это требуется для сброса кэша, сохраняемого браузером. Если этот шаг будет пропущен, изменения в интерфейсе пользователей могут не примениться.

Пример изменения параметра:

...
"build": {
- "number": 6870
+ "number": 6871
}
...

Выполните перезапуск сервиса.

Logstash

Для удаления плагина Logstash используйте команду:

$LOGSTASH_HOME/bin/logstash-plugin remove <имя плагина>
systemctl restart logstash