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

Install Ansible via pip

Install with pip install ansible==2.9.27

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

Scanned by Steampunk Spotter

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

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

Inputs

    
src:
    description:
    - 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.
    required: false
    version_added: '2.7'
    version_added_collection: ansible.builtin

url:
    description:
    - Set exact URL to download the plugin from (Only works for ES 1.x).
    - For ES 2.x and higher, use src.
    required: false

name:
    description:
    - Name of the plugin to install.
    required: true

force:
    default: false
    description:
    - Force batch mode when installing plugins. This is only necessary if a plugin requires
      additional permissions and console detection fails.
    type: bool
    version_added: '2.7'
    version_added_collection: ansible.builtin

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