Puppet Elasticsearch Versions Save

This is a new major version release of the Elasticsearch module that contains a number of breaking changes and adds support for deploying and managing Elasticsearch 7.x.

Breaking changes

Removed support for running multiple instances of Elasticsearch on a single host Removed support for Elasticsearch older than version 6.x

Features

Support for deploying Elasticsearch 7.x Support and Testing for a number of newer OS'

• Amazon Linux 2
• CentOS 8
• Oracle Linux 8
• Debian 10
• Ubuntu 18.04
• Ubuntu 20.04

Bug fixes

Various little bug fixes as a result of cleaning up and refactoring a lot of the code.

Features

• Support for Puppet 6

Fixes

• Fix "Could not autoload" errors in some custom types/providers.
• Resolved an issue arising from the use of hiera() in Hiera yaml data files.

Puppet < 4.10 No Longer Supported

Puppet 4.10.0 is the new minimum required version of Puppet.

Fixes

• The Elasticsearch log directory is no longer recursively managed to avoid stomping on the user/mode settings that Elasticsearch prefers.
• Package management on apt-based systems no longer encounters dependency errors when manage_repo => false.
• Plugin configuration files are now more well-supported by respecting subdirectory copy recursion. See elasticsearch::configdir_recurselimit for more information.
• An error related to elasticsearch_roles and yield errors has been fixed
• Correctly permit instances to be set to absent without errors.

Note that this release includes changes to a default value that may affect users that rely on curl or wget to retrieve Elasticsearch package files, as now all certificates are validated by default. To preserve existing behavior, set $elasticsearch::download_tool_verify_certificates to false.

Fixes

• Update puppetlabs-stdlib dependency to < 6.0.0
• By default, package files downloaded with tools like wget or curl (i.e., the $elasticsearch::download_tool parameter) now verify certificates by default and a new boolean parameter has been added to indicate whether to ignore certificates ($elasticsearch::download_tool_verify_certificates).

Fixes

• Fix an issue with string coercion for certain fields in pipelines.

6.3.1 (August 6, 2018)

Primarily a bugfix release.

Fixes

• REST-based resources are now coerced to string values to uniformly compare user defined values and Elasticsearch API responses.
• Resolve deprecation warnings related to use of the deprecated is_array() function.
• Fixed an erroneous inclusion of '<' in logging.yml
• Resolve deprecation warnings related to use of the deprecated is_string() function.

Migration Guide

Elasticsearch 6.3 includes several big changes that are reflected in this module. When upgrading from module versions prior to 6.3, there are a number of upgrade considerations to take into account:

• This module defaults to the upstream package repositories, which now include X-Pack bundled by default. To preserve previous behavior which does not include X-Pack, follow the README instructions to configure oss-only repositories/packages.
  • Note that if your system was previously using the elasticsearch package and you instead choose to move to the oss distribution, the elasticsearch and elasticsearch-oss packages may conflict. If that occurs, consider ensuring that the elasticsearch package is absent before the ::elasticsearch class runs. This module does not explicitly remove the conflicting package to avoid unexpected package removal.
• Use of the elastic_stack::repo class for managing package repositories brings a couple changes:
  • All repository-level parameters and settings have been removed from the ::elasticsearch class. These parameters can now be set on the elastic_stack::repo class.
  • This may mean that leftover yum/apt/etc. repositories named elasticsearch may persist after upgrade.
• Some changes have been made to align this module's file-level permissions with upstream defaults on some configuration, data, and logging directories. Though these have been tested, operators should be aware that some permissions may change on-disk after upgrading to version >= 6.3.x of this module.

Features

• Added support for managing Elasticsearch licenses.
• This module now uses the elastic-stack module to manage package repositories.
• Supports OSS packaging distribution.
• X-Pack bundled with 6.3 support.

Fixes

• Ensure that the stock Elasticsearch service is not running.
• Service files for removed instances were previously set to ensure => absent on removal. Because this limits Puppet's ability to verify that the named service is running or not, these service files are always present now whether an instance is set to present or absent.
• The service defaults file now enforces user/group ownership inline with the service user runtime.
• The scripts configuration directory is now recursively copied instead of symlinked to avoid Elasticsearch security manager permission errors.
• X-Pack and other meta-plugins are now properly detected as installed by the native plugin provider.

Fixes

• Fixed language compatibility errors that could arise when using JRuby 1.7 on Puppet Servers.

This is primarily a bugfix release to address an issue when installing Elasticsearch 6.2.x plugins such as X-Pack that use the new meta-plugin architecture. While the change has been tested with several plugins and versions of Elasticsearch, if any unexpected behavior arises, help is available on the Elastic forums or via an issue in the puppet-elasticsearch Github repository.

Fixes

• Rewrote the exists? logic for the elasticsearch_plugin provider. This fundamentally changes how the module detects the presence of plugins but should be backwards compatible.

Features

• Add support for Amazon Linux 2
• Add support for managing Elasticsearch Snapshot Repository resources

Fixes

• Fixed an issue when setting file_rolling_type => file in Elasticsearch 6.
• Removed ExecStartPre=- from systemd template