From 43fc74fdfe5d10b42a28b732044b45e241638aa4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?St=C3=A9phanie=20Jaumotte?= Date: Wed, 31 Jul 2024 08:25:00 +0200 Subject: [PATCH] puppet strings --- REFERENCE.md | 52 ++++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 38 insertions(+), 14 deletions(-) diff --git a/REFERENCE.md b/REFERENCE.md index 3ec71e538..a9a67b1c7 100644 --- a/REFERENCE.md +++ b/REFERENCE.md @@ -297,7 +297,9 @@ copying files from the `configdir` to instance `configdir`s. Data type: `String` -File pattern for the file appender log when file_rolling_type is 'dailyRollingFile'. +DEPRECATED, File pattern for the file appender log when file_rolling_type is 'dailyRollingFile'. + +Default value: `"'.'yyyy-MM-dd"` ##### `datadir` @@ -309,9 +311,9 @@ Allows you to set the data directory of Elasticsearch. Data type: `String` -Default logging level for Elasticsearch. +DEPRECATED, Default logging level for Elasticsearch. -Default value: `$logging_level` +Default value: `'INFO'` ##### `defaults_location` @@ -323,14 +325,18 @@ Absolute path to directory containing init defaults file. Data type: `Boolean` -Whether to enable deprecation logging. If enabled, deprecation logs will be +DEPRECATED, Whether to enable deprecation logging. If enabled, deprecation logs will be saved to ${cluster.name}_deprecation.log in the Elasticsearch log folder. +Default value: `false` + ##### `deprecation_logging_level` Data type: `String` -Default deprecation logging level for Elasticsearch. +DEPRECATED, Default deprecation logging level for Elasticsearch. + +Default value: `'DEBUG'` ##### `download_tool` @@ -369,10 +375,12 @@ The user Elasticsearch should run as. This also sets file ownership. Data type: `Enum['dailyRollingFile', 'rollingFile', 'file']` -Configuration for the file appender rotation. It can be 'dailyRollingFile', +DEPRECATED, Configuration for the file appender rotation. It can be 'dailyRollingFile', 'rollingFile' or 'file'. The first rotates by name, the second one by size or third don't rotate automatically. +Default value: `'dailyRollingFile'` + ##### `homedir` Data type: `Stdlib::Absolutepath` @@ -449,28 +457,36 @@ Default value: `'2750'` Data type: `Hash` -Representation of information to be included in the log4j.properties file. +DEPRECATED, Representation of information to be included in the log4j.properties file. + +Default value: `{}` ##### `logging_file` Data type: `Optional[String]` -Instead of a hash, you may supply a `puppet://` file source for the +DEPRECATED, Instead of a hash, you may supply a `puppet://` file source for the log4j.properties file. +Default value: `undef` + ##### `logging_level` Data type: `String` Default logging level for Elasticsearch. +Default value: `'INFO'` + ##### `logging_template` -Data type: `Optional[String]` +Data type: `String` -Use a custom logging template - just supply the relative path, i.e. +DEPRECATED, Use a custom logging template - just supply the relative path, i.e. `$module/elasticsearch/logging.yml.erb` +Default value: `"${module_name}/etc/elasticsearch/log4j2.properties.erb"` + ##### `manage_datadir` Data type: `Boolean` @@ -662,13 +678,17 @@ Define roles via a hash. This is mainly used with Hiera's auto binding. Data type: `Integer` -Max number of logs to store whern file_rolling_type is 'rollingFile' +DEPRECATED, Max number of logs to store whern file_rolling_type is 'rollingFile' + +Default value: `1` ##### `rolling_file_max_file_size` Data type: `String` -Max log file size when file_rolling_type is 'rollingFile' +DEPRECATED, Max log file size when file_rolling_type is 'rollingFile' + +Default value: `'10MB'` ##### `scripts` @@ -687,16 +707,20 @@ Elasticsearch keystore file. If unset, the keystore is left unmanaged. Data type: `Optional[String]` -File content for x-pack logging configuration file (will be placed +DEPRECATED, File content for x-pack logging configuration file (will be placed into log4j2.properties file). +Default value: `undef` + ##### `security_logging_source` Data type: `Optional[String]` -File source for x-pack logging configuration file (will be placed +DEPRECATED, File source for x-pack logging configuration file (will be placed into log4j2.properties). +Default value: `undef` + ##### `service_name` Data type: `String`