diff --git a/README.md b/README.md index 99d5e9e..063700d 100644 --- a/README.md +++ b/README.md @@ -38,10 +38,10 @@ hosts: my_host roles: - elasticsearch vars: - java_debian: - - "openjdk-7-jre-headless" - es_major_version: 1.7 - es_version: 1.7.0 + java_packages: + - "oracle-java7-installer" + es_major_version: 1.4 + es_version: 1.4.4 es_start_service: false es_plugins_reinstall: false es_plugins: @@ -72,75 +72,19 @@ ansible-playbook -i hosts ./your-playbook.yml ## Configuration You can add the role without any customisation and it will by default install Java and Elasticsearch, without any plugins. -#### Description of the variables available. +Following variables affect the versions installed: -```es_major_version``` (e.g. `1.7` ) - -Which major version to use. This is also used to define which the repository is used. - -```es_version``` (e.g. `1.7.0`) - -Which minor version to use. - -```es_start_service``` (true (default) or false) - -Should elasticsearch be started after installation? - -```es_use_repository``` (true (default) or false ) - -Should elasticsearch be installed from a repository or from a url download. If false package will be downloaded from https://download.elastic.co/elasticsearch/elasticsearch/elasticsearch.... You can also specify `es_custom_package_url` with a url to a custom package. - -```es_version_lock``` (true or false (default)) - -This will lock the elasticsearch version using `yum versionlock`. Only available on RHEL/CentOS. For Debian/Ubuntu see `apt pinning` below. - -```es_scripts``` (true or false (default)) - -If true you need to supply a files/scripts/ folder with your scripts, inside the role directory. The folder and all files will be copied to `/etc/elasticsearch/scripts`. You can also provide a scripts/ folder at toplevel of your playbook. - - -```es_plugins_reinstall``` (true or false (default) ) - -Schould plugins be reinstalled? - -```es_plugins``` (an array of plugin definitons e.g.:) +* ```es_major_version``` (e.g. "1.5" ) +* ```es_version``` (e.g. "1.5.2") +* ```es_start_service``` (true (default) or false) +* ```es_plugins_reinstall``` (true or false (default) ) +* ```es_plugins``` (an array of plugin definitons e.g.: ``` - es_plugins: - - plugin: elasticsearch-cloud-aws - version: 2.5.0 -``` + es_plugins: + - plugin: elasticsearch-cloud-aws + version: 2.5.0 + ``` -`java_debian` - -name of the java debian package to use (e.g. `openjdk-7-jre-headless`) - -`java_rhel` - -name of the java rhel package to use (e.g. `java-1.8.0-openjdk.x86_64`) - -## apt pinning -apt pinning is possible using an external role like https://github.com/debops/ansible-apt_preferences. - -To use this, add it as another role e.g. -``` -cd /my/repos/ -git clone git@github.com:debops/ansible-apt_preferences.git -cd /my/ansible/playbook -mkdir -p roles -ln -s /my/repos/ansible-apt_preferences ./roles/apt_preferences -``` - -then add something like this to your playook: -``` - roles: - - apt_preferences - - elasticsearch - vars: - ... - apt_preferences_list: - - package: elasticsearch - version: 1.7.0 - ... - -``` +* ```java_repos``` (an array of repositories to be added to allow java to be installed) +* ```java_packages``` (an array of packages to be installed to get Java installed)