dev/provisioning/modules/elasticsearch/CHANGELOG.md
changeset 406 cf0f23803a53
parent 28 b0b56e0f8c7f
equal deleted inserted replaced
405:f239c8c5bb94 406:cf0f23803a53
       
     1 ## x.x.x (Month Day, Year)
       
     2 
       
     3 ### Summary
       
     4 * Support for Ubuntu Xenial (16.04) formally declared.
       
     5 
       
     6 #### Features
       
     7 * Support management of 5.x-style Elastic yum/apt package repositories.
       
     8 
       
     9 #### Bugfixes
       
    10 * Update the apt::source call to not cause deprecation warnings
       
    11 * Updated module metadata to correctly require puppet-stdlib with validate_integer()
       
    12 
       
    13 #### Changes
       
    14 
       
    15 #### Testing changes
       
    16 * Ubuntu Xenial (16.04) added to the test matrix.
       
    17 
       
    18 ## 0.14.0 (October 12, 2016)
       
    19 
       
    20 ### Summary
       
    21 Primarily a bugfix release for issues related to plugin proxy functionality, various system service fixes, and directory permissions.
       
    22 This release also adds the ability to define logging rolling file settings and a CA file/path for template API access.
       
    23 
       
    24 #### Features
       
    25 * Added 'file_rolling_type' parameter to allow selecting file logging rotation type between "dailyRollingFile" or "rollingFile". Also added 'daily_rolling_date_pattern', 'rolling_file_max_backup_index' and 'rolling_file_max_file_size' for file rolling customization.
       
    26 
       
    27 #### Bugfixes
       
    28 * Permissions on the Elasticsearch plugin directory have been fixed to permit world read rights.
       
    29 * The service systemd unit now `Wants=` a network target to fix bootup parallelization problems.
       
    30 * Recursively create the logdir for elasticsearch when creating multiple instances
       
    31 * Files and directories with root ownership now specify UID/GID 0 instead to improve compatability with *BSDs.
       
    32 * Elasticsearch Debian init file changed to avoid throwing errors when DATA_DIR, WORK_DIR and/or LOG_DIR were an empty variable.
       
    33 * Fixed a broken File dependency when a plugin was set to absent and ::elasticsearch set to present.
       
    34 * Fixed issue when using the `proxy` parameter on plugins in Elasticsearch 2.x.
       
    35 
       
    36 #### Changes
       
    37 * The `api_ca_file` and `api_ca_path` parameters have been added to support custom CA bundles for API access.
       
    38 * Numerics in elasticsearch.yml will always be properly unquoted.
       
    39 * puppetlabs/java is now listed as a dependency in metadata.json to avoid unexpected installation problems.
       
    40 
       
    41 #### Testing changes
       
    42 
       
    43 ## 0.13.2 (August 29, 2016)
       
    44 
       
    45 ### Summary
       
    46 Primarily a bugfix release to resolve HTTPS use in elasticsearch::template resources, 5.x plugin operations, and plugin file permission enforcement.
       
    47 
       
    48 #### Features
       
    49 * Plugin installation for the 5.x series of Elasticsearch is now properly supported.
       
    50 
       
    51 #### Bugfixes
       
    52 * Recursively enforce correct plugin directory mode to avoid Elasticsearch startup permissions errors.
       
    53 * Fixed an edge case where dependency cycles could arise when managing absent resources.
       
    54 * Elasticsearch templates now properly use HTTPS when instructed to do so.
       
    55 
       
    56 #### Changes
       
    57 * Updated the elasticsearch_template type to return more helpful error output.
       
    58 * Updated the es_instance_conn_validator type to silence deprecation warnings in Puppet >= 4.
       
    59 
       
    60 #### Testing changes
       
    61 
       
    62 ## 0.13.1 (August 8, 2016)
       
    63 
       
    64 ### Summary
       
    65 Lingering bugfixes from elasticsearch::template changes.
       
    66 More robust systemd mask handling.
       
    67 Updated some upstream module parameters for deprecation warnings.
       
    68 Support for the Shield `system_key` file.
       
    69 
       
    70 #### Features
       
    71 * Added `system_key` parameter to the `elasticsearch` class and `elasticsearch::instance` type for placing Shield system keys.
       
    72 
       
    73 #### Bugfixes
       
    74 * Fixed systemd elasticsearch.service unit masking to use systemctl rather than raw symlinking to avoid puppet file backup errors.
       
    75 * Fixed a couple of cases that broke compatability with older versions of puppet (elasticsearch_template types on puppet versions prior to 3.6 and yumrepo parameters on puppet versions prior to 3.5.1)
       
    76 * Fixed issues that caused templates to be incorrectly detected as out-of-sync and thus always changed on each puppet run.
       
    77 * Resources are now explicitly ordered to ensure behavior such as plugins being installed before instance start, users managed before templates changed, etc.
       
    78 
       
    79 #### Changes
       
    80 * Updated repository gpg fingerprint key to long form to silence module warnings.
       
    81 
       
    82 #### Testing changes
       
    83 
       
    84 ## 0.13.0 (August 1, 2016)
       
    85 
       
    86 ### Summary
       
    87 Rewritten elasticsearch::template using native type and provider.
       
    88 Fixed and added additional proxy parameters to elasticsearch::plugin instances.
       
    89 Exposed repo priority parameters for apt and yum repos.
       
    90 
       
    91 #### Features
       
    92 * In addition to better consistency, the `elasticsearch::template` type now also accepts various `api_*` parameters to control how access to the Elasticsearch API is configured (there are top-level parameters that are inherited and can be overwritten in `elasticsearch::api_*`).
       
    93 * The `elasticsearch::config` parameter now supports deep hiera merging.
       
    94 * Added the `elasticsearch::repo_priority` parameter to support apt and yum repository priority configuration.
       
    95 * Added `proxy_username` and `proxy_password` parameters to `elasticsearch::plugin`.
       
    96 
       
    97 #### Bugfixes
       
    98 * Content of templates should now properly trigger new API PUT requests when the index template stored in Elasticsearch differs from the template defined in puppet.
       
    99 * Installing plugins with proxy parameters now works correctly due to changed Java property flags.
       
   100 * The `elasticsearch::plugin::module_dir` parameter has been re-implemented to aid in working around plugins with non-standard plugin directories.
       
   101 
       
   102 #### Changes
       
   103 * The `file` parameter on the `elasticsearch::template` defined type has been deprecated to be consistent with usage of the `source` parameter for other types.
       
   104 
       
   105 #### Testing changes
       
   106 
       
   107 ## 0.12.0 (July 20, 2016)
       
   108 
       
   109 IMPORTANT! A bug was fixed that mistakenly added /var/lib to the list of DATA_DIR paths on Debian-based systems.  This release removes that environment variable, which could potentially change path.data directories for instances of Elasticsearch.  Take proper precautions when upgrading to avoid unexpected downtime or data loss (test module upgrades, et cetera).
       
   110 
       
   111 ### Summary
       
   112 Rewritten yaml generator, code cleanup, and various bugfixes. Configuration file yaml no longer nested. Service no longer restarts by default, and exposes more granular restart options.
       
   113 
       
   114 #### Features
       
   115 * The additional parameters restart_config_change, restart_package_change, and restart_plugin_change have been added for more granular control over service restarts.
       
   116 
       
   117 #### Bugfixes
       
   118 * Special yaml cases such as arrays of hashes and strings like "::" are properly supported.
       
   119 * Previous Debian SysV init scripts mistakenly set the `DATA_DIR` environment variable to a non-default value.
       
   120 * Some plugins failed installation due to capitalization munging, the elasticsearch_plugin provider no longer forces downcasing.
       
   121 
       
   122 #### Changes
       
   123 * The `install_options` parameter on the `elasticsearch::plugin` type has been removed. This was an undocumented parameter that often caused problems for users.
       
   124 * The `elasticsearch.service` systemd unit is no longer removed but masked by default, effectively hiding it from systemd but retaining the upstream vendor unit on disk for package management consistency.
       
   125 * `restart_on_change` now defaults to false to reduce unexpected cluster downtime (can be set to true if desired).
       
   126 * Package pinning is now contained within a separate class, so users can opt to manage package repositories manually and still use this module's pinning feature.
       
   127 * All configuration hashes are now flattened into dot-notated yaml in the elasticsearch configuration file. This should be fairly transparent in terms of behavior, though the config file formatting will change.
       
   128 
       
   129 #### Testing changes
       
   130 * The acceptance test suite has been dramatically slimmed to cut down on testing time and reduce false positives.
       
   131 
       
   132 ## 0.11.0 ( May 23, 2016 )
       
   133 
       
   134 ### Summary
       
   135 Shield support, SLES support, and overhauled testing setup.
       
   136 
       
   137 #### Features
       
   138 * Support for shield
       
   139   * TLS Certificate management
       
   140   * Users (role and password management for file-based realms)
       
   141   * Roles (file-based with mapping support)
       
   142 * Support (repository proxies)[https://github.com/elastic/puppet-elasticsearch/pull/615]
       
   143 * Support for (SSL auth on API calls)[https://github.com/elastic/puppet-elasticsearch/pull/577]
       
   144 
       
   145 #### Bugfixes
       
   146 * (Fix Facter calls)[https://github.com/elastic/puppet-elasticsearch/pull/590] in custom providers
       
   147 
       
   148 #### Changes
       
   149 
       
   150 #### Testing changes
       
   151 * Overhaul testing methodology, see CONTRIBUTING for updates
       
   152 * Add SLES 12, Oracle 6, and PE 2016.1.1 to testing matrix
       
   153 * Enforce strict variable checking
       
   154 
       
   155 #### Known bugs
       
   156 * This is the first release with Shield support, some untested edge cases may exist
       
   157 
       
   158 
       
   159 ##0.10.3 ( Feb 08, 2016 )
       
   160 
       
   161 ###Summary
       
   162 Adding support for OpenBSD and minor fixes
       
   163 
       
   164 ####Features
       
   165 * Add required changes to work with ES 2.2.x plugins
       
   166 * Support for custom log directory
       
   167 * Support for OpenBSD
       
   168 
       
   169 ####Bugfixes
       
   170 * Add correct relation to file resource and plugin installation
       
   171 * Notify service when upgrading the package
       
   172 
       
   173 ####Changes
       
   174 * Remove plugin dir when upgrading Elasticsearch
       
   175 
       
   176 ####Testing changes
       
   177 
       
   178 ####Known bugs
       
   179 * Possible package conflicts when using ruby/python defines with main package name
       
   180 
       
   181 
       
   182 ##0.10.2 ( Jan 19, 2016 )
       
   183 
       
   184 ###Summary
       
   185 Bugfix release and adding Gentoo support
       
   186 
       
   187 ####Features
       
   188 * Added Gentoo support
       
   189 
       
   190 ####Bugfixes
       
   191 * Create init script when set to unmanaged
       
   192 * init_template variable was not passed on correctly to other classes / defines
       
   193 * Fix issue with plugin type that caused run to stall
       
   194 * Export ES_GC_LOG_FILE in init scripts
       
   195 
       
   196 ####Changes
       
   197 * Improve documentation about init_defaults
       
   198 * Update common files
       
   199 * Removed recurse option on data directory management
       
   200 * Add retry functionality to plugin type
       
   201 
       
   202 ####Testing changes
       
   203 
       
   204 ####Known bugs
       
   205 * Possible package conflicts when using ruby/python defines with main package name
       
   206 
       
   207 
     1 ##0.10.1 ( Dec 17, 2015 )
   208 ##0.10.1 ( Dec 17, 2015 )
     2 
   209 
     3 ###Summary
   210 ###Summary
     4 Bugfix release for proxy functionality in plugin installation
   211 Bugfix release for proxy functionality in plugin installation
     5 
   212