elasticsearch/docs/reference
Jason Tedor a914d84429
Introduce node.roles setting (#54998)
Today we have individual settings for configuring node roles such as
node.data and node.master. Additionally, roles are pluggable and we have
used this to introduce roles such as node.ml and node.voting_only. As
the number of roles is growing, managing these becomes harder for the
user. For example, to create a master-only node, today a user has to
configure:
 - node.data: false
 - node.ingest: false
 - node.remote_cluster_client: false
 - node.ml: false

at a minimum if they are relying on defaults, but also add:
 - node.master: true
 - node.transform: false
 - node.voting_only: false

If they want to be explicit. This is also challenging in cases where a
user wants to have configure a coordinating-only node which requires
disabling all roles, a list which we are adding to, requiring the user
to keep checking whether a node has acquired any of these roles.

This commit addresses this by adding a list setting node.roles for which
a user has explicit control over the list of roles that a node has. If
the setting is configured, the node has exactly the roles in the list,
and not any additional roles. This means to configure a master-only
node, the setting is merely 'node.roles: [master]', and to configure a
coordinating-only node, the setting is merely: 'node.roles: []'.

With this change we deprecate the existing 'node.*' settings such as
'node.data'.
2020-06-24 14:46:31 -04:00
..
aggregations Add Variable Width Histogram Aggregation (#42035) 2020-06-23 09:26:54 -04:00
analysis [DOCS] Reformat pattern_replace token filter (#57699) 2020-06-11 12:04:22 -04:00
autoscaling Add get autoscaling policy API (#54762) 2020-04-04 17:52:54 -04:00
cat [DOCS] Updates pull and issue release attributes (#58348) 2020-06-18 12:38:49 -07:00
ccr Allow follower indices to override leader settings (#58103) 2020-06-18 10:55:17 -04:00
cluster [DOCS] Updates pull and issue release attributes (#58348) 2020-06-18 12:38:49 -07:00
commands Introduce node.roles setting (#54998) 2020-06-24 14:46:31 -04:00
data-streams [DOCS] Reword tip in data streams overview 2020-06-23 08:56:41 -04:00
docs [DOCS] Add data streams to bulk, delete, and index API docs (#58340) 2020-06-23 09:18:28 -04:00
eql [DOCS] EQL: Correct EQL search API's size param def 2020-06-10 10:13:18 -04:00
graph [DOCS] Collapse nested objects in Explore API docs (#55067) 2020-04-13 09:26:18 -04:00
high-availability [DOCS] Fixes license management links (#58213) 2020-06-16 16:43:54 -07:00
how-to [DOCS] Replace docdir attribute with es-repo-dir (#57489) 2020-06-01 15:55:05 -07:00
ilm [DOCS] Make ILM documentation data stream aware (#58035) 2020-06-15 14:14:07 +01:00
images add geo_shape documentation for supported aggregations (#58284) 2020-06-18 10:17:49 -07:00
index-modules Remove slowlog level (#57591) 2020-06-04 13:33:28 +02:00
indices [DOCS] Update aliases to indicate array (#58469) 2020-06-24 09:38:53 -04:00
ingest Update hh to HH in date processor example (#58089) (#58142) 2020-06-15 17:03:42 -05:00
licensing Remove _xpack from license API example (#54698) 2020-04-04 17:52:55 +03:00
mapping [DOCS] Move search API's docvalue_fields examples (#57760) 2020-06-11 10:57:15 -04:00
migration Check for negative "from" values in search request body (#54953) 2020-05-28 16:25:19 +02:00
ml [DOCS] Updates screenshots in ML population analysis (#58318) 2020-06-23 09:03:31 +02:00
modules Introduce node.roles setting (#54998) 2020-06-24 14:46:31 -04:00
monitoring [DOCS] Rename monitoring collection from internal to legacy (#56395) 2020-06-11 10:16:53 -07:00
query-dsl [DOCS] Extends geo_shape query docs to explain behavior when data is indexed as array of shapes (#57806) 2020-06-08 15:03:59 +02:00
release-notes [DOCS] Updates pull and issue release attributes (#58348) 2020-06-18 12:38:49 -07:00
rest-api [DOCS] Add data streams to bulk, delete, and index API docs (#58340) 2020-06-23 09:18:28 -04:00
rollup [DOCS] Adds collapsible sections to rollup APIs (#54690) 2020-04-02 17:40:53 -07:00
scripting [DOCS] Fixes problematic terminology (#58178) 2020-06-16 09:23:11 -07:00
search Field capabilities - make keyword a family of field types (#58315) 2020-06-24 11:37:16 +01:00
searchable-snapshots/apis [DOCS] Replace docdir attribute with es-repo-dir (#57489) 2020-06-01 15:55:05 -07:00
settings [DOCS] Fixes license management links (#58213) 2020-06-16 16:43:54 -07:00
setup [DOCS] Fixes license management links (#58213) 2020-06-16 16:43:54 -07:00
slm [DOCS] Editorial ILM cleanup (#57565) 2020-06-05 16:24:03 -07:00
snapshot-restore [DOCS] Fixes problematic terminology (#58178) 2020-06-16 09:23:11 -07:00
sql SQL: [Docs] Fix TIME_PARSE documentation (#58182) 2020-06-18 12:35:58 +02:00
transform [DOCS] Adds web session details example to painless transform examples (#57942) 2020-06-15 14:15:34 +02:00
upgrade [DOCS] Relocate shard allocation module content (#56535) 2020-05-12 08:55:57 -04:00
vectors Remove the 'experimental' marking from vector fields. (#49120) 2019-11-18 11:57:18 -08:00
aggregations.asciidoc [Docs] Update aggregations.asciidoc (#29265) 2018-03-28 15:01:45 +02:00
analysis.asciidoc [DOCS] Reformat stop token filter (#53059) 2020-03-03 13:05:12 -05:00
api-conventions.asciidoc [DOCS] Replaces docdir attributes in ML APIs (#57390) 2020-06-01 11:46:10 -07:00
async-search.asciidoc [DOCS] add docs for async search (#53675) 2020-03-20 14:04:33 +01:00
cat.asciidoc [Transform] renamed _cat/transform to _cat/transforms (#53743) 2020-03-18 18:23:01 -04:00
cluster.asciidoc Password-protected Keystore Feature Branch PR (#51123) 2020-01-27 19:51:39 -05:00
data-rollup-transform.asciidoc [DOCS] Adds transforms to Elasticsearch book (#46846) 2019-09-24 15:56:18 -07:00
docs.asciidoc [DOCS] Remove heading offsets for REST APIs (#44568) 2019-07-19 14:35:36 -04:00
frozen-indices.asciidoc Add heuristics to compute pre_filter_shard_size when unspecified (#53873) 2020-03-23 19:06:32 +01:00
getting-started.asciidoc [DOCS] Switch to standard ESS trial links (#52552) 2020-02-21 12:04:39 -05:00
glossary.asciidoc [DOCS] Make ILM documentation data stream aware (#58035) 2020-06-15 14:14:07 +01:00
gs-index.asciidoc [DOCS] Adding index file for GS "mini book". 2017-07-18 13:44:08 -07:00
high-availability.asciidoc [DOCS] Add docs for designing resilient clusters (#47233) 2020-06-05 11:48:44 -04:00
how-to.asciidoc [DOCS] Add 'how to' doc about avoiding oversharding (#55480) 2020-04-22 10:22:19 -04:00
index-extra-title-page.html [DOCS] Add index-extra-title-page.html for direct HTML migration (#50189) 2019-12-13 12:44:12 -05:00
index-modules.asciidoc [DOCS] Explain flood stage watermark. (#57184) 2020-05-28 10:57:40 -04:00
index.asciidoc [DOCS] Reformat release highlights as What's new. (#58074) 2020-06-15 13:26:30 -07:00
index.x.asciidoc [DOCS] Removes redundant index.asciidoc files (#30707) 2018-05-18 11:05:40 -07:00
indices.asciidoc [DOCS] Reformat data streams intro and overview (#57954) 2020-06-11 11:17:21 -04:00
ingest.asciidoc Replace required pipeline with final pipeline (#49470) 2019-11-22 14:00:38 -05:00
intro.asciidoc [DOCS] Reformat release highlights as What's new. (#58074) 2020-06-15 13:26:30 -07:00
mapping.asciidoc [DOCS] Replace docdir attribute with es-repo-dir (#57489) 2020-06-01 15:55:05 -07:00
query-dsl.asciidoc Add a cluster setting to disallow expensive queries (#51385) 2020-02-12 18:06:04 +01:00
redirects.asciidoc [DOCS] Move search API's docvalue_fields examples (#57760) 2020-06-11 10:57:15 -04:00
release-notes.asciidoc [DOCS] Adds placeholders for v8 highlights, breaking changes, release notes (#38641) 2019-02-08 15:48:42 -08:00
scripting.asciidoc [DOCS] Move 'Scripting' section to top-level navigation. (#42939) 2019-06-06 10:45:04 -04:00
search.asciidoc [DOCS] EQL: Document delete async search API (#57732) 2020-06-05 12:45:09 -04:00
setup.asciidoc [DOCS] Relocate discovery module content (#56611) 2020-05-12 17:39:06 -04:00
upgrade.asciidoc [DOCS] Add tip for upgrade assistant (#55027) 2020-05-05 09:49:22 -04:00