ansible.builtin.elasticsearch_plugin (v2.6.0) — module

Install Ansible via pip

Install with pip install ansible==2.6.0

Description

Manages Elasticsearch plugins.

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

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

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

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

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

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

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

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

Inputs

    
url:
    description:
    - Set exact URL to download the plugin from (Only works for ES 1.x)

name:
    description:
    - Name of the plugin to install. In Eleasticsearch >= 2.0, the name can be an URL
      or file location.
    required: true

state:
    choices:
    - present
    - absent
    default: present
    description:
    - Desired state of a plugin.

timeout:
    default: 1m
    description:
    - 'Timeout setting: 30s, 1m, 1h...'
    - Only valid for Elasticsearch < 5.0. This option is ignored for Elasticsearch > 5.0.

version:
    description:
    - Version of the plugin to be installed. If plugin exists with previous version, it
      will NOT be updated

plugin_bin:
    description:
    - 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:
    default: /usr/share/elasticsearch/plugins/
    description:
    - Your configured plugin directory specified in Elasticsearch

proxy_host:
    description:
    - Proxy host to use during plugin installation
    version_added: '2.1'
    version_added_collection: ansible.builtin

proxy_port:
    description:
    - Proxy port to use during plugin installation
    version_added: '2.1'
    version_added_collection: ansible.builtin