community.general.elasticsearch_plugin – Manage Elasticsearch plugins

Note

This plugin is part of the community.general collection (version 3.7.0).

To install it use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.elasticsearch_plugin.

Synopsis

  • Manages Elasticsearch plugins.

Parameters

Parameter Choices/Defaults Comments
force
boolean
    Choices:
  • no ←
  • yes
Force batch mode when installing plugins. This is only necessary if a plugin requires additional permissions and console detection fails.
name
string / required
Name of the plugin to install.
plugin_bin
path
Location of the plugin binary. If this file is not found, the default plugin binaries will be used.
The default changed in Ansible 2.4 to None.
plugin_dir
path
Default:
"/usr/share/elasticsearch/plugins/"
Your configured plugin directory specified in Elasticsearch
proxy_host
string
Proxy host to use during plugin installation
proxy_port
string
Proxy port to use during plugin installation
src
string
Optionally set the source location to retrieve the plugin from. This can be a file:// URL to install from a local file, or a remote URL. If this is not set, the plugin location is just based on the name.
The name parameter must match the descriptor in the plugin ZIP specified.
Is only used if the state would change, which is solely checked based on the name parameter. If, for example, the plugin is already installed, changing this has no effect.
For ES 1.x use url.
state
string
    Choices:
  • present ←
  • absent
Desired state of a plugin.
timeout
string
Default:
"1m"
Timeout setting: 30s, 1m, 1h...
Only valid for Elasticsearch < 5.0. This option is ignored for Elasticsearch > 5.0.
url
string
Set exact URL to download the plugin from (Only works for ES 1.x).
For ES 2.x and higher, use src.
version
string
Version of the plugin to be installed. If plugin exists with previous version, it will NOT be updated

Examples

- name: Install Elasticsearch Head plugin in Elasticsearch 2.x
  community.general.elasticsearch_plugin:
    name: mobz/elasticsearch-head
    state: present

- name: Install a specific version of Elasticsearch Head in Elasticsearch 2.x
  community.general.elasticsearch_plugin:
    name: mobz/elasticsearch-head
    version: 2.0.0

- name: Uninstall Elasticsearch head plugin in Elasticsearch 2.x
  community.general.elasticsearch_plugin:
    name: mobz/elasticsearch-head
    state: absent

- name: Install a specific plugin in Elasticsearch >= 5.0
  community.general.elasticsearch_plugin:
    name: analysis-icu
    state: present

- name: Install the ingest-geoip plugin with a forced installation
  community.general.elasticsearch_plugin:
    name: ingest-geoip
    state: present
    force: yes

Authors

  • Mathew Davies (@ThePixelDeveloper)

  • Sam Doran (@samdoran)