Going forward, This module will follow Elasticsearch's upstream major version to indicate compatability.
That is, version 5.x of this module supports version 5 of Elasticsearch, and version 6.x of this module will be released once Elasticsearch 6 support is added.
Summary
Note that this is a major version release!
Please read the release notes carefully before upgrading to avoid downtime/unexpected behavior.
Remember to restart any puppetmaster servers to clear provider caches and pull in updated code.
Backwards-Incompatible Changes
- The
elasticsearch:🛡️ :user
andelasticsearch:🛡️ :role
resources have been renamed toelasticsearch::user
andelasticsearch::role
since the resource now handles both Shield and X-Pack.
- Both Shield and X-Pack configuration files are kept in
/etc/elasticsearch/shield
and/etc/elasticsearch/x-pack
, respectively. If you previously managed Shield resources with version 0.x of this module, you may need to migrate files from/usr/share/elasticsearch/shield
.
- The default data directory has been changed to
/var/lib/elasticsearch
. If you used the previous default (the Elasticsearch home directory,/usr/share/elasticsearch/data
), you may need to migrate your data.
- The first changes that may be Elasticsearch 1.x-incompatible have been introduced (see the elasticsearch support lifecycle). This only impacts version 1.x running on systemd-based distributions.
- sysctl management has been removed (and the module removed as a dependency for this module), and puppet/yum is used in lieu of ceritsc/yum.
Features
- Support management of the global jvm.options configuration file.
- X-Pack support added.
- Restricted permissions to the elasticsearch.yml file.
- Deprecation log configuration support added.
- Synced systemd service file with upstream.
Bugfixes
- Fixed case in which index template could prepend an additional 'index.' to index settings.
- Fixed a case in which dependency cycles could arise when pinning packages on CentOS.
- No longer recursively change the Elasticsearch home directory's lib/ to the elasticsearch user.
- Unused defaults values now purged from instance init defaults files.
Changes
- Changed default data directory to /var/lib
- sysctl settings are no longer managed by the thias/sysctl module.
- Calls to
elasticsearch -version
in elasticsearch::plugin code replaced with native Puppet code to resolve Elasticsearch package version. Should improve resiliency when managing plugins.
- Shield and X-Pack configuration files are stored in /etc/elasticsearch instead of /usr/share/elasticsearch.
- Removed deprecated ceritsc/yum module in favor of puppet/yum.