getting-started.md

Collection Elastic Stack

Installation

You can easily install the collection with the ansible-galaxy command.

ansible-galaxy collection install netways.elasticstack

Or if you are using Tower or AWX add the collection to your requirements file.

collections:
  - name: netways.elasticstack

Usage

To use the collection in your Ansible playbook add the following key to your playbook.

- name: Playbook
  hosts: some_host_pattern
  collections:
    - netways.elasticstack
  tasks:
    - name: import role logstash
      import_role:
        name: logstash

Or refer to the role with the FQCN of the role.

- name: Playbook
  hosts: some_host_pattern
  tasks:
    - name: import role by FQCN  from a collection
      import_role:
        name: netways.elasticstack.logstash

Roles

• Beats
• Elasticsearch
• Kibana
• Logstash
• Repos

Variables

Every role got its own set of variables, in addition a few variables are useable on any role. Below are all general collection vars.

• elasticstack_release: Major release version of Elastic stack to configure. (default: 7)
• elasticstack_variant: Variant of the stack to install. Valid values: elastic or oss. (default: elastic)